Purchase & Refund Details
The Purchase & Refunds Details report contains the following attributes and elements:
<Report>
The <Report> element is the root element of the report.
Syntax
<Report>
HierarchyLevel=CDATA
ReportStartDate=CDATA
ReportEndDate=CDATA>
(Request)
</Report>
<Report>
The table below lists the attributes of <Report>.
Table 22
Attributes of <Report>
Attribute
Description
Data Type and Length
ReportHierarchy
Level
Node value for which the report is requested
String (44)
ReportStartDate
First date that is included in the report
String (10)
ReportEndDate
Last date that is included in the report
String (10)
Example
<Report> Element
<Report HierarchyLevel="SampleMerchant (101011000241000110001)" StartDate="7/29/2008" EndDate="7/29/2008">
The table below lists the child element of <Report>.
Table 23
Child Element of <Report>
Element
Description
<Request+>
Contains all of the requests in the report. See <Requests> for a list of child elements
<Request>
The <Request> element contains all the requests that are included in the report.
The table below lists the child elements of <Request>.
Table 24
Child Elements of <Request>
Element
Description
Data Type and Length
<RequestId>
Request ID of the transaction
Numeric (26)
<CYBSMID>
CyberSource merchant ID
String (30)
<ProcessorMID>
Merchant ID assigned by the processor
Numeric (20)
<HierarchyID>
Hierarchy ID of the purchase or refund transaction
String (20)
<TransRefNo>
Transaction reference number assigned by CyberSource
Numeric (12)
<MerchantRefNo>
Reference number assigned to the purchase transaction by the merchant
String (30)
<TransactionType>
Value defining the transaction type (Purchase or Refund)
String (30)
<SubmissionDate>
Date of the purchase or refund transaction
Date (28)
<Amount>
Amount of the purchase or refund transaction
Amount (25)
<TransactionAmountCurrency>
Transaction currency code
String (3)
<PaymentMethod>
Method of payment used in the original transaction–MasterCard, Visa, Discover, American Express
String (20)
<PaymentType>
Mode of payment, such as credit card
String (20)
<AccountSuffix>
Last 4 digits of the account number
String (4)
<AuthTransRefNo>
Transaction reference number of the authorization
Numeric (12)
<AuthDate>
Date of the original authorization transaction
Date (25)
<AuthRequestId>
Request ID of the original authorization transaction
Numeric (26)
<AuthAmount>
Amount of the associated authorization transaction
Amount (25)
<AuthCurrency>
Currency code of the authorization transaction
String (3)
<AuthCode>
Authorization code returned by the issuer for the associated authorization transaction
String (10)
<AuthResponseCode>
CyberSource response code to the authorization request that was associated with the purchase
Integer (1)
<CYBSBatchDateTime>
Date and time the transaction was batched at CyberSource for submission to the processor
Date and time (28)
<CYBSBatchID>
Batch ID assigned by CyberSource
Numeric (38)
<CardType>
Reference to the card product type used to define the interchange qualification level
Numeric (2)
<InterchangeDescription>*
Description of the interchange qualification level. Interchange Qualification is used to determine the fees due to the card issuing banks for processing of payment transactions through the payment networks
String (60)
<InterchangePercentage>*
Fee paid to the issuing banks that is calculated as a percentage of the purchase amount which applies to the purchase transaction
Numeric (38)
<InterchangePercentage
Amount*>
Amount calculated when the interchange percentage is applied to the value of the purchase transaction. This amount is passed on to the issuing bank
Numeric (38)
<InterchangePerItemFee>*
Portion of the interchange fee that is calculated as a peritem amount for this transaction
Numeric (38)
<DebitNetwork>
Indicates the Debit Network used for this transaction
String (20)
<DiscountPercentage>
Fee calculated as a percentage of the purchase amount which may include interchange and other fees bundled together
Numeric (38)
<DiscountAmount>
Amount calculated when the discount percentage is applied to the value of the purchase transaction
Numeric (38)
<DiscountPerItemFee>
Fee amount assessed for each transaction in addition to the discount percentage
Numeric (38)
<TotalFee>
Total of fees collected for the transaction being reported
Numeric (38)
<FeeCurrency>
Currency in which the fees were collected (this is always the same as the funding currency)
String (3)
<MerchantData1>
Merchant defined data fields
String
<MerchantData2>
Merchant defined data fields
String
<MerchantData3>
Merchant defined data fields
String
<MerchantData4>
Merchant defined data fields
String
<FundingAmount>
Amount of the transaction face value in funding currency
Numeric (38)
<FundingCurrency>
Funding currency code
String (3)
<BucketMerchant>
Indicates whether customer is a small business merchant
String (1) Yes or No
<FirstName>
Customer’s first name
String (60)
<LastName>
Customer’s last name
String (60)
* Not applicable to bundled-pricing merchants
Example
<Request> Element
<Request>
<CYBSMID>SampleMerchant</CYBSMID>
<RequestId>2393877730000167904567</RequestId>
<ProcessorMID>8610007940810</ProcessorMID>
<HierarchyID>101011000031000110003</HierarchyID>
<TransRefNo>36385350004</TransRefNo>
<MerchantRefNo>33557799</MerchantRefNo>
<TransactionType>Purchases</TransactionType>
<SubmissionDate>04/10/09</SubmissionDate>
<Amount>2.40</Amount>
<TransactionAmountCurrency>USD</TransactionAmountCurrency>
<PaymentMethod>Visa</PaymentMethod>
<PaymentType>credit card</PaymentType>
<AccountSuffix>1111</AccountSuffix>
<AuthTransRefNo>36385350004</AuthTransRefNo>
<AuthDate>04/10/09</AuthDate>
<AuthRequestId>2393877730000167904567</AuthRequestId>
<AuthAmount>2.40</AuthAmount>
<AuthCurrency>USD</AuthCurrency>
<AuthCode>831000</AuthCode>
<AuthResponseCode>1</AuthResponseCode>
<CYBSBatchDateTime>04/10/09 01:22 PM</CYBSBatchDateTime>
<CYBSBatchID>2500000000020465</CYBSBatchID>
<MerchantData1 />
<MerchantData2 />
<MerchantData3 />
<MerchantData4 />
<CardType>Consumer Credit</CardType>
<InterchangeDescription>Standard</InterchangeDescription>
<InterchangePercentage>2.7</InterchangePercentage>
<InterchangePercentageAmount>0.06</InterchangePercentageAmount>
<InterchangePerItemFee>0.10</InterchangePerItemFee>
<DiscountPercentage>5</DiscountPercentage>
<DiscountAmount>0.12</DiscountAmount>
<TotalFee>0.38</TotalFee>
<FeeCurrency>USD</FeeCurrency>
<DiscountPerItemFee>0.10</DiscountPerItemFee>
<FundingAmount>2.40</FundingAmount>
<FundingCurrency>USD</FundingCurrency>
<BucketMerchant>N</BucketMerchant>
<FirstName>Sally</FirstName>
<LastName>Jones</LastName>
</Request>