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 thebillTo_countryfield value isUSorCA.
- invoiceHeader_merchantDescriptorCountry
- For Meeza transactions, this value must be set toEGif Egypt was not set as the country in the merchant configuration during merchant onboarding.
- payerAuthEnrollService_ merchantCountrycode
- For Meeza transactions, this value must be set toEGif 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
Required Fields for Setting Up Device Data Collection with
a Tokenized Card
These fields are the minimum fields required when you request the Payer Authentication Setup
service while using a tokenized card. Other fields that are required during Setup
service are listed in Required Fields
for Collecting Device Data.
Required Fields
- card_accountNumber
- card_cardType
- paymentNetworkToken_transactionType
- token_expirationMonth
- token_expirationYear