Skip to main content

Field Reference


This reference applies to Reporting.

This section includes report field names and descriptions for downloadable reports and card-present transactions, and field names with compound values.

Advanced Fraud Screen (AFS) Fields
Field NameDescription
FactorsInformation that affected score of the order.
HostSeverityRisk associated with customer's email domain.
InfoCodeStringList of information codes triggered by the order.
IPAddressCustomer’s IP address.
IPCountryName of the country decoded from IP address.
IPRoutingMethodRouting method decoded from IP address.
IPStateName of the state decoded from IP address.
ModelName of score model used for the transaction.
ScoreTotal score calculated for the order.
Application Fields
Field NameDescription
NameName of application used.
RcodeOne-digit code indicating whether the entire request was successful.
ReasonCode—
RflagOne-word description of the result of the entire request.
RmsgMessage that explains the ics_rflag value.
Authorization Results Fields
Field NameDescription
AVSResultOptional results of address verification test.
CVVResultOptional results of card verification number test.
Bank Information Fields
Field NameDescription
AddressBank's address.
BranchCodeCode that identifies the branch of the customer's bank when you are not using the IBAN.
CityCity in which the bank is located.
CountryCountry in which the bank is located.
NameBank's name.
SwiftCodeBank's SWIFT code. Unique address of the bank. Also known as the Bank Identification Code (BIC).
Batch Fields
Field NameDescription
BatchDateDate when the batch was sent to the processor.
BatchIDIdentifier for the batch in which the transaction was sent.
StatusStatus of batch file.
SuccessFlagIndicates whether batch file processing was successful.
Billable Transaction Details Fields

M = Mandatory, O = Optional.

Field NameDescriptionRequired/Optional
CurrencyThe ISO currency code used in the transaction.M
Merchant Reference NumberThe order reference or tracking number generated by the merchant.M
Organization IDThe transacting MID value assigned by Cybersource or .M
PartnerSolutionIDThe identifier assigned to a partner and included in all requests from the partner solution.O
Payment ProcessorThe name of the payment processor.O
Product CodeThe product code for the transaction.M
Product DescriptionThe product description for the transaction.M
QuantityThe quantity of the service requested.M
Reason CodeThe three-digit status code per application.O
Requested AmountThe amount used in the transaction.M
Request IDThe unique identification number generated by Cybersource or to identify the submitted request.M
RmsgThe text result description per application.O
Service NameThe name of the service being requested as identified in Cybersource or .M
Transaction DateThe date of the transaction. Format: YYYY-MM-DD HH:MM:SSM
Bill To Fields
Field NameDescription
Address1First line of the billing street address as it appears on the credit card issuer’s records.
Address2Additional address information.
CityCity of the billing address.
CompanyNameName of the customer’s company.
CompanyTaxIDTax identification number of customer's company.
CountryCountry of the billing address.
CustomerIDMerchant-assigned identifier for the customer.
EmailCustomer’s email address, including the full domain name.
FirstNameFirst name of the billed customer.
HostNameDNS resolved hostname from billTo_ipAddress.
IPAddressCustomer’s IP address.
LastNameLast name of the billed customer.
MiddleNameMiddle name of the billed customer.
NameSuffixSuffix of billed customer.
PhoneCustomer’s phone number.
StateState or province of the billing address.
TitleTitle of the billed customer.
UserNameCustomer's user name.
ZipZip/Postal code for the billing address. The postal code must consist of 5 to 9 digits.
Card-Present Fields

The fields in this table are available in the Transaction Request only for card-present transactions.

