Response Fields

Chase Paymentech Solutions:

Indicates whether a customer has high credit limits. This information enables you to market high-cost items to these customers and to understand the kinds of cards that high-income customers are using.

This field is available for Visa, Mastercard, Discover, and Diners Club. Possible values:

Y
: Yes
N
: No
X
: Does not apply/unknown

Worldpay VAP:

Flag that indicates that a Visa cardholder or Mastercard cardholder is in one of the affluent categories. Possible values:

AFFLUENT
: High income customer with high spending pattern (>100k USD annual income and >40k USD annual card usage).
MASS AFFLUENT
: High income customer (>100k USD annual income).

Data Type & Length:

Chase Paymentech Solution: String (1)
Worldpay VAP: String (13)

Amount that was authorized.

Data Type & Length:

String (15)

AVS result code. See AVS Codes.

Data Type & Length:

String (1)

AVS result code sent directly from the processor. Returned only if a value is returned by the processor.

Data Type & Length:

String (10)

Indicates whether the card is a commercial card, which enables you to include Level II data in your transaction requests. Possible values:

Y
: Yes
N
: No
X
: Does not apply/unknown

This field is available for Visa and Mastercard on Chase Paymentech Solutions.

Data Type & Length:

String (1)

Indicates whether the card is a healthcare card. Possible values:

Y
: Yes
N
: No
X
: Does not apply/unknown

This field is available for Visa and Mastercard on Chase Paymentech Solutions.

Data Type & Length:

String (1)

Country in which the card was issued. This information enables you to determine whether the card was issued domestically or internationally.

This field is available for Visa, Mastercard, Discover, Diners Club, JCB, and Maestro (International) on Chase Paymentech Solutions.

Data Type & Length:

String (3)

Indicates whether the card is eligible for Level III interchange fees, which enables you to include Level III data in your transaction requests. Possible values:

Y
: Yes
N
: No
X
: Does not apply/unknown

This field is available for Visa and Mastercard on Chase Paymentech Solutions.

Data Type & Length:

String (1)

Indicates whether the card is a payroll card. Possible values:

Y
: Yes
N
: No
X
: Does not apply/unknown

This field is available for Visa, Discover, Diners Club, and JCB on Chase Paymentech Solutions.

Data Type & Length:

String (1)

Indicates whether the card is a prepaid card. This information enables you to determine when a gift card or prepaid card is presented for use when establishing a new recurring billing or installment billing relationship. Possible values:

Y
: Yes
N
: No
X
: Does not apply/unknown

This field is available for Visa, Mastercard, Discover, Diners Club, and JCB on Chase Paymentech Solutions.

Data Type & Length:

String (1)

Indicates whether the card is regulated according to the Durbin Amendment. If the card is regulated, the card issuer is subject to price caps and interchange rules. Possible values:

Y
: Yes (assets greater than $10B)
N
: No (assets less than $10B)
X
: Does not apply/unknown

This field is available for Visa, Mastercard, Discover, Diners Club, and JCB on Chase Paymentech Solutions.

Data Type & Length:

String (1)

Indicates whether the card is a signature debit card. This information enables you to alter the way an order is processed. Possible values:

Y
: Yes
N
: No
X
: Does not apply/unknown

This field is available for Visa, Mastercard, and Maestro (International) on Chase Paymentech Solutions.

Data Type & Length:

String (1)

Mapped response code for the Visa Secure and American Express SafeKey:

See Visa Secure Response Codes.
See American Express SafeKey Response Codes.

Data Type & Length:

String (3)

Raw response code sent directly from the processor for Visa Secure and American Express SafeKey.

Data Type & Length:

String (3)

Authorization code. Returned only if a value is returned by the processor.

Data Type & Length:

String (7)

CVN result code. See CVN Codes.

Data Type & Length:

String (1)

CVN result code sent directly from the processor. Returned only if a value is returned by the processor.

Data Type & Length:

String (10)

Unique number that

Cybersource

generates to identify the transaction.

Data Type & Length:

String (20)

For most processors, this is the error message sent directly from the bank. Returned only if a value is returned by the processor.

Data Type & Length:

String (10)

Time of authorization in UTC.

Data Type & Length:

String (20)

Reference number that you use to reconcile your transaction reports with your processor reports.

Data Type & Length:

Reference number that you use to reconcile your transaction reports with your processor reports.

Data Type & Length:

AlphaNumeric (60)

Name of the card type.

For security reasons, this field is returned only in the merchant POST URL and email notifications (not in the receipt POST through the browser).

Data Type & Length:

String (50)

The result of your request. Possible values:

ACCEPT
DECLINE
REVIEW
ERROR
CANCEL

See Types of Notifications.

