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.
This field is required for each leg.
The numbered element name should contain 0 instead of #. Payer Authentication services only use the first leg of the trip.
This field is required for each leg.
airlineData_numberOfPassengers
billTo_customerAccountChangeDate
billTo_customerAccountCreateDate
billTo_customerAccountPasswordChange Date
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.
pa_otpToken
This field is only used with mada cards.
This field is recommended for Discover ProtectBuy.
payerAuthEnrollService_addCardAttempts
This field is recommended for Discover ProtectBuy.
This field is required for Standard integration.
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 liability shifts down the payment chain. Unless you are very familiar with the various types of authentication, do not change the default settings before consulting with customer support.
This field is required when tokenization is enabled in the merchant profile settings.
This field is recommended for Discover ProtectBuy.
This field is recommended for Discover ProtectBuy.
This field is required when the merchant and cardholder have agreed to installment payments.
This field is recommended for Discover ProtectBuy.
This field is recommended for Discover ProtectBuy.
This field is required when the card type is Cartes Bancaires.
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.
This field is required for Visa Secure travel.
This field is required for transactions processed in France.
payerAuthEnrollService_paymentAccount Date
This field is recommended for Discover ProtectBuy.
This field is required for American Express SafeKey (U.S.) when the product code is AIR (Airline purchase).
This field is required for recurring transactions.
This field is required for recurring transactions.
This field is required for recurring transactions.
This field is required for Hybrid or Cardinal Cruise Direct Connection API integration.
EMV 3-D Secure version 2.1.0 supports values
01
-
05
. Version 2.2.0 supports values
01
-
11
.
This field is required for 3-D Secure 2.x.
This field is recommended for Discover ProtectBuy.
payerAuthEnrollService_transactionCount Day
This field is recommended for Discover ProtectBuy.
payerAuthEnrollService_transactionCount Year
This field is recommended for Discover ProtectBuy.
payerAuthEnrollService_whiteListStatus
This field is required when any shipping address information is included. Required for American Express SafeKey (US).
This field is required only for American Express SafeKey (US).
This field is required when the
bill_country
 field value is
US
 or
CA
.
This field is required when the
shipTo_country
 field value is
US
 or
CA
. Required for American Express SafeKey (U.S.).
This field is required only for American Express SafeKey (US).
This field is required when the
shipTo_country
 field value is
CA
,
US
, or
Mainland China
. Required for American Express SafeKey (U.S.).
This field is required when any shipping address information is included. Required for American Express SafeKey (US).
This field is required only for American Express SafeKey (US).
This field is required for American Express SafeKey (US).