Field NameDescription
Device.DeviceIDValue created by the client software that uniquely identifies the POS device. This value is provided by the client software that is installed on the POS terminal. This value is not sent to the processor but is used for reporting purposes.
PaymentData.AcquirerMerchantNumberIdentifier that was assigned to you by your acquirer. This value must be printed on the receipt.
PaymentData.CardPresentIndicates whether the card is present at the time of the transaction. Possible values: N: Card is not present. Y: Card is present.
PaymentData.CardVerificationMethodMethod that was used to verify the cardholder's identity. Possible values: 0: No verification 1: Signature 2: PIN.
PaymentData.EMVRequest FallbackIndicates that a fallback method was used to enter credit card information into the POS terminal. When a technical problem prevents a successful exchange of information between a chip card and a chip-capable terminal:Swipe the card or key the credit card information into the POS terminal.Use the pos_entryMode field to indicate whether the information was swiped or keyed.Possible values: true: Fallback method was used. false (default): Fallback method was not used.
PaymentData.IssuerResponseCodeAdditional authorization code that must be printed on the receipt when returned by the processor. This value is generated by the processor and is returned only for a successful transaction.This field is supported only on SIX.
PaymentData.PinTypeMethod that was used to verify the cardholder's identity. Possible values: 0: No verification 1: Signature 2: PIN This field is supported only on American Express Direct, OmniPay Direct, and SIX.
PaymentData.POSCatLevelType of cardholder-activated terminal. Possible values: 1: Automated dispensing machine 2: Self-service terminal 3: Limited amount terminal 4: In-flight commerce (IFC) terminal 5: Radio frequency device 6: Mobile acceptance terminal 7: Electronic cash register 8: E-commerce device at your location 9: Terminal or cash register that uses a dial-up connection to the transaction processing network Chase Paymentech Solutions Only values 1, 2, and 3 are supported. FDC Nashville Global Only values 7, 8, and 9 are supported. GPN Only values 6, 7, 8, and 9 are supported. TSYS Acquiring Solutions Only value 6 is supported.
PaymentData.POSEntryModeMethod of entering credit card information into the POS terminal. Possible values: contact: Read from direct contact with chip card. contactless: Read from a contactless interface using chip data. keyed: Manually keyed into POS terminal. This value is not supported on OmniPay Direct or SIX. msd: Read from a contactless interface using magnetic stripe data (MSD). This value is not supported on OmniPay Direct. swiped: Read from credit card magnetic stripe.The contact, contactless, and msd values are supported only for Europay, Mastercard, and Visa (EMV) transactions.
PaymentData.POSEnvironmentOperating environment. Possible values: 0: No terminal used, or unknown environment. 1: On merchant premises, attended. 2: On merchant premises, unattended, or cardholder terminal. Examples: oil, kiosks, self-checkout, home computer, mobile telephone, personal digital assistant (PDA). Cardholder terminal is supported only for Mastercard transactions. 3: Off merchant premises, attended. Examples: portable POS devices at trade shows, at service calls, or in taxis. 4: Off merchant premises, unattended, or cardholder terminal. Examples: vending machines, home computer, mobile telephone, PDA. Cardholder terminal is supported only for Mastercard transactions. 5: On premises of cardholder, unattended. 9: Unknown delivery mode. S: Electronic delivery of product. Examples: music, software, or eTickets that are downloaded over the Internet. T: Physical delivery of product. Examples: music or software that is delivered by mail or by courier.For Mastercard transactions, the only valid values are 2 and 4.
PaymentData.RoutingNetworkType—
PaymentData.StoreAndForwardIndicatorWhen connectivity is unavailable, the client software that is installed on the POS terminal can store a transaction in its memory and send it for authorization when connectivity is restored. This value is provided by the client software that is installed on the POS terminal. This value is not sent to the processor but is used for reporting purposes. Possible values: true / false.
PaymentData.TerminalIDAlternateIdentifier for an alternate terminal at your retail location. You define the value for this field.This field is supported only for Mastercard transactions on FDC Nashville Global. Use the pos_terminalID field to identify the main terminal at your retail location. If your retail location has multiple terminals, use this pos_terminalIDAlternate field to identify the terminal used for the transaction.This value is neither verified nor modified before it is passed to the processor.
Request.PartnerOriginalTransactionIDValue that links the previous transaction to the current follow-on request. This value is assigned by the client software that is installed on the POS terminal, which makes it available to the terminal's software and to . Therefore, you can use this value to reconcile transactions between and the terminal's software.This value is not sent to the processor but is used for reporting purposes.This field is supported only on American Express Direct and SIX.
Request.PartnerSDKVersionVersion of the software installed on the POS terminal. This value is provided by the client software that is installed on the POS terminal.This value is not sent to the processor but is used for reporting purposes.This field is supported only on American Express Direct and SIX.
Request.TerminalSerialNumberTerminal serial number assigned by the hardware manufacturer. This value is provided by the client software that is installed on the POS terminal.This value is not sent to the processor but is used for reporting purposes.This field is supported only on American Express Direct and SIX.
Case Management Fields
Field NameDescription
ActiveNumberOfRulesIndicates the number of rules in use in the profile.
ActiveProfileDecisionDecision of active profile.
ActiveProfileNameName of the active profile.
ActiveProfileScoreScore of the active profile.
ActiveRuleDecisionSummarizes the active rule decision.
ActiveRuleNameName of active rule as it appears in Profile Editor.
ActiveRuleScoreScore of the active rules.
OwnerOrganizationOrganization name of the reviewer assigned to the order.
OwnerUsernameSpecific reviewer assigned to the order.
PassiveNumberOfRulesIndicates the number of rules in use in the profile.
PassiveProfileDecisionDecision of passive profile.
PassiveProfileNameName of the passive profile.
PassiveProfileScoreScore of the passive profile.
PassiveRuleDecisionSummarizes the passive rule decision.
PassiveRuleNameName of passive rule as it appears in Profile Editor.
PassiveRuleScoreScore of the passive rules.
PriorityDegree of importance assigned to the order.
QueueOrder queue selected.
ReviewDateDate and time of final decision.
ReviewDecisionSummarizes final outcome for the order.
ReviewNotesComments made by reviewer about the order.
Chargeback and Retrieval Fields
Field NameDescription
AdjustmentAmountAmount of the chargeback adjustment.
AdjustmentCurrencyCurrency of the chargeback adjustment.
AdjustmentARNAssociation reference number.
CaseIdentifierNumerical identifier created to represent a unique chargeback, representment, or other exception.
CaseNumberProcessor-assigned case number.
CaseTimeThe date that the case was opened.
CaseTypeDescription of the case type.
ChargebackAmountAmount of the chargeback.
ChargebackCurrencyChargeback currency code.
ChargebackMessageText message from the issuer explaining the reason for the chargeback or other exception.
ChargebackReasonCodeAssociation chargeback reason code.
ChargebackReasonCodeDescriptionText description of the reason code.
ChargebackTimeThe date that the chargeback was originated by the issuing bank.
DocumentIndicatorIndicates whether or not there are associated documents. Possible values: Y, N
FeeAmountAmount of the chargeback exception fee.
FeeCurrencyCurrency code for the chargeback exception fee.
FinancialImpactIndicates whether or not there is a financial impact. Possible values: Y, N
FinancialImpactTypeDebit, credit, or none.
MerchantCategoryCodeFour-digit number that the payment card industry uses to classify merchants into market segments.
PartialIndicatorFlag indicating whether the transaction is enabled for partial chargeback.
ResolutionTimeResolution time in UTC.
ResolvedToIndicatorIndicates resolved to status of transaction. Possible values: B: Bank M: Merchant S: Split G: General ledger
RespondByDateDate by which item must be submitted to the chargeback processor to allow sufficient time for representment.
TransactionTypeCapture type of the original transaction.
Check Fields
Field NameDescription
BankTransitNumberBank routing number.
AccountEncoderIDIdentifier for the bank that provided the customer’s encoded account number.
SecCodeAuthorization method used for the transaction.
Conversion Fields
Field NameDescription
ConversionDateDate order converted.
NewDecisionReviewer evaluation result.
OriginalDecisionOrder profile evaluation result.
ProfileOrder profile used to evaluate the order.
ReviewerPerson who evaluated order originally marked for review.
ReviewerCommentsAdditional information added by reviewer.
QueueReview queue originally assigned to order.
Customer Fields
Field NameDescription
BillingAddress1First line of billing street address as it appears on credit card issuer’s records.
BillingAddress2Additional address information.
BillingCityBilling address city.
BillingCompanyNameCustomer's company name.
BillingCountryBilling address country.
BillingEmailCustomer's email address.
BillingFirstNameFirst name of the billed customer.
BillingLastNameLast name of the billed customer.
BillingPhoneCustomer's phone number.
BillingPostalCodeBilling address postal code.
BillingStateBilling address state or province.
CustomerIDMerchant-assigned identifier for the customer.
ShippingAddress1First line of the shipping address.
ShippingAddress2Second line of the shipping address.
ShippingCityShipping address city.
ShippingCompanyNameRecipient's company name.
ShippingCountryShipping address country.
ShippingFirstNameFirst name of the recipient.
ShippingLastNameLast name of the recipient.
ShippingPhoneRecipient's phone number.
ShippingPostalCodeShipping address postal code.
ShippingStateShipping address state or province.
Deposit Fields
Field NameDescription
AmountAmount of the deposit.
CategoryCategory of the deposit.
CurrencyCurrency code of the deposit.
ExchangeRateExchange rate. Includes a decimal point and up to 4 decimal places.
ExchangeRateDescriptionExchange rate description from the funding bank.
IdentifierUnique reference number for this deposit.
MerchantBankAcctLast4Bank account number to which the funds transfer will be deposited. For security purposes, all but the last 4 digits are masked.
MerchantBankAcctNameName used on the bank account.
MerchantBankCodeRouting number for the account to which the funds transfer will be deposited.
MerchantBankCountryCountry in which the bank is located. Two-character ISO Standard Country Codes.
MerchantBankNameBank's name.
MerchantIDMerchant ID.
MethodFunds transfer method.
StatusStatus of the deposit. Possible values: S: Success, P: Pending, F: Failed
TimeDeposit time for the transaction in UTC.
TransferMessageDeposit transfer message provided by the processor.
TypeDescription of events included in this funds transfer.
Device Fields
Field NameDescription
DeviceIDIdentification number of device used for transaction.
Device Fingerprint Fields
Field NameDescription
BrowserLanguageComma-separated list of languages preferred or supported by the browser.
CookiesEnabledIndicates if cookies are enabled in customer's browser.
DeviceFirstSeenDate when the device was first encountered.
DeviceLatitudeLatitude of the GPS location of the device.
DeviceLongitudeLongitude of the GPS location of the device.
DeviceMatchedLongitude of the GPS location of the mobile device.
Fingerprint/DeviceFingerprintUnique ID of a computer or other device.
FlashEnabledIndicates if Flash is enabled in customer's browser.
FlashOperatingSystemDevice operating system as reported by Flash.
FlashVersionVersion of Flash installed on the device.
GPSAccuracyIndicates the accuracy of the GPS location of the mobile device.
ImagesEnabledIndicates if images are enabled in customer's browser.
Jailbreak/RootPrivilegesIndicates if a mobile device has root privileges.
Jailbreak/RootReasonAdditional information describing elements on mobile device that triggered escalation to root privileges.
JavaScriptEnabledIndicates if JavaScript is enabled in customer's browser.
ProfiledURLURL of profiled page.
ProfilingDate/TimeTime of device profiling.
ProfilingDuration/RequestDurationTotal time in milliseconds to process the profiling request.
ProxyIPAddressIP address of proxy if available.
ProxyIPAddressActivitiesActions associated with the proxy IP address.
ProxyIPAddressAttributesCharacteristics associated with the proxy IP address.
ProxyServerTypeType of proxy server based on the HTTP header.
ScreenResolutionScreen resolution of the device.
SmartIDDevice identifier generated from attributes collected during profiling.
SmartIDConfidenceLevelProbability that the Smart ID is correctly identifying a returning device.
TimeOnPageTime period in milliseconds that device profiling page displays on browser before it closes or user navigates away from the page.
TrueIPAddressCustomer’s true IP address detected by the application.
TrueIPAddressActivitiesActions associated with the true IP address.
TrueIPAddressAttributesCharacteristics associated with the true IP address.
TrueIPAddressCityCity associated with the true IP address.
TrueIPAddressCountryCountry associated with the true IP address.
TypeofBrowserAgentIndicates if a mobile device or a computer was used to initiate the session.
Emailage Fields
Field NameDescription
CompanyNameName of company to which the email belongs.
DomainCategoryThe category type for company's email domain.
DomainCompanyDomain of company to which the email belongs.
DomainCorporateIndicates if domain is registered to a business.
DomainCountryCodeDomain of country code to which the email belongs.
DomainCreationDateCreation date of the domain.
DomainCreationDate-DaysOldNumber of days since email domain was created.
DomainExistsVerifies if the email domain exists.
DomainNameThe email address domain name.
DomainRiskProvides risk level for the domain.
EmailCreationDateCreation date of the email.
EmailCreationDate-DaysOldNumber of days since email account was created.
EmailExistsVerifies if email address exists.
EmailFirstSeenDateThe oldest time stamp found for records associated with email address.
EmailFirstSeenDate-DaysOldNumber of days since email was first seen.
EmailLocationLocation of the person who owns email address.
EmailNameMatchIndicates status of the name of the customer matching the email owner.
EmailOwnerNameName of the person who owns the email address.
EmailageReasonProvides information relevant to understanding the Emailage Risk Score.
EmailageReasonDescriptionProvides information relevant to understanding the Emailage Risk Score.
EmailageRecommendationRecommendation based on results of other Emailage fields.
EmailageRiskBandIndicates the number associated with certain Emailage Score ranges.
EmailageScoreProprietary algorithm that calculates the fraud risk associated with an email address.
FraudTypeIf multiple companies within the Emailage system marked the queried value as fraud, this field provides the most recent fraud type.
GenderGender of the person who owns the email address.
IP PostalPostal code associated with the IP address.
IPAnonymousProxyIndicates if the user's IP address is an anonymous proxy.
IPCityFor U.S., city where the IP is located.
IPCountryName of the country associated with the IP.
IPRegionFor U.S., state where the IP is located.
IPReputationReputation of the proxy, indicates the likelihood that the user's IP address is an open proxy.
IPRiskLevelProvides the fraud risk for the IP Address.
LastConfirmationDateThe last date the email address was queried in the Emailage system.
PhoneSyntaxValidationIndicates if the phone syntax is valid.
SMLinksCount of social media sites that match the queried email.
SocialMediaFriendsTotal friends for the email owner located on social media sites.
SourceIndustryIf FraudType contains a value, this field provides the industry of the most recent company to mark the email as fraud or legitimate.
TitleTitle of the email owner.
TotalhitsNumber of times the email address was queried in the Emailage system in a 7 day period.
UniquehitsNumber of unique companies that queried the email address in the Emailage system in a 7 day period.
Event Fields
Field NameDescription
AmountAmount for the event.
CurrencyCodeCurrency code for the event.
EventType of event that occurred for the transaction.
EventDateDate in GMT format that the event occurred. This field can be null for some event types, such as Declined.
ProcessorMessageAdditional information from the processor about the event, such as an error message or explanation.
Exception Fields
Field NameDescription
ActionBrief description of the action.
ClientID—
CYBSExceptionIDAssigned exception ID number.
DccLookupStatus—
DccExchangeRate—
DccMarginRate—
ExceptionAmountAmount specified in the exception.
ExceptionAmountCurrencyException currency represented in ISO 4217:2008 alpha-3.
ExceptionCategoryType of exception.
ExceptionDateDate of exception.
ExceptionDescription—
ExceptionDeviceHardwareRevision—
ExceptionDeviceID—
ExceptionDeviceOS—
ExceptionDeviceOSVersion—
ExceptionDeviceTerminalID—
ExceptionMessageDescription of the exception.
ExceptionReasonCodeReason code for the error that occurred. This reason code is the same one that you receive in the response or transaction receipt.
ExceptionReasonDescriptionDescription of exception reason.
ExceptionStatusCurrent status of the transaction.
ExceptionStatusCode—
ExceptionTypeType of exception.
FinancialStatusFinancial status of the transaction.
LastActionDateDate of last action on the transaction.
LocalCurrencyCodeLocal currency code.
NextActionDateDate of next action on the transaction.
OriginalTransactionSubmissionDateDate on which the transaction was submitted.
PartnerMerchantID—
PartnerMerchantName—
PaymentNumberPayment number.
ProcessorCaseIDProcessor-assigned case number.
ProcessorResponseCodeCode returned directly from the processor for the exception that occurred.
ReasonCodeReason code for the exception that occurred.
RetryCountTotal number of payments that are pending in retry mode.
SchemeOperator—
SDKVersion—
SettlementProcessorName of settlement processor.
StorageMechanism—
Fee Fields
Field NameDescription
AcquirerInterchangeAmount—
AssessmentAmountAmount of the assessment.
AssessmentCurrencyCurrency of the assessment.
BillingCycleBilling cycle of the merchant. Possible values: daily, weekly, monthly
BillingTypeBilling type of the merchant. Possible values: discount, interchangePlus, serviceFee, other
ClearedInterchangeLevelCode for the clearing level.
ConversionFeeFee amount added for currency conversion.
ConversionFeeCurrency—
DiscountAmountDiscountRate *TransactionAmount. This value includes 4 decimal points.
DiscountCurrencyCurrency of the discount.
DiscountRateDiscount rate.
DowngradeReasonCodeReason for downgrade. Possible values: 1: Transaction exceeded timeliness. 2: Authorization code is missing. 8: POS entry mode does not qualify. 9: POS condition code does not qualify. A: POS terminal capability does not qualify. D: Mail/phone/e-commerce indicator does not qualify. K: Transaction cleared as intraregional. L: Transaction cleared as interregional. R: Reclassification. U: UK domestic. V: German domestic. W: Transaction cleared as world signia. X: Did not qualify at merchant price level.
ExchangeRate—
GrossInterchangeAmount—
InterchangeAmountFinal amount of transaction after the interchange rates are applied.
InterchangeCurrencyISO currency code for the currency of the clearing rate.
InterchangeRateInterchange rate for the transaction.
IssuerInterchangeAmount—
MerchantID—
OtherInterchangeAmount—
PerItemFeeAmountFee for a single item.
PerItemFeeCurrencyCurrency for a single item fee.
PricedInterchangeLevelInterchange flat rate that was assigned when you set up your account. This value includes 4 decimal points.
ReimbursementFee—
ReimbursementFeeDebitCreditIndicator—
ServiceFeeAmountAmount of service fee for transaction.
ServiceFeeAmountCcyCurrency of the service fee.
ServiceFeeFixedAmountAmount of the fixed service fee for the transaction.
ServiceFeeFixedAmountCcyCurrency of the fixed service fee.
ServiceFeeRatePercentage rate of the service fee.
SettlementAmountAmount of the settlement.
SettlementCurrencyCurrency of the settlement.
SettlementTimeTime the settlement was processed.
SettlementTimeZoneTime zone of the settlement.
SourceDescriptor—
TotalFeeAmountTotal amount of all fee transactions for the specified date range.
TotalFeeCurrencyCurrency for all fee transactions for the specified date range.
TransactionIntegrityFee—
TransactionIntegrityFeeDebitCreditIndicator—
Fee Summary Fields
Field NameDescription
CardTypeCard type.
CountCount.
FeeDescriptionFee description.
FeeTypeFee type.
FundingCurrencyCurrency in which fees applied.
PaymentMethodPayment method used.
PercentageFeePercentage fee.
PerItemFeeFee charged per item.
TotalFeeAmountTotal fee amount.
TransactionAmountTransaction amount.
TransactionTypeTransaction type.
Funding Fields
Field NameDescription
CurrencyExchangeDescriptionExchange rate description from the processor.
CurrencyExchangeRateExchange rate for converting from transaction currency to funding currency.
FeeAmountFee for the transaction.
FeeCurrencyFee currency represented in ISO 4217:2008 alpha-3.
FeeDescriptionFee description from the processor.
FundingAccountSuffixLast 4 digits of funding account.
FundingAmountFunding amount of the transaction.
FundingBankCodeBank code of the funding bank.
FundingBankCountryBank country of the funding bank represented in ISO 3166-1 alpha-3.
FundingBankNameName of bank funding the transaction.
FundingCurrencyFunding currency represented in ISO 4217:2008 alpha-3.
FundingDateFunding date of the transaction.
FundingIdentificationNumberFunding identification for the funding of the transaction.
FundingProcessorMessageFunding response message from the processor.
FundingTransferMessageFunding transfer message provided by the processor.
ProcessorResponseCodeFunding response code from the processor.
StatusFunding status. Possible values: S (success), P (pending), F (failed)
Fund Transfer Fields
Field NameDescription
BankCheckDigitCode used to validate the customer's account number.
IbanIndicatorInternational Bank Account Number (IBAN).
Gift Card Fields
Field NameDescription
CurrentBalanceCurrent gift card balance in your local currency.
PreviousBalancePrevious gift card balance in your local currency. This value was the gift card balance before the concurrent transaction was applied to the gift card. This field is supported only on ValueLink. For example, when a customer purchases a gift card and uses the gift card to purchase a product at the same time, the response message includes: Previous gift card balance, which was the balance before the purchase of the product Current gift card balance, which is the balance after the purchase of the product
RedemptionTypeType of redemption. Possible values: CASHOUT REDEMPTION REDEMPTION_ PARTIAL_ ALLOWED (default) This field is supported only on ValueLink.
Healthcare Fields
Field NameDescription
AmountAmount of the healthcare payment.
AmountTypeType of healthcare payment. For example: healthcare, dental, clinic
CurrencyCurrency used in transaction.
IndustryTypeType of industry for the transaction.
Invoice Fields
Field NameDefinition
BillingGroupDescriptionDescription of the billing group.
NotProcessedNumber of unprocessed transactions.
OrganizationIDMerchant ID.
PerformedServicesICS service name.
ProcessedNumber of processed transactions.
TotalInvoice count.
JP Fields
Field NameDescription
AmountTransaction grand total.
AuthForwardName of Japanese acquirer that processed transaction. Available only for CCS (CAFIS) and JCN Gateway.
AuthorizationCodeTransaction authorization code.
CardSuffixLast four digits of card.
CurrencyCurrency used in transaction.
CustomerFirstNameCustomer first name.
CustomerLastNameCustomer last name.
DateDate of transaction.
GatewayName of gateway used to process transaction.
JPOInstallmentMethodNumber of payment installments (Japanese payment method only).
JPOPaymentMethodType of Japanese payment method used.
MerchantIDGateway merchant identifier.
MerchantReferenceNumberMerchant order reference or tracking number.
NetworkTokenTransTypeNetwork token transaction type.
PaymentMethodMethod of payment.
RequestIDClient request identifier.
SubscriptionIDCustomer profile identifier for requested service.
TimeTime of transaction.
TransactionReferenceNumberReference number used to reconcile gateway reports with processor reports.
TransactionTypeType of transaction.
Line Item Fields
Field NameDescription
FulfillmentTypeInformation about the product code used for the line item.
InvoiceNumberInvoice number for order.
MerchantProductSkuIdentification code for the product.
NumberNumber of the line item in an order.
ProductCodeUsed to determine product category: electronic, handling, physical, service, or shipping.
ProductNameName of product.
QuantityQuantity of product.
TaxAmountTotal tax to apply to the product.
UnitPricePer-item price of the product.
Mark As Suspect Fields
Field NameDescription
MarkingDateDate the order was marked.
MarkingNotesNotes about the customer or the order.
MarkingReasonSelected reason for marking the order.
MarkingUserNameIdentity of the user marking the order.
Merchant Defined Data Fields
Field NameDescription
MerchantDefinedData_field1Fields that you can use to store information (Field1 - Field20).
Life Cycle Management Event Fields

