On This Page {#jumplink-list} [Markdown](/docs/vas/en-us/payer-authentication/developer/all/rest/payer-auth/pa2-use-tokens-tokenized-cards/pa2-use-enroll-token-tokenized-intro.md) Filter FILTER BY TAG Checking Enrollment with a Network Token/Tokenized Card {#pa2-use-enroll-token-tokenized-intro} =============================================================================================== 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 network token/tokenized card. Card-Specific Requirements -------------------------- Some payment cards require additional information to be collected during a transaction. [consumerAuthenticationInformation. defaultCard](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/cons-auth-info-aa/cons-auth-info-default-card.md "") : This field is recommended for Discover ProtectBuy. [consumerAuthenticationInformation.mcc](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/cons-auth-info-aa/cons-auth-info-mcc.md "") : This field is required when the card type is Cartes Bancaires. [consumerAuthenticationInformation. productCode](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/cons-auth-info-aa/cons-auth-info-product-code.md "") : This field is required for American Express SafeKey (US) when the product code is `AIR` for an airline purchase. [merchantInformation.merchantDescriptor. name](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/merch-info-aa/merch-info-merchant-descriptor-name.md "") : This field is required for Visa Secure travel. [orderInformation.shipTo.addess1](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-shipto-address1.md "") : This field is required only for American Express SafeKey (US). {#pa2-use-enroll-token-tokenized-intro_dl_d1v_trz_rxb} [orderInformation.shipTo.address2](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-shipto-address2.md "") : This field is required only for American Express SafeKey (US.) [orderInformation.shipTo.administrativeArea](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-shipto-administrative-area.md "") : This field is required only for American Express SafeKey (US). [orderInformation.shipTo.country](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-shipto-country.md "") : This field is required only for American Express SafeKey (US). [orderInformation.shipTo.postalCode](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-shipto-postal-code.md "") : This field is required for American Express SafeKey (US). [paymentInformation.card.type](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-card-type.md "") : This field is required when the card type is JCB, Cartes Bancaires, China UnionPay, or Meeza. Country-Specific Requirements ----------------------------- These fields are required for transactions in specific countries. [consumerAuthenticationInformation. merchantScore](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/cons-auth-info-aa/cons-auth-info-merchant-score.md "") : This field is required for transactions processed in France. [consumerAuthenticationInformation. overrideCountryCode](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/cons-auth-info-aa/cons-auth-info-override-country-code.md "") : For Meeza transactions, this value must be set to `EG` when Egypt is not set as the country in the merchant configuration during boarding. [merchantInformation.merchantDescriptor. country](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/merch-info-aa/merch-info-merchant-descriptor-country-a.md "") : For Meeza transactions, this value must be set to `EG` when Egypt is not set as the country in the merchant configuration during merchant boarding. [orderInformation.billTo.administrativeArea](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-admin-area.md "") : This field is required for transactions in the US and Canada. [orderinformation.billTo.locality](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-locality.md "") : This field is required for transactions in the US and Canada. [orderInformation.billTo.postalCode](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-postal-code.md "") : This field is required when the orderInformation.billTo.country field value is `US` or `CA`. {#pa2-use-enroll-token-tokenized-intro_dl_gpf_5rz_rxb} [orderInformation.shipTo.administrativeArea](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-shipto-county.md "") : This field is required when the orderInformation.shipTo.country field value is `CA` or `US`. [orderInformation.shipTo.postalCode](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-shipto-postal-code.md "") : This field is required when the orderInformation.shipTo.country field value is `US` or `CA`. Processor-Specific Requirements {#pa2-use-enroll-token-tokenized-intro_section_kl3_tbh_xwb} ------------------------------------------------------------------------------------------- These fields are required by specific processors for transactions. [processingInformation.authorizationOptions. transactionMode](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-auth-ops-transaction-mode.md "") : This field is required only for merchants in Saudi Arabia. Endpoint -------- **Production:** `POST ``https://api.visaacceptance.com``/risk/v1/authentications` **Test:** `POST ``https://apitest.visaacceptance.com``/risk/v1/authentications` Required Fields for Checking Enrollment When Using a Network Token/Tokenized Card {#pa2-use-enroll-token-tokenized-reqd-fields} =============================================================================================================================== These fields are the minimum fields required for verifying that a customer is enrolled in a payer authentation program when using a tokenized card. Required Fields --------------- [consumerAuthenticationInformation. deviceChannel](https://developer.cybersource.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/cons-auth-info-aa/cons-auth-info-device-channel.md "") : [consumerAuthenticationInformation.referenceId](https://developer.cybersource.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/cons-auth-info-aa/cons-auth-info-reference-id.md "") : [paymentInformation.customer.customerId](https://developer.cybersource.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-customer-customer-id.md "") : [orderInformation.amountDetails.currency](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "") : [orderInformation.amountDetails.totalAmount](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "") : This field is required when the orderInformation.lineItems.unitPrice field is not used. [orderInformation.billTo.address1](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-address1.md "") : [orderInformation.billTo.address2](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-address2.md "") : [orderInformation.billTo.administrativeArea](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-admin-area.md "") : This field is required for the US and Canada. [orderInformation.billTo.country](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-country.md "") : This field is required for the US and Canada. [orderInformation.billTo.email](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-email.md "") : [orderInformation.billTo.firstName](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-first-name.md "") : [orderInformation.billTo.lastName](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-last-name.md "") : [orderinformation.billTo.locality](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-locality.md "") : [orderInformation.billTo.phoneNumber](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-postal-code.md "") : [orderInformation.billTo.postalCode](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-postal-code.md "") : [paymentInformation.tokenizedCard. expirationMonth](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-tokenized-card-exp-month.md "") : [paymentInformation.tokenizedCard. expirationYear](https://developer.cybersource.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-tokenized-card-exp-year.md "") : [paymentInformation.tokenizedCard.number](https://developer.cybersource.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-tokenized-card-num.md "") : [paymentInformation.tokenizedCard. transactionType](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-tokenized-card-txn-type.md "") : [paymentInformation.tokenizedCard.type](https://developer.visaacceptance.com/docs/vas/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-tokenized-card-type-a.md "") : REST Example: Checking Enrollment When Using a Network Token/Tokenized Card (Frictionless) {#pa2-use-token-tokenized-frictionless-rest-ex} ========================================================================================================================================== Request ``` { "orderInformation": { "amountDetails": { "currency": "USD", "totalAmount": "10.99" }, "billTo": { "address1": "1 Market St", "address2": "Address 2", "administrativeArea": "CA", "country": "US", "locality": "san francisco", "firstName": "John", "lastName": "Doe", "phoneNumber": "4158880000", "email": "test@email.com", "postalCode": "94105" } }, "paymentInformation": { "tokenizedCard": { "transactionType": "1", "type": "001", "expirationMonth": "11", "expirationYear": "2025", "number": "4111111111111111" } }, "deviceInformation": { "ipAddress": "139.130.4.5", "httpAcceptContent": "test", "httpBrowserLanguage": "en_us", "httpBrowserJavaEnabled": "N", "httpBrowserJavaScriptEnabled": "Y", "httpBrowserColorDepth": "24", "httpBrowserScreenHeight": "100000", "httpBrowserScreenWidth": "100000", "httpBrowserTimeDifference": "300", "userAgentBrowserValue": "GxKnLy8TFDUFxJP1t" }, "consumerAuthenticationInformation": { "deviceChannel": "BROWSER", "referenceId": "CybsCruiseTester-a8a8eeaf" } } ``` Response to Successful Request ``` { "clientReferenceInformation": { "code": "1725450267324" }, "consumerAuthenticationInformation": { "eciRaw": "05", "authenticationTransactionId": "o9spMK5vH7MK5lAPku60", "strongAuthentication": { "OutageExemptionIndicator": "0" }, "eci": "05", "token": "AxjzbwSTiURy4Xhjhs+lABEBTyDYGCNvSBcS0JiGTSTL0YrmYUwEwAAASAVA", "cavv": "AJkBBkhgQQAAAE4gSEJydQAAAAA=", "paresStatus": "Y", "acsReferenceNumber": "Cardinal ACS", "xid": "AJkBBkhgQQAAAE4gSEJydQAAAAA=", "directoryServerTransactionId": "51a3b89b-10c4-4718-8300-4cdc779d1434", "veresEnrolled": "Y", "threeDSServerTransactionId": "1a9c8944-6d0b-46d4-a964-5e986cff9c1b", "acsOperatorID": "MerchantACS", "ecommerceIndicator": "vbv", "specificationVersion": "2.1.0", "acsTransactionId": "b022828d-7440-4815-a5f8-28cf3f568f02" }, "id": "7254502673416960004005", "paymentInformation": { "card": { "bin": "411111", "type": "VISA" } }, "status": "AUTHENTICATION_SUCCESSFUL", "submitTimeUtc": "2024-09-04T11:44:27Z" } ``` RELATED TO THIS PAGE