On This Page
Checking Enrollment When Using a Flex Microform Token
Running the Check Enrollment 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
use case, a Flex Microform token is used instead of the payment card data. Flex
Microform tokens are only valid for 15 minutes.
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 boarding.
- payerAuthEnrollService_ merchantCountrycode
- For Meeza transactions, this value must be set toEGif Egypt was not set as the country in the merchant configuration during merchant boarding.
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 Checking Enrollment When Using a Flex
Microform Token
These fields are the minimum fields required for verifying that a customer is
enrolled in a payer authentication program while using a Flex Microform token. It
doesn't matter if the enrollment check is frictionless or results in a challenge,
the same fields are required in the request. The fields in the response will
differ.
Required Fields
- billTo_city
- billTo_country
- This field is required for the US and Canada.
- billTo_email
- billTo_firstName
- billTo_httpBrowserScreenHeight
- billTo_httpBrowserScreenWidth
- billTo_ipAddress
- billTo_lastName
- billTo_postalCode
- This field is required for the US and Canada.
- billTo_state
- This field is required for the US and Canada.
- billTo_street1
- card_cardType
- card_expirationMonth
- This field is required whencard_accountNumberis included.
- card_expirationYear
- This field is required whencard_accountNumberis included.
- payerAuthEnrollService_referenceID
- payerAuthEnrollService_returnURL
- payerAuthEnrollService_run
- This field is required (when available) unless market or regional mandate restricts sending this information.
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- This field is optional when you use theitem_#_unitPricefield.