Field names in this group are prepended with LifeCycleManagementEvent.

Field NameDescription
LCMEventDateProcessedDate that the Life-Cycle Management event was fully processed.
LCMEventStatusProcessing status of the Life-Cycle Management event.
LCMEventStatusTextFree-formatted text field detailing the process of the Life-Cycle Management event.
LCMEventTypeType of Life-Cycle Management event applied.
LCMEventUniqueIDUnique identifier for the Life-Cycle Management event applied.
Network Token Fields

Field names in this group are prepended with NetworkToken.

Field NameDescription
CardExpiryDateExpiration date of the card.
CardSuffixLast 4 digits of the card.
NetworkTokenPARNetwork token payment account reference (PAR).
PARA unique reference that identifies the underlying payment account.
TokenExpiryDateExpiration date of the network token.
TokenModifiedDateDate that the network token was modified.
TokenRequestorIDIdentifier of the wallet that the network token belongs to.
TokenServiceToken service that provisioned the network token.
TokenStateState of the network token.
TokenSuffixLast 4 digits of the network token.
TokenUniqueIDUnique identifier for the network token.
Notification of Change Fields
  • Merchant Reference Number
  • Transaction Reference Number
  • NOC Date
  • NOC Code
  • Updated Account Type
  • Updated Routing Number
  • Updated Account Number
  • Updated Consumer Name
