Authentication with Tokenized Cards

Setting Up Device Data Collection with a Tokenized Card

Running the Setup service identifies the customer's bank and prepares for collecting data about the device that the customer is using to place the order. In this instance, a tokenized card is used instead of the payment card data.

Card-Specific Requirements

Some payment cards require specific information to be collected during a transaction.

card_cardType: This field is required when the card type is Cartes Bancaires, JCB, UnionPay International, or Meeza.

Country-Specific Requirements

These fields are required for transactions in specific countries.

billTo_state: This field is required for transactions in the US, Canada, and Mainland China.
billTo_postalCode: This field is required when the
billTo_country
field value is
US
or
CA
.
invoiceHeader_merchantDescriptorCountry: For Meeza transactions, this value must be set to
EG
if Egypt was not set as the country in the merchant configuration during merchant onboarding.
payerAuthEnrollService_ merchantCountrycode: For Meeza transactions, this value must be set to
EG
if Egypt was not set as the country in the merchant configuration during merchant onboarding.

Endpoint

Set the

payerAuthSetupService_run

field to

true

Send the request to:

Production:

https://ics2ws.ic3.com/commerce/1.x/transactionProcessor

Test:

https://ics2wstest.ic3.com/commerce/1.x/transactionProcessor

Authentication with Tokenized Cards

Checking Enrollment with a Tokenized Card

Running the Check Enrollment service identifies the customer's bank and collects data about the device that the customer is using to place the order. This instance demonstrates this process with a tokenized card.

Card-Specific Requirements

Some payment cards require additional information to be collected during a transaction.

card_cardType: This field is required when the card type is Cartes Bancaires, JCB, UPI, or Meeza.
payerAuthEnrollService_defaultCard: This field is recommended for Discover ProtectBuy.
payerAuthEnrollService_MCC: This field is required when the card type is Cartes Bancaires.
payerAuthEnrollService_merchantName: This field is required for Visa Secure travel.
payerAuthEnrollService_productCode: This field is required for American Express SafeKey (US) when the product code is
Airlinepurchase
(AIR).
: shipTo_city; This field is required only for American Express SafeKey (US).
shipTo_country: This field is required only for American Express SafeKey (US).
shipTo_postalCode: This field is required for American Express SafeKey (US).
shipTo_street1: This field is required only for American Express SafeKey (US).

: shipTo_street2; This field is required only for American Express SafeKey (US.)

Country-Specific Requirements

These fields are required for transactions in specific countries.

payerAuthEnrollService_merchantScore: This field is required for transactions processed in France.
payerAuthEnrollService_ merchantCountrycode: For Meeza transactions, this value must be set to
EG
when Egypt is not set as the country in the merchant configuration during onboarding.
invoiceHeader_merchantDescriptorCountry: For Meeza transactions, this value must be set to
EG
when Egypt is not set as the country in the merchant configuration during merchant onboarding.
billTo_state: This field is required for transactions in the US and Canada.
billTo_city: This field is required for transactions in the US and Canada.
billTo_postalCode: This field is required when the
billTo_country
field value is
US
or
CA
.

shipTo_county: This field is required when the
shipTo_country
field value is
CA
or
US
.

shipTo_postalCode: This field is required when the
shipTo_country
field value is
US
or
CA
.

Endpoint

Set the

ccAuthService_run

field to

true

Send the request to:

Production:

https://ics2ws.ic3.com/commerce/1.x/transactionProcessor

Test:

https://ics2wstest.ic3.com/commerce/1.x/transactionProcessor

Authentication with Tokenized Cards