Checking Enrollment in Payer Authentication {#pa2-check-enroll-use-intro} ========================================================================= The Check Enrollment service tries to authenticate the cardholder. If the cardholder can be authenticated without additional information, the transaction can be authorized. If more information is required, the cardholder will be challenged to provide additional authentication. Card-Specific Requirements {#pa2-check-enroll-use-intro_card-specific-so} ------------------------------------------------------------------------- Some payment cards require information to be collected during a transaction. [card_cardType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/card-card-type.md "") : This field is required when the card type is JCB, Cartes Bancaires, China UnionPay, or Meeza. [payerAuthEnrollService_defaultCard](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-default-card.md "") : This field is recommended for Discover ProtectBuy. [payerAuthEnrollService_MCC](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-mcc.md "") : This field is required when the card type is Cartes Bancaires. [payerAuthEnrollService_merchantName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-merchant-name.md "") : This field is required for Visa Secure travel. [payerAuthEnrollService_productCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-product-code.md "") : This field is required for American Express SafeKey (U.S.) when the product code is `AIR` for an airline purchase. [shipTo_city](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-county.md "") : This field is required only for American Express SafeKey (US). [shipTo_country](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-country.md "") : This field is required only for American Express SafeKey (US). [shipTo_postalCode\>](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-postal-code.md "") : This field is required for American Express SafeKey (US). [shipTo_street1](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-street1.md "") : This field is required only for American Express SafeKey (US). {#pa2-check-enroll-use-intro_dl_db} [shipTo_street2](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-street2.md "") : This field is required only for American Express SafeKey (US.) {#pa2-check-enroll-use-intro_dl_j2p_r31_xbc} Country-Specific Requirements {#pa2-check-enroll-use-intro_country-specific} ---------------------------------------------------------------------------- These fields are required for transactions in specific countries. [payerAuthEnrollService_merchantScore](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-merchant-score.md "") : This field is required for transactions processed in France. [payerAuthEnrollService_ merchantCountrycode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-merchant-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 merchant boarding. [invoiceHeader_ merchantDescriptorCountry](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-state.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. [billTo_state](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-state.md "") : This field is required for transactions in the US and Canada. [billTo_city](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-city.md "") : This field is required for transactions in the US and Canada. [billTo_postalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-postal-code.md "") : This field is required when the billTo_country field value is `US` or `CA`. {#pa2-check-enroll-use-intro_dl_gpf_5rz_rxb} [shipTo_county](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-county.md "") : This field is required when the shipTo_country field value is `CA`, `US`, or `China`. [shipTo_postalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-postal-code.md "") : This field is required when the shipTo_country field value is `US` or `CA`. Processor-Specific Requirements {#pa2-check-enroll-use-intro_processor-specific} -------------------------------------------------------------------------------- These fields are required by specific processors for transactions. [transactionMode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/transaction-mode.md "") : This field is required only for merchants in Saudi Arabia. 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` Required Fields for Checking Enrollment in Payer Authentication {#pa-use-check-enroll-reqd-fields} ================================================================================================== These fields are the minimum fields required for verifying that a customer is enrolled in a payer authentation program. Under certain circumstances, a field that normally is optional might be required. The circumstance that makes an optional field required is noted. Required Fields --------------- [billTo_city](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-city.md "") : [billTo_country](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-country.md "") : This field is required for transactions in the US and Canada. [billTo_email](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-email.md "") : [billTo_firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-first-name.md "") : [billTo_httpBrowserColorDepth](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-http-browser-color-depth.md "") : [billTo_httpBrowserJavaEnabled](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-http-browser-java-enabled.md "") : [billTo_httpBrowserJavaScriptEnabled](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-http-browser-java-script-enabled.md "") : [billTo_httpBrowserLanguage](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-http-browser-language.md "") : [billTo_httpBrowserScreenHeight](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-http-browser-screen-height.md "") : [billTo_httpBrowserScreenWidth](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-http-browser-screen-width.md "") : [billTo_httpBrowserTimeDifference](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-http-browser-time-diff.md "") : [billTo_ipAddress](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-ip-address.md "") : [billTo_lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-last-name.md "") : [billTo_phoneNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-phone-number.md "") : This field is required if payerAuthEnrollService_mobilePhone or billTo_workNumber is not used. [billTo_postalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-postal-code.md "") : This field is required for transactions in the US and Canada. [billTo_state](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-state.md "") : This field is required for transactions in the US and Canada. [billTo_street1](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-street1.md "") : : [card_accountNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/card-account-number.md "") : : [card_cardType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/card-card-type.md "") : [card_expirationMonth](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/card-expiration-month.md "") : This field is required when card_accountNumber is included. [card_expirationYear](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/card-expiration-year.md "") : This field is required when card_accountNumber is included. [invoiceHeader_merchantDescriptorCountry](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/invoice-header-merchant-descriptor-country.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. [merchantReferenceCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/merchant-reference-code.md "") : [payerAuthEnrollService_deviceChannel](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-device-channel.md "") : This field is required for SDK integration. When you use the SDK integration, this field is dynamically set to `SDK`. When you use the JavaScript code, this field is dynamically set to `Browser`. For merchant-initiated or 3RI transactions, you must set the field to `3RI`. When you use this field in addition to JavaScript code, you must set the field to `Browser`. [payerAuthEnrollService_httpAccept](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-http-accept.md "") : When the customer's browser provides a value, include that value in your request. [payerAuthEnrollService_httpUserAccept](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-http-user-accept.md "") : [payerAuthEnrollService_httpUserAgent](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-http-user-agent.md "") : [payerAuthEnrollService_ merchantCountrycode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-merchant-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 merchant boarding. [payerAuthEnrollService_messageCategory](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-message-category.md "") : [payerAuthEnrollService_mobilePhone](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-mobile-phone.md "") : This field is required if payerAuthEnrollService_workPhone or billTo_phoneNumber is not used. [payerAuthEnrollService_referenceID](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-ref-id.md "") : [payerAuthEnrollService_returnURL](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-return-url.md "") : payerAuthEnrollService_run : This field is required (when available) unless market or regional mandate restricts sending this information. [payerAuthEnrollService_workPhone](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-work-phone.md "") : This field is required if payerAuthEnrollService_mobilePhone or billTo_phoneNumber is not used. [purchaseTotals_currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/purchase-totals-currency.md "") : [purchaseTotals_grandTotalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/purchase-totals-grand-total-amount.md "") : This field is optional when you use the item_#_unitPrice field. Optional Fields for Checking Enrollment in Payer Authentication {#pa-api-enrolling-optional-fields} =================================================================================================== These fields are usually optional when you verify enrollment for a Payer Authentication transaction. In certain circumstances, the information provided by an optional field might be required before a transaction can proceed. Those optional fields that are sometimes required are also listed as required fields with the circumstance described. [airlineData_leg_#_carrierCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/airline-data-leg-num-carrier-code.md "") : This field is required for each leg. [airlineData_leg_#_departureDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/airline-data-leg-num-departure-date.md "") : The numbered element name should contain 0 instead of #. Payer Authentication services only use the first leg of the trip. [airlineData_leg_#_destination](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/airline-data-leg-num-destination.md "") : This field is required for each leg. [airlineData_leg_#_originatingAirportCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/airline-data-leg-num-orig-airport-code.md "") : airlineData_numberOfPassengers : [airlineData_passenger_#_firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/airline-data-passenger-num-first-name.md "") : [airlineData_passenger_#_lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/airline-data-passenger-num-last-name.md "") : billTo_customerAccountChangeDate : billTo_customerAccountCreateDate : billTo_customerAccountPasswordChange Date : [billTo_passportCountry](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-passport-country.md "") : [billTo_passportNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-passport-number.md "") : [billTo_street1\*\*](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-street1.md "") : [billTo_street2](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-street2.md "") : [billTo_street3](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-street3.md "") : [card_accountNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/card-account-number.md "") : [card_cardType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/card-card-type.md "") : [card_cvNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/card-cv-number.md "") : [ccAuthService_paChallengeCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/cc-auth-service-pa-challenge-code.md "") : [encryptedPayment_data](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/encrypted-payment-data.md "") : [item_#_passengerFirstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-passenger-first-name.md "") : [item_#_passengerLastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-passenger-last-name.md "") : [item_#_productDescription](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-product-description.md "") : [item_#_productName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-product-name.md "") : [item_#_productSKU](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-product-sku.md "") : [item_#_quantity](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-quantity.md "") : [item_#_shippingAddress1](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-shipping-address1.md "") : [item_#_shippingAddress2](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-shipping-address2.md "") : [item_#_shippingCity](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-shipping-city.md "") : [item_#_shippingCountryCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-shipping-country-code.md "") : [item_#_shippingDestinationTypes](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-shipping-destination-types.md "") : [item_#_shippingFirstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-shipping-first-name.md "") : [item_#_shippingLastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-shipping-last-name.md "") : [item_#_shippingMiddleName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-shipping-middle-name.md "") : [item_#_shippingPhone](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-shipping-phone.md "") : [item_#_shippingPostalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-shipping-postal-code.md "") : [item_#_shippingState](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-shipping-state.md "") : [item_#_totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-total-amount.md "") : [item_#_unitPrice](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/item-no-unit-price.md "") : merchantDefinedData_mddField_1 to merchantDefinedData_mddField_5 : > These fields override the old merchant-defined data fields. For example, when you use the obsolete field merchantDefinedData_field5 and the new field merchantDefinedData_mddField_5 in the same request, the new field value overwrites the value specified in the obsolete field. > Merchant-defined data fields are not intended to and must not be used to capture personally identifying information. Accordingly, merchants are prohibited from capturing, obtaining, and/or transmitting any personally identifying information in or via the merchant defined data fields. Personally identifying information includes, but is not limited to, address, credit card number, Social Security number, driver's license number, state-issued identification number, passport number, and card verification numbers (CVV, CVC2, CVV2, CID, CVN). When a merchant is discovered capturing and/or transmitting personally identifying information via the merchant-defined data fields, whether intentionally or accidentally, the merchant's account is immediately suspended, resulting in a rejection of any and all transaction requests submitted by the merchant after the point of suspension. [merchantReferenceCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/merchant-reference-code.md "") : pa_otpToken : [payerAuthEnrollReply_authenticationBrand](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-reply-authentication-brand.md "") : This field is only used with mada cards. [payerAuthEnrollReply_authorizationPayload](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-reply-authorization-payload.md "") : [payerAuthEnrollService_accountPurchases](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-account-purchases.md "") : This field is recommended for Discover ProtectBuy. [payerAuthEnrollService_acquirerCountry](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-acquirer-country.md "") : [payerAuthEnrollService_acsWindowSize](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-acs-window-size.md "") : payerAuthEnrollService_addCardAttempts : This field is recommended for Discover ProtectBuy. [payerAuthEnrollService_alternateAuthenticationData](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-alternate-authentication.md "") : [payerAuthEnrollService_alternateAuthenticationDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-alternate-authenticat-0.md "") : {#pa-api-enrolling-optional-fields_dl_xj3_ygz_fcc} [payerAuthEnrollService_alternateAuthenticationMethod](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-alternate-authenticat-1.md "") : [payerAuthEnrollService_authenticationIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-auth-indicator.md "") : [payerAuthEnrollService_authentication TransactionID](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-authentication-transacti.md "") : This field is required for Standard integration. [payerAuthEnrollService_challengeCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-challenge-code.md "") : This field defaults to `01` on your account but is overridden by the merchant when you include this field. EMV 3-D Secure version 2.1.0 supports values `01`-`04`. Version 2.2.0 supports values `01`-`09`. : > Modifying this field could affect your liability shifts. Unless you are very familiar with the various types of authentication, do not change the default settings before consulting with customer support. [payerAuthEnrollService_customerCCAlias](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-customer-cc-alias.md "") : This field is required when tokenization is enabled in the merchant profile settings. [payerAuthEnrollService_decoupled_AuthenticationMaxTime](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-decoupled-authenticat-0.md "") : [payerAuthEnrollService_decoupledAuthenticationIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-decoupled-authentication.md "") : [payerAuthEnrollService_defaultCard](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-default-card.md "") : This field is recommended for Discover ProtectBuy. [payerAuthEnrollService_fraudActivity](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-fraud-activity.md "") : This field is recommended for Discover ProtectBuy. [payerAuthEnrollService_giftCardAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-gift-card-amount.md "") : [payerAuthEnrollService_giftCardCount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-gift-card-count.md "") : [payerAuthEnrollService_giftCardCurrency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-gift-card-currency.md "") : [payerAuthEnrollService_installmentTotalCount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-installment-count.md "") : This field is required when the merchant and cardholder have agreed to installment payments. [payerAuthEnrollService_marketingOptIn](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-marketing-opt-in.md "") : This field is recommended for Discover ProtectBuy. [payerAuthEnrollService_marketingSource](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-marketing-source.md "") : This field is recommended for Discover ProtectBuy. [payerAuthEnrollService_MCC](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-merchant-country-code.md "") : This field is required when the card type is Cartes Bancaires. [payerAuthEnrollService_merchantFraudRate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-merchant-fraud-rate.md "") : [payerAuthEnrollService_merchantID](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-merchant-id.md "") : This field is the merchant bank identifier, such as Paymentech's division, FDC's Terminal ID, or Vital V number. Use this field for evaluation, testing, and production. This number is not your merchant ID. [payerAuthEnrollService_merchantName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-merchant-name.md "") : This field is required for Visa Secure travel. [payerAuthEnrollService_merchantNewCustomer](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-merchant-new-customer.md "") : [payerAuthEnrollService_merchantScore](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-merchant-score.md "") : This field is required for transactions processed in France. [payerAuthEnrollService_merchantURL](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-merchant-url.md "") : [payerAuthEnrollService_messageCategory](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-message-category.md "") : [payerAuthEnrollService_overridePay mentMethod](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-override-payment-method.md "") : payerAuthEnrollService_ paymentAccountDate : This field is recommended for Discover ProtectBuy. [payerAuthEnrollService_preorder](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-preorder.md "") : [payerAuthEnrollService_preorderDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-preorder-date.md "") : [payerAuthEnrollService_priorAuthenticationData](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-prior-authentication-dat.md "") : [payerAuthEnrollService_priorAuthenticationMethod](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-prior-authentication-met.md "") : [payerAuthEnrollService_priorAuthenticationReferenceID](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-prior-authentication-ref.md "") : [payerAuthEnrollService_priorAuthenticationTime](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-prior-authentication-tim.md "") : [payerAuthEnrollService_productCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-product-code.md "") : This field is required for American Express SafeKey (U.S.) when the product code is AIR (Airline purchase). [payerAuthEnrollService_recurringEndDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-recurring-end-date.md "") : This field is required for recurring transactions. [payerAuthEnrollService_recurringFrequency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-recurring-frequency.md "") : This field is required for recurring transactions. [payerAuthEnrollService_recurringOriginal PurchaseDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-recurring-orig-purch-dat.md "") : This field is required for recurring transactions. [payerAuthEnrollService_referenceID](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-ref-id.md "") : This field is required for Hybrid or Cardinal Cruise Direct Connection API integration. [payerAuthEnrollService_reorder](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-reorder.md "") : [payerAuthEnrollService_requestorInitiated AuthenticationIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-requestor-initiated-auth.md "") : EMV 3-D Secure version 2.1.0 supports values `01`-`05`. Version 2.2.0 supports values `01`-`11`. [payerAuthEnrollService_requestorName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-requestor-name.md "") : : [payerAuthEnrollService_returnURL](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-return-url.md "") : [payerAuthEnrollService_scoreRequest](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-score-request.md "") : [payerAuthEnrollService_sdkMaxTimeout](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-sdk-max-timeout.md "") : This field is required for 3-D Secure 2.x. [payerAuthEnrollService_secureCorporatePaymentIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-secure-corporate-payment.md "") : [payerAuthEnrollService_shipAddress UsageDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-ship-addr-usage-date.md "") : This field is recommended for Discover ProtectBuy. [payerAuthEnrollService_totalOffersCount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-total-offers-count.md "") : payerAuthEnrollService_transactionCount Day : This field is recommended for Discover ProtectBuy. payerAuthEnrollService_transactionCount Year : This field is recommended for Discover ProtectBuy. [payerAuthEnrollService_transactionMode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payer-auth-enroll-service-transaction-mode.md "") : payerAuthEnrollService_whiteListStatus : [paymentNetworkToken_transactionType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/payment-network-token-transaction-type.md "") : [requestID](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/request-id.md "") : [shipTo_city](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-from-city.md "") : This field is required when any shipping address information is included. Required for American Express SafeKey (US). [shipTo_country](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-country.md "") : This field is required only for American Express SafeKey (US). [shipTo_destinationCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-destination-code.md "") : [shipTo_destinationTypes](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-destination-types.md "") : This field is required when the bill_country field value is `US` or `CA`. [shipTo_firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-first-name.md "") : [shipTo_lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-last-name.md "") : [shipTo_middleName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-middle-name.md "") : [shipTo_phoneNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-phone-number.md "") : [shipTo_postalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-postal-code.md "") : This field is required when the shipTo_country field value is `US` or `CA`. Required for American Express SafeKey (U.S.). [shipTo_shippingMethod](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-shipping-method.md "") : This field is required only for American Express SafeKey (US). [shipTo_state](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-state.md "") : This field is required when the shipTo_country field value is `CA`, `US`, or `Mainland China`. Required for American Express SafeKey (U.S.). [shipTo_street1](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-street1.md "") : This field is required when any shipping address information is included. Required for American Express SafeKey (US). [shipTo_street2](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-street2.md "") : This field is required only for American Express SafeKey (US). [shipTo_street3](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ship-to-street3.md "")\> : This field is required for American Express SafeKey (US). {#pa-api-enrolling-optional-fields_dl_bk3_ygz_fcc} Simple Order Example: Checking Enrollment {#pa2-use-check-enroll-so-ex} ======================================================================= Request ``` billTo_city=Mountain View billTo_country=US billTo_email=test@email.com billTo_firstName=Tanya billTo_lastName=Lee billTo_postalCode=94043 billTo_state=CA billTo_street1=1234 Gold Ave card_accountNumber=XXXXXXXXXXXXXXXX card_cardType=001 card_cvNumber=111 card_expirationMonth=12 card_expirationYear=2030 ccAuthService_run=true merchantID=patest merchantReferenceCode=0001 payerAuthEnrollService_referenceID=f13fe5e0-9b47-4ea1-a03a-ec360f4d0f9f payerAuthEnrollService_returnURL=https://example.com/step-up-return-url.jsp payerAuthEnrollService_run=true purchaseTotals_currency=USD purchaseTotals_grandTotalAmount=30.00 ``` Response ``` decision=REJECT merchantReferenceCode=0001 payerAuthEnrollReply_accessToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI1MDc4OTI0Mi0z YmEzLTRhZTItYWQwOS1kZjZkODk2NWQ5MjciLCJpYXQiOjE1OTgyOTk1MjQsImlzcyI6IjVkZDgzYmYwMGU0MjNk MTQ5OGRjYmFjYSIsImV4cCI6MTU5ODMwMzEyNCwiT3JnVW5pdElkIjoiNTVlZjNmMTBmNzIzYWE0MzFjOTliNWViIi wiUGF5bG9hZCI6eyJBQ1NVcmwiOiJodHRwczovLzBtZXJjaGFudGFjc3N0YWcuY2FyZGluYWxjb21tZXJjZS5jb20 vTWVyY2hhbnRBQ1NXZWIvY3JlcS5qc3AiLCJQYXlsb2FkIjoiZXlKdFpYTnpZV2RsVkhsd1pTSTZJa05TWlhFaUxDS nRaWE56WVdkbFZtVnljMmx2YmlJNklqSXVNaTR3SWl3aWRHaHlaV1ZFVTFObGNuWmxjbFJ5WVc1elNVUWlPaUkzT kRNeVlUWXdNQzA0TXpNMkxUUm1PRGN0WVdKbE9TMDJObVkzTkRFM01EaGhNV1FpTENKaFkzTlVjbUZ1YzBsRUlqb 2lPR0U1TkRkaU9ETXRNRFJpTkMwMFltVmlMV0V5WWpNdFpHTmpNV0UxWmprMFlURXlJaXdpWTJoaGJHeGxibWRsVj JsdVpHOTNVMmw2WlNJNklqQXlJbjAiLCJUcmFuc2FjdGlvbklkIjoiVEQ1b1MwbzFGQzY1cWF2MHhzeDAifS wiT2JqZWN0aWZ5UGF5bG9hZCI6dHJ1ZSwiUmV0dXJuVXJsIjoiaHR0cHM6Ly9leGFtcGxlLmNvbS9zdGVwLXV wLXJldHVybi11cmwuanNwIn0.8wZ8XhLgOIIRvgEUugvYrRAi-efavZTNM0tWInYLTfE payerAuthEnrollReply_acsTransactionID=8a947b83-04b4-4beb-a2b3-dcc1a5f94a12 payerAuthEnrollReply_acsURL=https://0merchantacsstag.cardinalcommerce.com/MerchantACSWeb/creq.jsp payerAuthEnrollReply_authenticationTransactionID=TD5oS0o1FC65qav0xsx0 payerAuthEnrollReply_cardBin=40000000 payerAuthEnrollReply_cardTypeName=VISA payerAuthEnrollReply_challengeRequired=false payerAuthEnrollReply_directoryServerTransactionID=395fb036-cfc6-462b-b28d-d6ed7c970cdd payerAuthEnrollReply_paReq=eyJtZXNzYWdlVHlwZSI6IkNSZXEiLCJtZXNzYWdlVmVyc2lvbiI6IjIuMi4wIiwidGhy ZWVEU1NlcnZlclRyYW5zSUQiOiI3NDMyYTYwMC04MzM2LTRmODctYWJlOS02NmY3NDE3MDhhMWQiLCJhY3NU cmFuc0lEIjoiOGE5NDdiODMtMDRiNC00YmViLWEyYjMtZGNjMWE1Zjk0YTEyIiwiY2hhbGxlbmdlV2luZG93U2l 6ZSI6IjAyIn0 payerAuthEnrollReply_reasonCode=475 payerAuthEnrollReply_specificationVersion=2.2.0 payerAuthEnrollReply_stepUpUrl=https://centinelapistag.cardinalcommerce.com/V2/Cruise/StepUp payerAuthEnrollReply_threeDSServerTransactionID=7432a600-8336-4f87-abe9-66f741708a1d payerAuthEnrollReply_veresEnrolled=Y reasonCode=475 requestID=5982995245816268803007 requestToken=AxjzbwSTRFa9DM1xnUu/ABEBURwlqsQ5pAy7gDtXb0kyro9JLIYA8AAA2wK2 ```