Order Fields
Field NameDescription
ConnectionMethodMethod by which order was sent to .
GiftWrapIndicates if the customer requested gift wrapping for this purchase.
MerchantIDMerchant ID.
MerchantReferenceNumberOrder or tracking number.
PricePrice of each item.
ProductCodeType of product in the offer.
ProductNameName of the product.
ProductSKUMerchant’s product.
QuantityQuantity of product being purchased.
ReasonCodeOne-digit code that indicates if the entire request was successful.
ReplyCodeOne-digit code that indicates if the entire request was successful.
ReplyFlagOne-word description of the result of the entire request.
ReplyMessageMessage that explains the reply flag.
RequestIDIdentifier for the request generated by the client.
ReturnAcceptedIndicates if returns are accepted for this order.
ShippingMethodShipping method for the product.
TaxTaxTotal tax to apply to the product.
TransactionDateDate of transaction.
Payer Auth Detail Request Fields
Field NameDescription
DSTransactionID3DS v2 Directory Server transaction identifier.
MerchantIDMerchant ID used for the transactions.
RequestIDIdentifier for the transaction request.
TransactionDateDate on which the transaction took place.
TransactionIDIdentifier of transaction.
TransactionTypeTransaction type.
Payer Auth Request Fields
Field NameDescription
AccountIDAccount identifier.
AcquirerBinAcquiring bank identification number.
CardExpiryCard expiration.
CountryCountry.
MerchantIDMerchant identifier.
MerchantNameMerchant name.
MerchantURLMerchant URL.
PurchaseAmountPurchase amount.
PurchaseDatePurchase date.
PurchaseXIDPurchase XID.
Payer Auth Response Fields
Field NameDescription
AcquirerBinAcquiring bank identification number.
AuthTimeAuthorization time.
CAVVCAVV.
ECIE-commerce indicator.
MerchantIDMerchant identifier.
PurchaseAmountPurchase amount.
PurchaseDatePurchase date.
PurchaseXIDPurchase XID.
TransactionStatusTransaction status.
Payment Data Fields
Field NameDescription
AAV_CAVVOptional authentication data that you can receive after the customer is authenticated.
ACHVerificationResultRaw result of the ACH Verification service.
ACHVerificationResultMappedMapped result of the ACH Verification service.
AcquirerMerchantID—
AcquirerMerchantNumberIdentifier that was assigned to you by your acquirer. This value must be printed on the receipt.
AmountGrand total for the order.
AuthIndicator—
AuthorizationCodeAuthorization code for the payment.
AuthorizationTypeAuthorization type of the payment.
AuthReversalAmount—
AuthReversalResult—
AVSResultRaw code for Address Verification Service result for the payment.
AVSResultMappedAddress Verification Service result for the payment.
BalanceAmountRemaining balance on the account.
BalanceCurrencyCodeCurrency of the remaining balance on the account.
BankAccountNameName of account holder.
BankCodeBank code or sort code for the account if a bank account was used for the transaction.
BatchFilesID—
BinNumberBank identification number.
CardCategoryType of card used in the transaction.
CardCategoryCodeCategory code of card used in the transaction.
CardPresentIndicates whether the card is present at the time of the transaction.
CardVerificationMethod—
CurrencyCodeCurrency code for the payment.
CustomerAccountID—
CVResultCVN result code.
DCCIndicatorFlag that indicates whether DCC is being used for the transaction.
ECIOptional information that you can receive if you use the Payer Authentication service.
eCommerceIndicatorType of e-commerce transaction.
EMVRequestFallbackIndicates that a fallback method was used to enter credit card information into the POS terminal.
EVEmailMapped Electronic Verification response code for the customer’s email address.
EVEmailRawRaw Electronic Verification response code from the processor for the customer’s email address.
EventTypeType of event that occurred for the transaction.
EVNameMapped Electronic Verification response code for the customer’s name.
EVNameRawRaw Electronic Verification response code from the processor for the customer’s last name.
EVPhoneNumberMapped Electronic Verification response code for the customer’s phone number.
EVPhoneNumberRawRaw Electronic Verification response code from the processor for the customer’s phone number.
EVPostalCodeMapped Electronic Verification response code for the customer’s postal code.
EVPostalCodeRawRaw Electronic Verification response code from the processor for the customer’s postal code.
EVStreetMapped Electronic Verification response code for the customer’s street address.
EVStreetRawRaw Electronic Verification response code from the processor for the customer’s street address.
ExchangeRateExchange rate.
ExchangeRateDateTime stamp for the exchange rate.
GrandTotalGrand total amount for the order, including tax, for requests that do not contain payment information.
IssuerResponseCodeAdditional authorization code that must be printed on the receipt when returned by the processor.
JpoJccaTerminalIDUnique terminal identifier provided by Japan Credit Card Association (JCCA).
JpoPaymentMethodIndicates Japanese payment option being used.
MandateReferenceNumber—
MerchantCategoryCodeFour-digit number that payment card industry uses to classify merchants into market segments.
NetworkCode—
NumberOfInstallmentsTotal number of installments when making payments in installments.
OriginalAmount—
OriginalCurrency—
PaymentProcessorName of payment processor.
PaymentProductCodeType of payment product used by the consumer to pay on a payment provider’s site, such as installments or bank transfer.
PaymentRequestIDOriginal request ID for the purchase.
PinTypeMethod that was used to verify the cardholder's identity.
POSCatLevelType of cardholder-activated terminal.
POSEntryModeMethod of entering credit card information into the POS terminal.
POSEnvironmentOperating environment.
POSTerminalCapabilityPOS terminal’s capability.
ProcessorMID—
ProcessorResponseCodeThe error message sent directly from the bank.
ProcessorResponseIDResponse ID sent from the processor.
ProcessorTIDTransaction identification (TID) that is used to identify and track a transaction throughout its life cycle.
ProcessorTransactionID—
RequestedAmountAmount requested to be authorized.
RequestedAmountCurrencyCodeCurrency for the amount requested to be authorized.
RoutingNetworkTypeProcessor scheme used for routing the transaction.
SalesSlipNumberTransaction identifier that you generate.
ShopNameName of the shop.
ShopNameKatakanaShop name displayed in katakana characters.
ShopNameLocalShop name displayed in local dialect.
SolutionTypeType of digital payment used. Valid values: 001, 006, 007
StoreAndForwardIndicatorWhen connectivity is unavailable, the client software that is installed on the POS terminal can store a transaction in its memory and send it for authorization when connectivity is restored.
SubMerchantCitySub-merchant’s city.
SubMerchantCountrySub-merchant’s country.
SubMerchantEmailSub-merchant’s email address.
SubMerchantIDIdentifier assigned to sub-merchant.
SubMerchantNameSub-merchant’s name.
SubMerchantPhoneSub-merchant’s phone number.
SubMerchantPostalCodeSub-merchant’s ZIP/Postal code.
SubMerchantStateSub-merchant’s state.
SubMerchantStreetFirst line of sub-merchant’s street address.
SubsequentAuthIndicates whether the transaction is a merchant-initiated transaction or subsequent authorization.
SubsequentAuthFirstIndicates whether the customer initiated the transaction and whether the credentials are stored for future authorizations.
SubsequentAuthReasonReason for the merchant-initiated transaction or incremental authorization.
SubsequentAuthStoredCredentialIndicates whether you obtained the payment information from credentials on file (COF) instead of from the customer.
SubsequentAuthTransactionIDNetwork transaction identifier that was returned for a previous authorization in the series.
TargetAmountConverted amount.
TargetCurrencyBilling currency.
TerminalIDAlternateIdentifier for an alternate terminal at your retail location.
TotalTaxAmountTotal tax amount for all of the line items in the transaction.
TransactionRefNumberReference number for the transaction.
XIDOptional transaction identifier generated by Payer Authentication that you can receive when the customer is enrolled and when validation is successful.
Payment Method Fields
Field NameDescription
AccountEncoderID—
AccountSuffixLast four digits of the customer’s payment account number.
AccountType—
AuthMerchantAdviceCode—
AuthMerchantAdviceCodeRaw—
BankAccountNameBank's account name.
BankCheckDigit—
BankCity—
BankCodeBank's code. Used for some countries when you are not using the IBAN. Contact Customer Support for required country-specific bank account information.
BankCountry—
BankNumber—
BankTransitNumber—
BinCountryIssuer country code.
BoletoBarCodeNumberNumeric representation of the boleto barcode.
BoletoNumberBoleto Bancário payment number.
BranchCode—
CardCategoryType of card used.
CardCategoryCodeCode for card type used.
CardTypeType of card to authorize.
CheckNumberCheck number.
EffectiveDate—
ExpirationMonthTwo-digit month in which the credit card expires.
ExpirationYearFour-digit year in which the credit card expires.
IbanIndicator—
IssueNumberNumber of times a Maestro (UK Domestic) card has been issued to the account holder.
MandateIdIdentification reference for the direct debit mandate.
MandateTypeType of mandate.
NetworkTokenTransType—
OverridePaymentMethod—
RawValidationCode—
ResultCode—
SignatureDateDate of signature.
StartMonthMonth of the start of the Maestro (UK Domestic) card validity period.
StartYearYear of the start of the Maestro (UK Domestic) card validity period.
SwiftCode—
TypeDescription—
ValidationLevel—
WalletTypeType of wallet.
Payment Fields
Field NameDescription
AccountSuffixLast four digits of the customer’s payment account number.
AuthEVAddress1Mapped Electronic Verification response code for the customer’s street address.
AuthEVEmailMapped Electronic Verification response code for the customer’s email address.
AuthEVLastNameMapped Electronic Verification response code for the customer’s last name.
AuthEVPhoneMapped Electronic Verification response code for the customer’s phone number.
AuthEVPostalCodeMapped Electronic Verification response code for the customer’s postal code.
AVSResultMappedAddress Verification Service result for the payment.
CardBINEight-digit card issuer bank identification number.
CardBINCountryCountry associated with the origin of the card.
CardIssuerName of the bank.
CardSchemeSubtype of card account.
CardTypeType of payment card account.
CardVerificationResultRaw result of the ACH Verification service.
ECommerceIndicatorType of e-commerce transaction.
LocalCurrencyCodeYour local pricing currency code.
LocalOrderAmountAmount in your original local pricing currency.
OrderAmountGrand total amount or the individual line-item amounts.
OrderCurrencyCurrency used for the order.
POS Terminal Exceptions Fields
Field NameDescription
AccountSuffix—
Amount—
BillToEmailEmail address of the user.
CardVerificationMethodType of customer verification.
ClientIDClient identifier for an installation; generated by the operating system.
CurrencyCode—
DCCExchangeRateDynamic Currency Conversion exchange rate.
DCCLookupStatusLookup Status of Dynamic Currency Conversion.
DCCMarginRateMargin rate of Dynamic Currency Conversion.
DeviceHardwareRevisionHardware revision printed on the back of the credit card reader.
DeviceIDSerial number printed on the back of the credit card reader. Dashes are stripped from the serial number.
DeviceOSOperating system of the device.
DeviceOSVersionOperating system version of the device.
DeviceTerminalIDTerminal identifier assigned to the credit card reader; used by the clearing institute to identify credit card readers.
ExceptionCategoryStatus of the transaction.
ExceptionDescriptionDetailed description of the status of the transaction.
ExceptionStatusCodeCode that represents the status of the transaction.
ExpirationMO—
ExpirationYR—
FirstName—
LastName—
LocalCurrencyCodeThree-digit security code for the local currency.
MerchantID—
PartnerMerchantIDThree-digit identifier for the partner merchant.
PartnerMerchantNameName of the merchant that performed the transaction.
PartnerOriginalTransactionIDUnique identifier of the transaction.
ProcessorMIDMerchant identifier of the merchant that performed the transaction; as assigned by the clearing institute.
POSTerminalExceptionRequestIDUnique identifier of the transaction processor; for debugging purposes.
SchemeOperatorScheme of the credit card.
SDKVersionVersion of the software development kit (SDK).
StorageMechanismSource from which payment details are collected.
TerminalIDTerminal identifier of the merchant that performed the transaction.
TransactionDate—
Profile Fields
Field NameDescription
NameName of the profile.
ProfileDecisionDecision returned by the profile.
ProfileModeActivity mode of the profile.
RuleDecisionDecision returned by the rule.
RuleNameName of the rule.
Proof XML Fields
Field NameDescription
AcquirerBinAcquiring bank identification number.
DateTransaction date.
DirectoryServerURLDirectory server URL.
EnrolledEnrollment indicator.
MerchantIDMerchant ID used for transaction.
PanCustomer masked account number.
PasswordPassword.
Recipient Fields
Field NameDescription
AddressRecipient street address.
CityRecipient city.
CountryRecipient country.
DOBRecipient date of birth.
FirstNameRecipient first name.
LastNameRecipient last name.
MiddleInitialRecipient name middle initial.
PhoneNumberRecipient phone number.
PostalCodeRecipient postal code.
RecipientBillingAmountTransaction billed amount.
RecipientBillingCurrencyRecipient billing currency.
ReferenceNumberRecipient reference number.
StateRecipient state.
Recurring Billing Fields
Field NameDescription
BillingPeriodLengthLength of the billing period.
BillingPeriodUnitBilling period unit. For example: day, week, month.
PlanPeriodLengthLength of the plan.
PlanPeriodUnitPlan period unit. For example: day, week, month.
PlanDescriptionDescription of the plan.
PlanCurrencyCurrency of the plan.
PlanIDUnique identifier of the plan.
PlanCodeUnique code of the plan.
SetupFeeFee for setting up the subscription.
SubscriptionStatusCurrent status of the subscription. For example, active or inactive.
SubscriptionIDUnique identifier of the plan.
SubscriptionCodeUnique code of the subscription.
SubscriptionNameUnique name of the subscription.
SubscriptionNextPaymentDateDate of the next payment for this subscription.
SubscriptionSuccessfulPaymentsNumber of successful payments for this subscription.
SubscriptionRetryCountNumber of times a failed payment has been retried.
SubscriptionStartDateDate the subscription starts.
SubscriptionPaymentAmountAmount paid for this subscription.
TMSCustomerIDUnique customer ID of a customer in the system.
TMSPaymentInstrumentIDUnique payment instrument ID of a customer in the system.
TMSShippingIDUnique shipping ID of a customer in the system.
Request Fields
Field NameDescription
CommentsOptional comments that you can make about the subscription or customer profile.
eCommerceIndicatorTransaction type.
LocalizedrequestDate—
MerchantIDMerchant ID used for the transactions.
MerchantReferenceNumberMerchant’s order reference or tracking number.
PartnerOriginalTransactionIDPartner original transaction identifier.
PartnerSDKVersionPartner SDK version.
RequestIDIdentifier for the transaction request.
SourceSource of request.
SubscriptionIDIdentifier for the customer profile.
TerminalSerialNumber—
TransactionDateDate on which the transaction took place.
TransactionID—
TransactionRefNumberTransaction identifier.
TransactionTypeTransaction type.
UserInformation about a user.
LocalizedRequestDateLocalized request date.
SCA Exemption Fields