Data Type & Length:

String (7)

Reference number for the transaction.

Data Type & Length:

AlphaNumeric (60)

Time when the debit was requested in UTC.

Data Type & Length:

Date and Time (20)

Exchange rate if a currency conversion occurred.

The 17 characters include the decimal point.

Data Type & Length:

Decimal (17)

Indicates which request fields were invalid.

Data Type & Length:

Variable

Response message from the payment gateway.

Data Type & Length:

String (255)

Unique transaction identifier assigned by the ACS to identify a single transaction.

Data Type & Length:

String (36)

Cardholder authentication verification value (CAVV). Transaction identifier generated by the issuing bank

or

Visa Click to Pay

. This field is used by the payer authentication validation service.

Data Type & Length:

String (50)

The type of 3-D Secure transaction flow that occurred. Possible values:

CH
: Challenge
FR
: Frictionless
FD
: Frictionless with delegation (challenge not generated by the issuer but by the scheme on behalf of the issuer).

Used for Cartes Bancaires transactions.

Data Type & Length:

String (2)

Electronic commerce indicator (ECI). This field is used by payer authentication validation and enrollment services. Possible values for Visa, American Express,

China UnionPay

and JCB:

05
: Successful authentication.
06
: Authentication attempted.
07
: Failed authentication.

Possible values for Mastercard:

00
: Failed authentication.
01
: Authentication attempted.
02
: Successful authentication.

Data Type & Length:

String (15)

Commerce indicator for cards not enrolled. Possible values:

internet
: Card not enrolled or card type not supported by Payer Authentication. No liability shift.
js_attempted
: JCB card not enrolled, but attempt to authenticate is recorded. Liability shift.
js_failure
: J/Secure directory service is not available. No liability shift.
spa
: Mastercard card not enrolled in the Identity Check program. No liability shift.
up3ds
: China UnionPay card authentication verified successfully.
up3ds_attempted
: China UnionPay card not enrolled, but the attempt to authenticate is recorded.
up3ds_failure:
China UnionPay card authentication unavailable.
vbv_attempted
: Visa card not enrolled, but attempt to authenticate is recorded. Liability shift.
vbv_failure
: For payment processor Barclays, Streamline, or AIBMS, you receive this result if Visa's directory service is not available. No liability shift.

Data Type & Length:

String (255)

Result of the enrollment check. Possible values:

Y
: Card enrolled or can be enrolled; you must authenticate. Liability shift.
N
: Card not enrolled; proceed with authorization. Liability shift.
U
: Unable to authenticate regardless of the reason. No liability shift.

This field applies only to the Asia, Middle East, and Africa Gateway. If you are configured for this processor, you must send the value of this field in your authorization request.

This value can be returned if you are using rules-based payer authentication:

B
: Indicates that authentication was bypassed.

For rules-based payer authentication information, see the Payer Authentication Guides.

Data Type & Length:

String (255)

The global score calculated by the Cartes Bancaires scoring platform and returned to the merchant.

Data Type & Length:

Integer (2)

Raw result of the authentication check. Possible values:

A
: Proof of authentication attempt was generated.
N
: Customer failed or cancelled authentication. Transaction denied.
U
: Authentication not completed regardless of the reason.
Y
: Customer was successfully authenticated.

Data Type & Length:

String (255)

Provides additional information about the PARes status value.

Data Type & Length:

Integer (2)

Decrypted time stamp for the payer authentication result.

Visa Click to Pay

generates this value. Format: Unix time, which is also called

epoch time

.

Data Type & Length:

String

XML element containing proof of enrollment verification.

For cards not issued in the U.S. or Canada, your bank can require this data as proof of enrollment verification for any payer authentication transaction that you re-submit because of a chargeback.

For cards issued in the U.S. or Canada, Visa can require this data for specific merchant category codes.

This field is HTML encoded.

This field is not returned for 3-D Secure 2.0 transactions.

Data Type & Length:

String (1024)

Numeric value corresponding to the result of the payer authentication request. See Reason Codes.

Data Type & Length:

String (5)

This field contains the 3-D Secure version that was used to process the transaction. For example, 1.0.2 or 2.0.0.

Data Type & Length:

String (20)

Payer authentication transaction identifier used by

Secure Acceptance

to link the enrollment check and validate authentication messages.

Data Type & Length:

String (20)

Indicates the type of authentication that is used to challenge the cardholder. Possible values:

01
: Static
02
: Dynamic
03
: OOB (Out of Band)

Data Type & Length:

Integer (2)

Mastercard Identity Check UCAF authentication data. Returned only for Mastercard Identity Check transactions.

Data Type & Length:

String (32)

