On This Page
Optional Fields for Checking Enrollment in Payer
Authentication
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
- This field is required for each leg.
- airlineData_leg_#_departureDate
- The numbered element name should contain 0 instead of #. Payer Authentication services only use the first leg of the trip.
- airlineData_leg_#_destination
- This field is required for each leg.
- airlineData_leg_#_originatingAirportCode
- airlineData_passenger_#_firstName
- airlineData_passenger_#_lastName
- billTo_customerAccountChangeDate
- billTo_customerAccountCreateDate
- billTo_customerAccountPasswordChange Date
- billTo_passportCountry
- billTo_passportNumber
- acquirerInformation.bin
- billTo_street2
- billTo_street3
- card_accountNumber
- card_cardType
- card_cvNumber
- ccAuthService_paChallengeCode
- encryptedPayment_data
- item_#_passengerFirstName
- item_#_passengerLastName
- item_#_productDescription
- item_#_productName
- item_#_productSKU
- item_#_quantity
- item_#_shippingAddress1
- item_#_shippingAddress2
- item_#_shippingCity
- item_#_shippingCountryCode
- item_#_shippingDestinationTypes
- item_#_shippingFirstName
- item_#_shippingLastName
- item_#_shippingMiddleName
- item_#_shippingPhone
- item_#_shippingPostalCode
- item_#_shippingState
- item_#_totalAmount
- item_#_unitPrice
- merchantDefinedData_mddField_1tomerchantDefinedData_mddField_5
- These fields override the old merchant-defined data fields. For example, when you use the obsolete fieldmerchantDefinedData_field5and the new fieldmerchantDefinedData_mddField_5in 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
- pa_otpToken
- payerAuthEnrollReply_authenticationBrand
- This field is only used with mada cards.
- payerAuthEnrollReply_authorizationPayload
- payerAuthEnrollService_accountPurchases
- This field is recommended for Discover ProtectBuy.
- payerAuthEnrollService_acquirerCountry
- payerAuthEnrollService_acsWindowSize
- payerAuthEnrollService_addCardAttempts
- This field is recommended for Discover ProtectBuy.
- payerAuthEnrollService_alternateAuthent icationData
- payerAuthEnrollService_alternateAuthenticationDate
- payerAuthEnrollService_alternateAuthenticationMethod
- payerAuthEnrollService_authenticationIndicator
- payerAuthEnrollService_authenticationTransactionID
- This field is required for Standard integration.
- payerAuthEnrollService_challengeCode
- This field defaults to01on your account but is overridden by the merchant when you include this field. EMV 3-D Secure version 2.1.0 supports values01-04. Version 2.2.0 supports values01-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
- This field is required when tokenization is enabled in the merchant profile settings.
- payerAuthEnrollService_decoupled_AuthenticationMaxTime
- payerAuthEnrollService_decoupledAuthenticationIndicator
- payerAuthEnrollService_defaultCard
- This field is recommended for Discover ProtectBuy.
- payerAuthEnrollService_fraudActivity
- This field is recommended for Discover ProtectBuy.
- payerAuthEnrollService_giftCardAmount
- payerAuthEnrollService_giftCardCount
- payerAuthEnrollService_giftCardCurrency
- payerAuthEnrollService_installmentTotalCount
- This field is required when the merchant and cardholder have agreed to installment payments.
- payerAuthEnrollService_marketingOptIn
- This field is recommended for Discover ProtectBuy.
- payerAuthEnrollService_marketingSource
- This field is recommended for Discover ProtectBuy.
- payerAuthEnrollService_MCC
- This field is required when the card type is Cartes Bancaires.
- payerAuthEnrollService_merchantFraudRate
- payerAuthEnrollService_merchantID
- 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
- This field is required for Visa Secure travel.
- payerAuthEnrollService_merchantNewCustomer
- payerAuthEnrollService_merchantScore
- This field is required for transactions processed in France.
- payerAuthEnrollService_merchantURL
- payerAuthEnrollService_messageCategory
- payerAuthEnrollService_overridePay mentMethod
- payerAuthEnrollService_paymentAccountDatepayerAuthEnrollService_paymentAccountDate
- This field is recommended for Discover ProtectBuy.
- payerAuthEnrollService_preorder
- payerAuthEnrollService_preorderDate
- payerAuthEnrollService_priorAuthenticationData
- payerAuthEnrollService_priorAuthenticationMethod
- payerAuthEnrollService_priorAuthenticationReferenceID
- payerAuthEnrollService_priorAuthenticationTime
- payerAuthEnrollService_productCode
- This field is required for American Express SafeKey (U.S.) when the product code is AIR (Airline purchase).
- payerAuthEnrollService_recurringEndDate
- This field is required for recurring transactions.
- payerAuthEnrollService_recurringFrequency
- This field is required for recurring transactions.
- payerAuthEnrollService_recurringOriginal PurchaseDate
- This field is required for recurring transactions.
- payerAuthEnrollService_referenceID
- This field is required for Hybrid or Cardinal Cruise Direct Connection API integration.
- payerAuthEnrollService_reorder
- payerAuthEnrollService_requestorInitiatedAuthenticationIndicator
- EMV 3-D Secure version 2.1.0 supports values01-05. Version 2.2.0 supports values01-11.
- payerAuthEnrollService_requestorName
- payerAuthEnrollService_returnURL
- payerAuthEnrollService_scoreRequest
- payerAuthEnrollService_sdkMaxTimeout
- This field is required for 3-D Secure 2.x.
- payerAuthEnrollService_secureCorporatePaymentIndicator
- payerAuthEnrollService_shipAddressUsageDate
- This field is recommended for Discover ProtectBuy.
- payerAuthEnrollService_totalOffersCount
- payerAuthEnrollService_transactionCountDaypayerAuthEnrollService_transactionCountDay
- This field is recommended for Discover ProtectBuy.
- payerAuthEnrollService_transactionCountYearpayerAuthEnrollService_transactionCountYear
- This field is recommended for Discover ProtectBuy.
- payerAuthEnrollService_transactionMode
- payerAuthEnrollService_whiteListStatuspayerAuthEnrollService_whiteListStatus
- paymentNetworkToken_transactionType
- requestID
- shipTo_city
- This field is required when any shipping address information is included. Required for American Express SafeKey (US).
- shipTo_country
- This field is required only for American Express SafeKey (US).
- shipTo_destinationCode
- shipTo_destinationTypes
- This field is required when thebill_countryfield value isUSorCA.
- shipTo_firstName
- shipTo_lastName
- shipTo_middleName
- shipTo_phoneNumber
- shipTo_postalCode
- This field is required when theshipTo_countryfield value isUSorCA. Required for American Express SafeKey (U.S.).
- shipTo_shippingMethod
- This field is required only for American Express SafeKey (US).
- shipTo_state
- This field is required when theshipTo_countryfield value isCA,US, orMainland China. Required for American Express SafeKey (U.S.).
- shipTo_street1
- This field is required when any shipping address information is included. Required for American Express SafeKey (US).
- shipTo_street2
- This field is required only for American Express SafeKey (US).
- >shipTo_street3
- This field is required for American Express SafeKey (US).