Request Fields

Unless otherwise noted, all fields are order and case insensitive, and the fields accept special characters such as @, #, and %.

Table 1Request Fields

Field

Description

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

Data Type (Length)

card_type

Type of card to authorize. Value: 001 for Visa.

ics_auth (O)

String (3)

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.

ics_auth (R)

String (40)

currency

Currency used for the order: USD.

ics_auth (R)

String (5)

customer_cc_cv_number

CVN.

ics_auth (O)

Nonnegative integer (4)

customer_cc_expmo

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

Format: MM.

Possible values: 01 through 12.

ics_auth (R)

String (2)

customer_cc_expyr

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

ics_auth (R)

Nonnegative integer (4)

customer_cc_number

The payment network token value.

Populate this field with the decrypted DPAN value.

ics_auth (R)

Nonnegative integer (20)

e_commerce_indicator

For a payment network token transaction.

Value: internet for the Visa card type.

ics_auth (O)

String (20)

grand_total_amount

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.

 

ics_auth (R)

Decimal (15)

ics_applications

CyberSource services to process for the request:

ics_auth

ics_auth (R)

String (255)

merchant_id

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

 

ics_auth (R)

String (30)

merchant_ref_number

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 SCMP API.

 

ics_auth (R)

String (50)

payment_network_token_transaction_type

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.

ics_auth (R)

String (1)

payment_solution

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

Set the value for this field to 007.

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

ics_auth (R)

String (3)

payment_network_requestor_id

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.

 

ics_auth (R)

Integer (11)

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.

ics_auth (R)

String (40)