Mastercard Identity Check UCAF collection indicator. This field indicates whether authentication data is collected at your website. Possible values:

0
: Authentication data was not collected and customer authentication not completed.
1
: Authentication data was not collected because customer authentication not completed.
2
: Authentication data was collected. Customer completed authentication.

Data Type & Length:

String (1)

Indicator that distinguishes Internet transactions from other types. The authentication failed if this field is not returned.

For Visa, if your payment processor is Streamline, Barclays, or AIBMS, you receive the value

vbv_failure

instead of internet when

payer_authentication_eci

is not present.

The value of this field is passed automatically to the authorization service if you request the services together. Possible values:

aesk
: American Express SafeKey authentication verified successfully.
aesk_attempted
: Card not enrolled in American Express SafeKey, but the attempt to authenticate was recorded.
internet
: Authentication was not verified successfully.
js
: J/Secure authentication verified successfully.
js_attempted
: JCB card not enrolled in J/Secure, but the attempt to authenticate was recorded.
spa
: Mastercard Identity Check authentication verified successfully.
spa_failure
: Mastercard Identity Check failed authentication.
vbv
: Visa Secure authentication verified successfully.
vbv_attempted
: Card not enrolled in Visa Secure, but the attempt to authenticate was recorded.
vbv_failure
: Visa Secure authentication unavailable.

Data Type & Length:

String (255)

Raw authentication data that comes from the card-issuing bank that indicates whether authentication was successful and whether liability shift occurred. Possible values:

-1
: Invalid PARes.
0
: Successful validation.
1
: Cardholder is not participating, but the attempt to authenticate was recorded.
6
: Issuer unable to perform authentication.
9
: Cardholder did not complete authentication.

Data Type & Length:

String (255)

Decrypted time stamp for the verification response.

Visa Click to Pay

generates this value. Format: Unix time, which is also called

epoch time

.

Data Type & Length:

String

Enables the communication of trusted beneficiary and whitelist status among the ACS, the directory server, and the 3-D Secure requester. Possible Values:

Y
: 3-D Secure requester is whitelisted by cardholder
N
: 3-D Secure requester is not whitelisted by cardholder

Data Type & Length:

String (1)

This field is populated by the system setting whitelist status. Possible Values:

01
: 3-D Secure Server
02
: Directory server
03
: ACS

Data Type & Length:

Integer (2)

Transaction identifier generated by payer authentication. Used to match an outgoing payer authentication request with an incoming payer authentication response.

Data Type & Length:

String (28)

Reference number serves as a link to the cardholder account and to all transactions for that account. The same value is returned whether the account is represented by a PAN or a network token.

Data Type & Length:

String (32)

Type of credential-on-file (COF) payment network token. Returned in authorizations that use a payment network token associated with a TMS token. Possible values:

014
: Mastercard
015
: Visa
016
: American Express

Data Type & Length:

String (3)

Identifier for the payment details. The payment token retrieves the card data, billing information, and shipping information from the payment repository.

This payment token supersedes the previous payment token and is returned if:

The merchant is configured for a 16-digit payment token that displays the last four digits of the primary account number (PAN) and passes Luhn mod-10 check. See Payment Tokens.
The customer has updated the card number on their payment token. This payment token supersedes the previous payment token and should be used for subsequent transactions.

You must be using Token Management Services.

Data Type & Length:

String (32)

Unique identifier for the

Token Management Service

(

TMS

) instrument identifier token. You can use it to understand when the same PAN is being used in different tokens, without being exposed to the PAN.

Data Type & Length:

String (32)

Indicates whether the tokenized credential already exists as an Instrument Identifier or is a new credential. Possible values:

Y
N

Data Type & Length:

String (1)

Issuer's status for the card number. If you use Account Updater, the status can be updated to

closed

if the PAN is not longer active. If you use network tokenization, the PAN might be

closed

(e.g. lost card), but the network token might still be active. Possible values:

ACTIVE
CLOSED
: The card account is closed.

Data Type & Length:

String (6)

Card expiration date of the latest card issued to the cardholder.

Returned when Network Tokenization is enabled, and a

payment_token

with an associated Network Token is used in a transaction. Network Tokens can continue to be used even if the original card has expired.

Format: MM-yyyy

Data Type & Length:

Date (a) (7)

Last four digits of the latest card issued to the cardholder.

Returned when Network Tokenization is enabled, and a

payment_token

with an associated Network Token is used in a transaction. Network Tokens can continue to be used even if the original card number has changed due to a new card being issued. Use the last four digits in payment confirmation messages to cardholders, for example: "Thank you for your payment using your Visa card ending [payment_token_latest_card_suffix]".

Data Type & Length:

String (4)

