Required Fields for Processing an Authorization Using American Express SafeKey
These fields must be included in a request for an authorization with American SafeKey. The
values for these fields are in the response from the payer authentication validate service.
When you request the payer authentication validate and authorization services together, the
data is automatically passed from one service to the other.
IMPORTANT
When relaxed requirements for address data and the expiration date are being used, not all fields
in this list are required. It is your responsibility to determine whether your
account is enabled to use this feature and which fields are required. For details
about relaxed requirements, see Relaxed Requirements for Address Data and Expiration Date in Payment Transactions.
- clientReferenceInformation.code
- consumerAuthenticationInformation.cavv
- consumerAuthenticationInformation.eciRaw
- Required when the payer authentication validation service returns a raw unmapped ECI value.
- orderInformation.amountDetails.currency
- orderInformation.amountDetails.totalAmount
- orderInformation.billTo.address1
- orderInformation.billTo.administrativeArea
- orderInformation.billTo.country
- orderInformation.billTo.email
- orderInformation.billTo.firstName
- orderInformation.billTo.lastName
- orderInformation.billTo.locality
- orderInformation.billTo.postalCode
- paymentInformation.card.expirationMonth
- paymentInformation.card.expirationYear
- paymentInformation.card.number
- paymentInformation.card.type
- processingInformation.commerceIndicator
- Set this field to one of these values:
- aesk: Successful authentication (3-D Secure value of05).
- aesk_attempted: Authentication was attempted (3-D Secure value of06).
- internet: Authentication failed or was not attempted (3-D Secure value of07).