HSBC processor merchants must obtain approval from HSBC before using strong customer authentication (SCA) exemptions on authorization transactions for these exemption types:

  • Authentication outage
  • Follow-on recurring payment
  • Low-risk transaction

This requirement does not apply to the low_value_exemption_indicator field.

Field NameDescription
SCAExemptionReason the transaction is exempt from strong customer authentication (SCA) requirements. Possible values: delegated_authentication_exemption_indicator, low_value_exemption_indicator, risk_analysis_exemption_indicator, secure_corporate_payment_indicator, trusted_merchant_exemption_indicator.
SCAExemptionValuesNumber indicating whether the associated SCA exemption was included in the transaction. Possible values: 0: Not exempt. 1: Exempt.
Sender Fields
Field NameDescription
AddressSender address.
CitySender city.
CountrySender country.
DOBSender date of birth.
FirstNameSender first name.
LastNameSender last name.
MiddleInitialSender name middle initial.
PhoneNumberSender phone number.
PostalCodeSender postal code.
SenderReferenceNumberReference number generated by you that uniquely identifies the sender.
SourceOfFundsSource of funds.
StateSender state.
Settlement Fields
Field NameDescription
SettlementAgeSettlement aging.
SettlementAmountAmount settled for transaction.
SettlementCurrencyCodeCurrency code applied to settlement.
SettlementDateDate settlement applied.
SourceResponseCodeResponse code sent from source.
SourceResponseMessageResponse message sent from source.
StatusSettlement status. Possible values: S: Success, P: Pending, F: Failed
Shipping Fields
Field NameDescription
CarrierCarrier used to ship product.
MethodShipping method for the product.
Ship To Fields
Field NameDescription
Address1Shipping address first line.
Address2Shipping address second line.
CityShipping city.
CompanyName—
CountryShipping address country.
FirstNameRecipient first name.
LastNameRecipient last name.
PhoneRecipient phone number.
StateShipping address state or province.
ZipShipping address Zip/postal code.
Standard Billing Data Package Fields