Status of the street address on file with PayPal. Possible values:

None
Confirmed
Unconfirmed

Data Type & Length:

String (12)

PayPal identifier that is used to investigate any issues.

Data Type & Length:

String (20)

Unique identifier for the transaction.

Data Type & Length:

String (17)

Email address of the customer as entered during checkout. PayPal uses this value to pre-fill the PayPal membership sign-up portion of the PayPal login page.

Data Type & Length:

String (127)

PayPal identifier that is used to investigate any issues.

Data Type & Length:

String (20)

Unique identifier for the transaction.

Data Type & Length:

String (17)

PayPal identifier that is used to investigate any issues.

Data Type & Length:

String (20)

Value of the request ID returned from a PayPal get details service request.

Data Type & Length:

String (26)

Unique identifier for the transaction.

Data Type & Length:

String (17)

PayPal identifier that is used to investigate any issues.

Data Type & Length:

String (20)

Unique identifier for the transaction.

Data Type & Length:

String (17)

Value of the request ID returned from a PayPal set service request.

Data Type & Length:

String (26)

PayPal fee charged for the transaction. This value does not exceed the equivalent of 10,000 USD in any currency and does not include a currency symbol. The decimal separator is a period (.), and the optional thousands separator is a comma (,).

Data Type & Length:

String (9)

Value of the request ID returned from a PayPal order setup service request.

Data Type & Length:

String (26)

Customer's PayPal account identification number.

Alphanumeric

Customer's status. Possible values:

verified
unverified

Data Type & Length:

String (10)

Indicates the reason that payment is pending. Possible values:

address
: Your customer did not include a confirmed shipping address, and your Payment Receiving preferences are set to manually accept or deny such payments. To change your preferences, go to the Preferences section of your PayPal profile.
authorization
: The payment has been authorized but not settled. Capture the authorized amount.
electronic check
: Payment was made by an echeck that has not yet cleared.
intl
: You have a non-U.S. account and do not have a withdrawal mechanism. You must manually accept or deny this payment in your PayPal Account Overview.
multi-currency
: You do not have a balance in the currency sent, and your Payment Receiving preferences are not set to automatically convert and accept this payment. You must manually accept or deny this payment in your PayPal Account Overview.
none
: No pending reason.
order
: The payment is part of an order that has been authorized but not settled.
paymentreview
: The payment is being reviewed by PayPal for possible fraud.
unilateral
: The payment was made to an email address that is not registered or confirmed.
verify
: Your account is not yet verified. You must verify your account before you can accept this payment.

Data Type & Length:

String (14)

Status of the transaction. Possible values:

Canceled-Reversal
: PayPal canceled the reversal, which happens when you win a dispute, and the funds for the reversal are returned to you.
Completed
: PayPal completed the payment and added the funds to your account.
Denied
: You denied a payment, which happens only if the payment was pending for the reason indicated in the
reason_code
field.
Expired
: The authorization expired.
Failed
: The payment failed. This event can happen only when the payment is made from your customer's bank account.
In-Progress
: The transaction is not complete yet.
None
: No status.
Partially-Refunded
: The payment was partially refunded.
Pending
: The payment is pending for the reason indicated in the
paypal_pending_reason
field.
Processed
: PayPal accepted the payment.
ReasonCode
Refunded
: You refunded the payment.

Data Type & Length:

String (20)

Continued status of the transaction. Possible values:

Reversed
: PayPal reversed the payment for the reason specified in the
reason_code
field. The funds were transferred from your account to the customer's account.
Voided
: The authorization was voided.

Data Type & Length:

String (20)

Seller protection in force for the transaction. Possible values:

Eligible
: You are protected by the PayPal Seller Protection Policy for unauthorized payment and item not received.
PartiallyEligible
: You are protected by the PayPal Seller Protection Policy for item not received.
Ineligible
: You are not protected under the PayPal Seller Protection Policy.

Data Type & Length:

String (17)

Seller protection in force for the transaction. Possible values:

Eligible
: You are protected by the PayPal Seller Protection Policy for unauthorized payment and item not received.
ItemNotReceivedEligible
: You are protected by the PayPal Seller Protection Policy for item not received.
UnauthorizedPaymentEligible
: You are protected by the PayPal Seller Protection Policy for unauthorized payment.
Ineligible
: You are not protected under the PayPal Seller Protection Policy.

To enable the

paypal_protection_eligibility_type

field, contact customer support to have your account configured for this feature.

Data Type & Length:

String (32)

Identifier for the request generated by the client.

Data Type & Length:

String (26)

Timestamped PayPal token that identifies that PayPal Express Checkout is processing the transaction. Save this value to send in future request messages.

Data Type & Length:

String (20)

