Home > API Fields > Request Fields


Request Fields

Unless otherwise noted, all field names are case sensitive and all fields accept special characters such as @, #, and %.

Table 2Request Fields

Field

Description

Used By: Required (R) or Optional (O)

Data Type (Length)

card_accountNumber

The payment network token value.

Populate this field with the decrypted DPAN value.

ccAuthService (R)

Nonnegative integer (20)

card_cardType

Type of card to authorize. Value: 001 for Visa

ccAuthService (R)

String (3)

card_cvNumber

CVN. 

ccAuthService (R)

Nonnegative integer (4)

card_expirationMonth

Two-digit month in which the payment network token expires.

Format: MM.

Possible values: 01 through 12.

ccAuthService (R)

String (2)

card_expirationYear

Four-digit year in which the payment network token expires.

Format: YYYY.

ccAuthService (R)

Nonnegative integer (4)

ccAuthService_cavv

Cryptogram for payment network token transactions. The value for this field must be 28-character base64 or 40-character hex binary. All cryptograms use one of these formats.

ccAuthService (R)

String (40)

ccAuthService_commerceIndicator

For a payment network token transaction.

Value: internet for the Visa card type

ccAuthService (R)

String (20)

ccAuthService_run

Whether to include ccAuthService in your request. Possible values:

ntrue: Include the service in your request.

nfalse (default): Do not include the service in your request.

ccAuthService (R)

 

ccAuthService_xid

Cryptogram for payment network token transactions. The value for this field must be 28-character base64 or 40-character hex binary. All cryptograms use one of these formats.

ccAuthService (R)

String (40)

merchantID

Your CyberSource merchant ID. Use the same merchant ID for evaluation, testing, and production.

ccAuthService (R)

String (30)

merchantReferenceCode

Merchant-generated order reference or tracking number. CyberSource recommends that you send a unique value for each transaction so that you can perform meaningful searches for the transaction. For information about tracking orders, see Getting Started with CyberSource Advanced for the Simple Order API.

ccAuthService (R)

String (50)

paymentNetworkToken_transactionType

 

Type of transaction that provided the token data. This value does not specify the token service provider; it specifies the entity that provided you with information about the token.

Set the value for this field to 1.

ccAuthService (R)

String (1)

paymentNetworkToken_requestorID

Value that identifies your business and indicates that the cardholder’s account number is tokenized. This value is assigned by the token service provider and is unique within the token service provider’s database.

 

ccAuthService (R)

String (1)

paymentSolution

Identifies Chase Pay as the payment solution that is being used for the transaction:

Set the value for this field to 007.

Note  This unique ID differentiates digital solution transactions within the CyberSource platform for reporting purposes.

ccAuthService (R)

String (3)

purchaseTotals_currency

Currency used for the order: Value: USD

ccAuthService (R)

String (5)

purchaseTotals_grandTotalAmount

Grand total for the transaction. This value cannot be negative. You can include a decimal point (.), but you cannot include any other special characters. CyberSource truncates the amount to the correct number of decimal places.

 

ccAuthService (R)

String (15)