These are the fields in the Standard Billing Data Package report.

Field NameDescription
Header Record
File DateThe date when the system generated the report. Format: YYYYMMDD
File TimeThe time of the day when the system generated the report. Format: HHMMSS
Institution IDUnique ID of the partner.
Record TypeRecord identifier. Fixed value is HR.
Detail Records
Acquirer Merchant IDMerchant ID assigned by the acquirer.
Amount SignPossible values: 001: Positive 002: Negative
Card Acceptor IDID assigned to a merchant by acquirer and used in transactions. Used only for Payment Gateway Services (Card Present and Card Not Present)
Card SchemePayment network linked to the payment card.
Card TypeType of payment card. Possible values: C: Credit card D: Debit card P: Prepaid card
Client ReferenceUnique identifier assigned to a client in . The special character underscore (_) is allowed.
CountSum of transactions for a given product code.
Currency CodeISO numeric currency code used in the transaction.
Domestic/International IndicatorIndicates whether the transaction was domestic or international. Possible values: 01: Domestic 02: International
Product CodeThe product code for the transaction or the partner opted product code associated to the product code.
Record TypeRecord identifier. Fixed value is DR.
Statistic TypeNot in use.
Total AmountSum payment value for a given product code.
Transaction DateDate of the transaction. Format: YYYYMMDD
Trailer Record
Number of RecordsThe total number of records in the report including the Header Record, Detail Records, and Trailer Record.
Record TypeRecord identifier. Fixed Value is TR.