Indicates the PayPal transaction type. Possible value:

expresscheckout

Data Type & Length:

String (16)

Numeric value corresponding to the result of the payment card transaction request. See Reason Codes.

Data Type & Length:

String (5)

Authenticates the merchant with the application.

Data Type & Length:

String (32)

Value that identifies you as a payment aggregator. Obtain this value for the processor.

Visa Platform Connect

:

The value for this field corresponds to this data in the TC 33 capture file:

Record: CP01 TCR6
Position: 95-105
Field: Mastercard Payment Facilitator ID

FDC Compass:

This value must consist of uppercase characters.

Data Type & Length:

String

American Express Direct: 20
FDC Compass: 20
FDC Nashville Global: 15
Visa Platform Connect
: 11

Indicates whether the customer can update the billing, shipping, and payment information on the order review page. Possible values:

true
: Customer can update details.
false
: Customer cannot update details.

Data Type & Length:

String (5)

Total amount for the order. Must be greater than or equal to zero.

Data Type & Length:

String (15)

Flag that specifies the purpose of the authorization. Possible values:

0
: Preauthorization
1
: Final authorization

Mastercard requires European merchants to indicate whether the authorization is a final authorization or a preauthorization. To set the default for this field, contact customer support.

Data Type & Length:

String (1)

Authorization type. Possible values:

AUTOCAPTURE
: Automatic capture.
STANDARDCAPTURE
: Standard capture.
verbal
: Forced capture.

Asia, Middle East, and Africa Gateway; Cielo; Comercio Latino; and Cybersource Latin American Processing

:

Set this field to

AUTOCAPTURE

and include it in a bundled request to indicate that you are requesting an automatic capture. If your account is configured to enable automatic captures, set this field to

STANDARDCAPTURE

and include it in a standard authorization or bundled request to indicate that you are overriding an automatic capture.

Forced Capture

Set this field to

verbal

and include it in the authorization request to indicate that you are performing a forced capture; therefore, you receive the authorization code outside the transaction processing system.

Verbal Authorization

Set this field to

verbal

and include it in the capture request to indicate that the request is for a verbal authorization.

Data Type & Length:

Cielo, Comercio Latino, and Cybersource Latin American Processing: String (15)

Flag that indicates a payment for a bill or for an existing contractual loan. Visa provides a Bill Payment program that enables customers to use their Visa cards to pay their bills. Possible values:

true
: Bill payment or loan payment.
false
(default): Not a bill payment or loan payment.

Data Type & Length:

String (5)

City in the billing address.

Data Type & Length:

String (50)

ISO country code for the billing address.

Data Type & Length:

String (2)

First line of the street address in the billing address.

Data Type & Length:

String (60)

Second line of the street address in the billing address.

Data Type & Length:

String (60)

Postal code for the billing address. This field is returned if

bill_to_address_country

is U.S. or Canada.

Data Type & Length:

String (10)

The state or province for the bill-to address. For the United States and Canada, the two-character ISO state and province code is returned. See

State, Province, and Territory Codes for the United States and Canada

.

Data Type & Length:

String (20)

Name of the customer's company.

Data Type & Length:

String (60)

Customer email address.

Data Type & Length:

String (255)

Customer first name.

Data Type & Length:

String (60)

Customer phone number.

Data Type & Length:

String (15)

Customer last name.

Data Type & Length:

String (60)

Flag that specifies the type of account associated with the card. The cardholder provides this information during the payment process.

Cielo and Comercio Latino

possible values:

CR
: Credit card
DB
: Debit card

Visa Platform Connect

possible values:

CH
: Checking account
CR
: Credit card account
SA
: Savings account

This field is returned for:

Debit transactions on Cielo and Comercio Latino.
Transactions with Brazilian-issued cards on
Visa Platform Connect
.

Combo cards in Brazil contain credit and debit functionality in a single card. Visa systems use a bank identification number (BIN) for this type of card. Using the BIN to determine whether a card is debit or credit can cause transactions with these cards to be processed incorrectly. It is strongly recommended that you include this field for combo card transactions.

Data Type & Length:

String (2)

Card expiration date.

Data Type & Length:

String (7)

Card number.

Data Type & Length:

String (20)

Type of card.

Data Type & Length:

String (3)

Company's tax identifier. The last four digits are not masked.

Data Type & Length:

String (9)

Concatenation of individual travel legs in the format: SFO-JFK:JFK-LHR:LHR-CDG.

For a complete list of airport codes, see IATA's City Code Directory.

In your request, send either the complete route field or the individual legs (

journey_leg#_orig

and

journey_leg#_dest

). If you send all the fields, the value of

complete_route

takes precedence over that of the

journey_leg#

