On This Page
Simple Order API | Visa Platform Connect

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.
When using relaxed requirements for address data and the expiration date, 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 Credit Card Transactions.
billTo_city
billTo_country
billTo_email
billTo_firstName
billTo_lastName
billTo_postalCode
billTo_state
billTo_street1
card_accountNumber
card_expirationMonth
card_expirationYear
ccAuthService_run
Set the value to
true
.
ccAuthService_cavv
ccAuthService_commerceIndicator
Set this field to one of these values:
  • aesk
    : Successful authentication (3‑D Secure value of
    05
    ).
  • aesk_attempted
    : Authentication was attempted (3‑D Secure value of
    06
    ).
  • internet
    : Authentication failed or was not attempted (3‑D Secure value of
    07
    ).
ccAuthService_eciRaw
Required when the payer authentication validation service returns a raw ECI value.
merchantID
merchantReferenceCode
purchaseTotals_currency
purchaseTotals_grandTotalAmount
Either
purchaseTotals_grandTotalAmount
 or
item_#_unitPrice
 must be included in the request.
transactionMode
Required only for merchants in Saudi Arabia.