Card Scheme — Payment network linked to the payment card. Possible values:

  • 001: Visa
  • 002: Mastercard
  • 003: American Express
  • 004: Discover
  • 005: Diners Club
  • 006: Carte Blanche
  • 007: JCB
  • 008: Optima
  • 011: Twinpay (credit)
  • 012: Twinpay (debit)
  • 013: Walmart
  • 014: Enroute
  • 015: Lowes Consumer
  • 016: Home Depot Consumer
  • 017: MBNA
  • 018: Dick's Sportwear
  • 019: Casual Corner
  • 020: Sears
  • 021: JAL
  • 023: Disney
  • 024: Switch/Solo
  • 025: Sams Club Consumer
  • 026: Sams Club Business
  • 027: Nicos
  • 029: Bebe
  • 030: Restoration Hardware
  • 031: Delta
  • 032: Solo
  • 033: Visa Electron
  • 034: Dankort
  • 035: Laser
  • 036: Cartes Bancaires
  • 037: Carta
  • 042: Maestro
  • 043: GE MONEY
  • 044: Korean cards
  • 045: Style
  • 046: J.Crew
  • 050: Hipercard
  • 051: Aura
  • 052: Redecard
  • 053: Orico card
  • 054: Elo
  • 055: Capital One Private Label
  • 058: Carnet
  • 059: ValueLink
  • 061: RuPay
  • 062: China UnionPay
  • 063: Falabella Private Label
  • 064: Prompt card
  • 065: Korean Domestic
  • 066: Banricompras
Monthly Fee Details Fields

These are the fields in the Standard Monthly Fee report.

Field NameDescription
Header Record
File DateThe date when the system generated the report. Format: YYYYMMDD
File TimeThe time of the day when the system generated the report. Format: HHMMSS
Institution IDUnique ID of the partner.
Record TypeRecord identifier. Fixed value is HR.
Detail Records
Acquirer Merchant IDMerchant ID assigned by the acquirer.
Actual FeeActual fee value for a given product code. The value is corrected to two decimal places. This value is a multiple of 100.
Client ReferenceUnique identifier assigned to a client. The special character underscore (_) is allowed.
Currency CodeISO currency code.
Fee TypeType of fee. Possible values: MONTHLY ONETIME MIN
Organization TypeType of organization. Possible values: RESELLER RESOLD MID RESELLER_MID
Product Codeproduct code for the fee.
QuantityQuantity for the given product code.
Record TypeRecord identifier. Fixed value is DR.
TaxTax value for a given product code. The value is corrected to two decimal places. This value is a multiple of 100.
Total FeeTotal fee value for a given product code. The value is corrected to two decimal places. This value is a multiple of 100.
Trailer Record
Number of RecordsThe total number of records in the report including the Header Record, Detail Records, and Trailer Record.
Record TypeRecord identifier. Fixed Value is TR.
Tax Fields
Field NameDescription
CountryCredit card billing country. Use the two-character ISO Standard Country Codes. When shipTo_country is not provided, billTo_country is used in its place. When billTo_country is set to US or CA,billTo_postalCode and billTo_state are also required. It is the merchant's responsibility to determine whether a field is required for the transaction.
CurrencyCode—
LineExemptAmount—
InvoiceDateDate of the tax calculation. Use format YYYYMMDD. You can provide a date in the past if you are calculating tax for a refund and want to know what the tax was on the date the order was placed. You can provide a date in the future if you are calculating the tax for a future date, such as an upcoming tax holiday.The default is the date, in Pacific time, that the request is received. Keep this in mind if you are in a different time zone and want the tax calculated with the rates that apply on a specific date.
JurisdictionCode—
JurisdictionNameFree-text description of the jurisdiction for the item. For example, San Mateo County. Returned only if the show_tax_per_offer field is set to yes.
JurisdictionTypeFree-text description of the jurisdiction for the item. For example, San Mateo County. Returned only if the show_tax_per_offer field is set to yes.
LineItemAmountLine Amount total.
LineNo—
MerchantIdentiferMerchant ID. Use the same merchant ID for evaluation, testing, and production.
MerchantReferenceCodeMerchant-generated order reference or tracking number.
PointOfOrderAcceptanceCityThis item-level field overrides the corresponding request-level field. This field is not used unless the item_#_orderAcceptanceState and item_#_orderAcceptanceCountry fields are present.
PointOfOrderAcceptanceCountryThis item-level field overrides the corresponding request-level field. This field is not used unless the item_#_ orderAcceptanceState and item_#_ orderAcceptanceCity fields are present. Use the two-character ISO Standard Country Codes.
PointOfOrderAcceptancePostalCodeOrder acceptance ZIP/Postal Code.
PointOfOrderAcceptanceStateProvinceThis item-level field overrides the corresponding request-level field. This field is not used unless the item_#_orderAcceptanceCity and item_#_orderAcceptanceCountry fields are present. Use the State, Province, and Territory Codes for the United States and Canada.
PointOfOrderOriginCityOrder origin city. This field is not used unless the taxService_orderOriginState and taxService_orderOriginCountry fields are present.
PointOfOrderOriginCountryThis item-level field overrides the corresponding request-level field. This field is not used unless the item_#_orderAcceptanceState and item_#_orderAcceptanceCity fields are present. Use the two-character ISO Standard Country Codes.
PointOfOrderOriginPostalCodeOrder origin postal code. This field is not used unless the taxService_orderOriginCity, taxService_orderOriginState, and taxService_orderOriginCountry fields are present.
PointOfOrderOriginStateProvinceOrder origin state. This field is not used unless the taxService_orderOriginCity and taxService_orderOriginCountry fields are present. Use the State, Province, and Territory Codes for the United States and Canada.
ProductCodeType of product. This value is used to determine the product category: electronic, handling, physical, service, or shipping. The default value is default. To use the tax calculation service, use values listed in the Tax Product Code Guide. For information about this document, contact Customer Support.
ProductNameName of the product. Some services use this value for communication with the customer, so the name should clearly represent the product. For ccAuthService and ccCaptureService, required if item_#_productCode is not default or one of the values related to shipping and handling.
ProductSkuProduct’s identifier code. For ccAuthService and ccCaptureService, required if item_#_productCode is not default or one of the values related to shipping and handling.
QuantityQuantity of the product being purchased.
RateJurisdiction tax rate for the item.
ReportingDateReporting date of any committed transaction. Defaults to current date if not provided. Also the default Tax Calculation Date unless a different date is specified in invoiceHeader_invoiceDate.
RequestIdentifierIdentifier for the request.
ShipFromCityCity from which the order is shipped, which is used to determine tax rules and/or rates applied to the transaction based on sourcing. This field is used only when shipFrom_state and shipFrom_country are present.
ShipFromCountryCountry from which the product is shipped, which is used to determine tax rules and/or rates applied to the transaction based on sourcing. This item-level field overrides the corresponding request-level field. Use the two character ISO Standard Country Codes.
ShipFromPostalCodePostal code from which the product is shipped, which is used to determine tax rules and/or rates applied to the transaction based on sourcing. This item-level field overrides the corresponding request-level field.
ShipFromStateProvinceState from which the order is shipped, which is used to determine tax rules and/or rates applied to the transaction based on sourcing. This field is used only when shipFrom_city and shipFrom_country are present. Use the State, Province, and Territory Codes for the United States and Canada.
ShipToCityCity of the shipping address. This field is used only when the shipTo_state and shipTo_country fields are present.
ShipToCountryCountry of the shipping address. Use the two-character ISO Standard Country Codes. This field is used only when the ship_to_city and ship_to_state fields are present.
ShipToPostalCodePostal code for the shipping address. The postal code must consist of 5 to 9 digits. When the shipping country is the US, the 9-digit postal code must follow this format:[5 digits][dash][4 digits]Example: 12345-6789When the shipping country is Canada, the 6-digit postal code must follow this format:[alpha][numeric][alpha][space][numeric][alpha][numeric]Example: A1B 2C3
ShipToStateProvinceState or province of the shipping address. Use the State, Province, and Territory Codes for the United States and Canada. The default value for shipTo_state is billTo_state. This field is used only when the shipTo_city and shipTo_country fields are present.
ShipToStreetStreet of the shipping address.
StateProvinceThis item-level field overrides the corresponding request-level field. This field is not used unless the item_#_orderOriginCity and item_#_orderOriginCountry fields are present.
TaxableAmount—
TaxAmountTotal tax for all items.
TaxNameName of the jurisdiction tax for the item. For example, CA State Tax.
TransactionTypeSale/Refund. Based on refund indicator (refund or not).
UnitPricePer-item price of the product. This value cannot be negative.
TMS Token Fields