fields.

Data Type & Length:

String (255)

Identifier for the customer account. This value is defined when creating a customer token.

Data Type & Length:

String (100)

Currency used for the order. See ISO currency codes.

Data Type & Length:

String (3)

Indicates whether the customer's browser accepts cookies. Possible values:

true
: Customer browser accepts cookies.
false
: Customer browser does not accept cookies.

Data Type & Length:

String (5)

Indicates whether the customer requested gift wrapping for this purchase. Possible values:

true
: Customer requested gift wrapping.
false
: Customer did not request gift wrapping.

Data Type & Length:

String (5)

Customer IP address reported by your web server using socket information.

Date of birth of the customer.

Format: yyyyMMDD.

Data Type & Length:

String (8)

Flag that indicates a payment for an existing contractual loan under the VISA Debt Repayment program. Contact your processor for details and requirements. Possible formats:

false
(default): Not a loan payment
true
: Loan payment

Data Type & Length:

String (5)

Departure date and time of the first leg of the trip. Use one of these formats:

yyyy-MM-DD HH:mm z
yyyy-MM-DD hh:mm a z
yyyy-MM-DD hh:mma z
HH = 24-hour format
hh = 12-hour format
a = am or pm (case insensitive)
z = time zone of the departing flight.

Data Type & Length:

String (29)

Field that contains the session ID for the fingerprint. The

Data Type & Length:

String can contain uppercase and lowercase letters, digits, and these special characters: hyphen (-) and underscore (_).

However, do not use the same uppercase and lowercase letters to indicate different sessions IDs.

The session ID must be unique for each merchant ID. You can use any

Data Type & Length:

String that you are already generating, such as an order number or web session ID.

Data Type & Length:

String (88)

Driver's license number of the customer. The last four digits are not masked.

Data Type & Length:

String (30)

State or province from which the customer's driver's license was issued.

Data Type & Length:

String (2)

The commerce indicator for the transaction type.

Value:

install

This field is returned only for installment payments on Cybersource Latin American Processing.

Data Type & Length:

String (13)

Account number. This number is masked.

Data Type & Length:

Non-negative integer (17)

Account type. Possible values:

C
: Checking
S
: Savings (USD only)
X
: Corporate checking (USD only)

Data Type & Length:

String (1)

Check number.

Data Type & Length:

Integer (8)

Effective date for the transaction.

Data Type & Length:

Date (b) String (8)

Bank routing number. It is also called the transit number.

Data Type & Length:

Non-negative integer (9)

The authorization method for the transaction. Possible values:

CCD
PPD
TEL
WEB

Data Type & Length:

String (3)

Ignore the results of AVS verification. Possible values:

true
false

Data Type & Length:

String (5)

Ignore the results of CVN verification. Possible values:

true
false

Data Type & Length:

String (5)

Total amount of the loan that is being paid in installments.

This field is returned only for installment payments on Cybersource Latin American Processing or

Visa Platform Connect

.

Data Type & Length:

Amount (12)

Total number of installment payments as part of an authorization. Possible values:

1

to

99

.

This field is returned only for installment payments on Cybersource Latin American Processing.

Data Type & Length:

Numeric String (2)

Data defined by the issuer. See the “Discretionary Data” section in

Credit Card Services Optional Features Supplement

.

Data Type & Length:

Alphanumeric String (256)

Type of product. # can range from

0

to

199

.

Data Type & Length:

String (255)

Description of the item. # can range from

0

to

199

.

Data Type & Length:

String (255)

Name of the item. # can range from

0

to

199

.

Data Type & Length:

String (255)

Passenger's email address.

Data Type & Length:

String (255)

Passenger's first name.

Data Type & Length:

String (60)

ID of the passenger to whom the ticket was issued. For example, you can use this field for the frequent flyer number.

Data Type & Length:

String (32)

Passenger's phone number. If the order is from outside the U.S., it is recommended that you include the country code.

Data Type & Length:

String (15)

Your company's passenger classification, such as with a frequent flyer classification. In this case, you might use values such as standard, gold, or platinum.

Data Type & Length:

String (32)

Passenger's last name.

Data Type & Length:

String (60)

Passenger classification associated with the price of the ticket. Possible values:

ADT
: Adult
CNN
: Child
INF
: Infant
YTH
: Youth
STU
: Student
SCR
: Senior Citizen
MIL
: Military

Data Type & Length:

String (32)

Quantity of line items. # can range from

0

to

199

.

Data Type & Length:

String (10)

Identification code for the product. # can range from

0

to

199

.

Data Type & Length:

String (255)

Tax amount to apply to the line item. # can range from

0

to

199

. This value cannot be negative. The tax amount and the offer amount must be in the same currency.