Field names in this group are prepended with TMSToken.

Field NameDescription
CreatorOrganization ID or merchant ID that created the token.
CustomerIDcustomer token ID.
InstrumentIdentifierIDUnique identifier for the instrument identifier.
InstrumentIdentifierStateCurrent state of the instrument identifier token.
PaymentInstrumentIDpayment instrument token ID.
ShippingAddressIDshipping address token ID.
VaultIDUnique identifier for the vault that the token belongs to.
Token Fields

Field names in this group are prepended with Token.

Field NameDescription
NetworkTokenTransTypeNetwork token transaction type.
TokenCodeTransaction token code.
Travel Fields
Field NameDescription
CompleteRouteConcatenation of individual travel legs.
DepartureDateTimeFirst leg departure date and time.
JourneyTypeType of travel.
NumberPassenger number.
PassengerFirstNamePassenger’s first name.
PassengerEmailPassenger's email address, including the complete domain name.
PassengerIdTicketed passenger identifier.
PassengerLastNamePassenger’s last name.
PassengerPhonePassenger's phone number.
PassengerStatusCompany's passenger classification, such as frequent flyer program.
PassengerTypePassenger classification associated with the price of the ticket.
Velocity Morphing Fields
Field NameDescription
CountVelocity morphing count information.
Verify Enrollment Request Fields
Field NameDescription
AcquirerBinAcquiring bank identification number.
MerchantIDMerchant identifier.
PanCustomer masked account number.
Verify Enrollment Response Fields
Field NameDescription
AccountIDAccount identifier.
AcsUrlACS URL.
EnrolledIndicates enrollment verified.
Fields with Compound Values

Some of the new reports contain different field names and headers. In some cases, multiple fields have been combined into a single field with values separated by commas. For example, the rcode, rflag, and rmsg responses for each application have been combined into ics_rcode, ics_rflag, and ics_rmsg. If a transaction called the ics_auth and ics_bill applications, the ics_rcode field could contain 1,1.

Application Fields
RcodeReasonCodeRflag
NameRmsg
Health Care Fields
amountamountTypecurrency
industryType—
Line Item Fields
FulfillmentTypeQuantityUnitPrice
TaxAmountMerchantProductSkuNameOfProduct
TypeOfProductInvoiceNumberNumber
Payment Method Fields
CardTypeExpirationMonthExpirationYear
StartMonthStartYearIssueNumber
AccountSuffixBoletoNumberBoletoBarCodeNumber
CardCategoryCardCategoryCodeWalletType
CheckNumberMandateIdMandateType
SignatureDateEffectiveDateAccountType
TypeDescriptionOverridePaymentMethodType
Payment Data Fields
AuthorizationTypeAuthorizationCodeAVSResult
CurrencyCodeAVSResultMappedCVResult
ProcessorResponseCodeNumberOfInstallmentsACHVerificationResult
ACHVerificationResultMappedBalanceAmountBalanceCurrencyCode
RequestedAmountRequestedAmountCurrencyCodeEVEmail
EVEmailRawEVNameEVNameRaw
EVPhoneNumberEVPhoneNumberRawEVStreet
EVStreetRawEVPostalCodeEVPostalCodeRaw
BinNumberAmountPaymentRequestID
PaymentProcessorTotalTaxAmountEventType
GrandTotalECIAAV_CAVV
XIDTargetAmountTargetCurrency
ExchangeRateExchangeRateDateDCCIndicator
BankCodeBankAccountNameAuthIndicator
AuthReversalResultAuthReversalAmountCardPresent
POSEntryModeEMVRequestFallbackTerminalIDAlternate
POSCatLevelCardVerificationMethodPOSEnvironment
RoutingNetworkTypeStoreAndForwardIndicatorPinType
IssuerResponseCodeAcquirerMerchantNumberNetworkCode
MandateReferenceNumberProcessorTIDProcessorTransactionID
ProcessorMIDPaymentProductCodeAcquirerMerchantID
SubMerchantCitySubMerchantCountrySubMerchantEmail
SubMerchantIDSubMerchantNameSubMerchantPhone
SubMerchantPostalCodeSubMerchantStateSubMerchantStreet
TransactionRefNumbereCommerceIndicatorCustomerAccountID
BatchFilesIDSolutionTypeAuthFactorCode
EMVServiceCodeAFTIndicatorSalesSlipNumber
JpoJccaTerminalIDJpoPaymentMethodShopName
ShopNameLocalShopNameKatakanaPOSTerminalCapability
MerchantCategoryCode—

Last published: September 29, 2026