Data Type & Length:

String (15)

Price of the line item. # can range from

0

to

199

. This value cannot be negative.

Data Type & Length:

String (15)

Airport code for the origin of the leg of the trip, designated by the pound (#) symbol in the field name. For a complete list of airport codes, see IATA's City Code Directory.

Data Type & Length:

String (3)

Airport code for the origin of the leg of the trip, designated by the pound (#) symbol in the field name. This code is usually three digits long; for example: SFO = San Francisco. For a complete list of airport codes, see IATA's City Code Directory.

Data Type & Length:

String (3)

Type of travel, such as one way or round trip.

Data Type & Length:

String (32)

Total number of Japanese installment payments.

Data Type & Length:

String (2)

Japanese payment method.

Data Type & Length:

String (1)

Total number of line items. Maximum amount is 200.

Data Type & Length:

String (3)

Indicates the language to use for customer content. See Activating a Profile.

Data Type & Length:

String (5)

Optional fields that you can use to store information. # can range from

1

to

100

.

Merchant-defined data fields

1

to

4

are associated with the payment token and are used for subsequent token-based transactions. Merchant-defined data fields

5

to

100

are passed through to

Decision Manager

as part of the initial payment request and are not associated with the payment token. Personally identifying information includes, but is not limited to, card number, bank account number, social security number, driver's license number, state-issued identification number, passport number, card verification numbers (CVV, CVC2, CVV2, CID, CVN). If it is discovered that a merchant is capturing and/or transmitting personally identifying information via the merchant-defined data fields, whether or not intentionally, the merchant's account WILL immediately be suspended, which will result in a rejection of any and all transaction requests submitted by the merchant after the point of suspension.

Data Type & Length:

String (100)

Your business name. This name appears on the cardholder’s statement.

Data Type & Length:

String (23)

Alternate contact information for your business, such as an email address or URL. This value might appear on the cardholder’s statement.

Data Type & Length:

String (13)

City for your business location. This value might appear on the cardholder’s statement.

Data Type & Length:

String (13)

Telephone number for your business. This value might appear on the cardholder’s statement.

Data Type & Length:

String (14)

Country code for your business location. Use the standard ISO Standard Country Codes. This value might appear on the cardholder’s statement.

Data Type & Length:

String (2)

Postal code for your business location. This value might appear on the cardholder’s statement.

Data Type & Length:

String (14)

State code or region code for your business location. This value might appear on the cardholder’s statement.

Data Type & Length:

String (3)

Street address for your business location. This value might appear on the cardholder’s statement.

Data Type & Length:

String (60)

Optional field that you can use to store information. The data is encrypted before it is stored in the payment repository.

Data Type & Length:

String (100)

Optional field that you can use to store information. The data is encrypted before it is stored in the payment repository.

Data Type & Length:

String (100)

Optional field that you can use to store information. The data is encrypted before it is stored in the payment repository.

Data Type & Length:

String (100)

Optional field that you can use to store information. The data is encrypted before it is stored in the payment repository.

Data Type & Length:

String (2000)

Overrides the backoffice post URL profile setting with your own URL.

Data Type & Length:

URL (255)

Overrides the custom cancel page profile setting with your own URL.

Data Type & Length:

URL (255)

Overrides the custom receipt profile setting with your own URL.

Data Type & Length:

URL (255)

Method of payment. Possible values:

card
echeck
paypal
visacheckout

Data Type & Length:

String (30)

Identifier for the payment details. The payment token retrieves the card data, billing information, and shipping information from the payment repository. When this field is included in the request, the card data and billing and shipping information are optional.

You must be currently using the Token Management Service.

Data Type & Length:

String (32)

Optional comments about the customer token.

Data Type & Length:

String (255)

Name of the customer token.

Data Type & Length:

String (60)

Identifies the profile to use with each transaction.

Data Type & Length:

String (36)

Promotion code included in the transaction.

Data Type & Length:

String (100)

Identifier for the recipient's account. Use the first six digits and last four digits of the recipient's account number.

Data Type & Length:

Numeric String (10)

Recipient's date of birth.

Format: yyyyMMDD.

Data Type & Length:

Date (b) String (8)

Partial postal code for the recipient's address.

Data Type & Length:

Alphanumeric String (6)

Recipient's last name.

Data Type & Length:

Alpha String (6)

Payment amount for each installment or recurring subscription payment.

Data Type & Length:

String (15)

Indicates whether to automatically renew the payment schedule for an installment subscription. Possible values:

true
(default): Automatically renew.
false
: Do not automatically renew.

Data Type & Length:

Enumerated String (5)

Frequency of payments for an installment or recurring subscription.

Data Type & Length:

String (20)

Total number of payments set up for an installment subscription.

Data Type & Length:

String (3)

First payment date for an installment or recurring subscription payment.

Data Type & Length:

String (8)

Unique merchant-generated order reference or tracking number for each transaction.

Data Type & Length:

String (50)

Indicates whether product returns are accepted. Possible values:

true
false

Data Type & Length:

String (5)

Company ID assigned to an independent sales organization. Obtain this value from Mastercard.

Visa Platform Connect

: The value for this field corresponds to this data in the TC 33 capture file:

Record: CP01 TCR6
Position: 106-116
Field: Mastercard Independent Sales Organization ID

Data Type & Length:

Nonnegative integer (11)

City of shipping address.

Data Type & Length:

String (50)

Visa Click to Pay

: String (100)

The two-character ISO country code.

Data Type & Length:

String (2)

First line of shipping address.

Data Type & Length:

String (60)

Visa Click to Pay

: String (100)

Second line of shipping address.

Data Type & Length:

String (60)

Visa Click to Pay

: String (100)

Postal code for the shipping address.

Data Type & Length:

String (10)

Visa Click to Pay

: String (100)

The two-character

State, Province, and Territory Codes for the United States and Canada

.

Data Type & Length:

String (2)

Name of the company receiving the product.

Data Type & Length:

String (40)

First name of person receiving the product.

Data Type & Length:

String (60)

Visa Click to Pay

: String (256)

Phone number for the shipping address.

Data Type & Length:

String (15)

Visa Click to Pay

: String (30)

Last name of person receiving the product.

Data Type & Length:

String (60)

Visa Click to Pay

: String (256)

Shipping method for the product. Possible values:

sameday
: Courier or same-day service
oneday
: Next day or overnight service
twoday
: Two-day service
threeday
: Three-day service
lowcost
: Lowest-cost service
pickup
: Store pick-up
other
: Other shipping method
none
: No shipping method

Data Type & Length:

String (10)

Indicates whether to skip

Decision Manager

. Possible values:

true
false

Data Type & Length:

String (5)

Sub-merchant's city.

Sub-merchant's country.

Data Type & Length:

String (3)

Sub-merchant's email address.

Visa Platform Connect

:

With American Express, the value for this field corresponds to this data in the TC 33 capture file:

Record: CP01 TCRB
Position: 25-64
Field: American Express Seller E-mail Address

Data Type & Length:

American Express Direct: String (40)
FDC Compass: String (40)
FDC Nashville Global: String (19)
Visa Platform Connect
: String (40)

The ID you assigned to your sub-merchant.

Visa Platform Connect

:

Sub-merchant's business name.

Sub-merchant's telephone number.

Visa Platform Connect

:

With American Express, the value for this field corresponds to this data in the TC 33 capture file:

Record: CP01 TCRB
Position: 5-24
Field: American Express Seller Telephone Number

Partial postal code for the sub-merchant's address.

Sub-merchant's state or province.

Data Type & Length:

String (2)

First line of the sub-merchant's street address.

Total tax to apply to the product.

Data Type & Length:

String (15)

The type of transaction requested.

Data Type & Length:

String (60)

Unique merchant-generated identifier. Include with the

access_key

field for each transaction.

Data Type & Length:

String (50)

Visa Click to Pay

: String (100)

Request token data created for each response. This field is an encoded string that contains no confidential information.

You must store the request token value so that you can retrieve and send it in follow-on requests.

Data Type & Length:

String (256)

Indicates which of the request fields were required but not provided.

Data Type & Length:

Variable

The service fee amount for the order.

Data Type & Length:

String (15)

The Base64 signature returned by the server.

Data Type & Length:

String (44)

The date and time of when the signature was generated by the server. Format: yyyy-MM-DDThh:mm:ssZ.

Example:

2020-08-11T22:47:57Z equals August 11, 2020, at 22:47:57 (10:47:57 p.m.). The T separates the date and the time. The Z indicates UTC.

Data Type & Length:

String (20)

A comma-separated list of response data that was signed by the server. All fields within this list should be used to generate a signature that can then be compared to the response signature to verify the response.

Data Type:

Variable

The transaction identifier returned from the payment gateway.

Data Type & Length:

String (26)

Indicates whether the unicode characters are encoded. Possible value:

✓

Data Type & Length:

String (3)

Decrypted raw (unmapped) AVS code provided by

Visa Click to Pay

.

Data Type & Length:

String (10)

Decrypted risk score used with your fraud model. See Configuring Visa Click to Pay.

Data Type & Length:

Positive Integer (2)

Decrypted order identifier generated by

Visa Click to Pay

.

Data Type & Length:

String (100)