On This Page
Simple Order API
Requesting the Validation Service
For enrolled cards, the next step is to request the validation service. When you make the
validation request, you must:
- Send thepayerAuthValidateService_authenticationTransactionIDrequest field
- Send the credit card information including the PAN, currency, and expiration date (month and year).
The response that you receive contains the validation result.
You should request the payer authentication and card authorization services at the same
time. Requesting both services simultaneously ensures that the correct information is
automatically sent to your payment processor and the values of these fields are
converted to the proper format required by your payment processor:
- E-commerce indicator:payerAuthEnrollReply_commerceIndicator
- CAVV:payerAuthValidateReply_cavv
- AAV:payerAuthValidateReply_ucafAuthenticationData
- XID:payerAuthEnrollReply_xidandpayerAuthValidateReply_xid
If you request the services separately, manually include the validation result values
(Validation Check response fields) in the authorization service request (Card
Authorization request fields). To receive liability shift protection, ensure that you
pass all pertinent data for the card type and processor in your request. Failure to do
so may invalidate your liability shift for that transaction. Include the electronic
commerce indicator (ECI), the transaction ID (XID), the 3-D Secure version, the
directory server transaction ID, and the following card-specific information in your
authorization request:
- For Visa, American Express, JCB, Diners Club, Discover, China UnionPay, and Elo include the CAVV (cardholder authentication verification value).
- For Mastercard, include the UCAF (universal cardholder authentication field) and the collection indicator.
This table lists these fields.
Identifier | Validation Check Response Field | Card Authorization Request Field |
---|---|---|
E-commerce
indicator | payerAuthValidateReply_com merceIndicator | ccAuthService_commerceIn dicator |
Collection indicator (Mastercard only) | payerAuthValidateReply_uc
afCollectionIndicator | ucaf_collectionIndicator |
CAVV (Visa and American
Express only) | payerAuthValidateReply_ cavv | ccAuthService_cavv |
(Mastercard only.
Known as UCAF) | payerAuthValidateReply_uc
afAuthenticationData | ucaf_authenticationData |
XID | payerAuthValidateReply_xid | ccAuthService_xid |
3-D Secure version | payerAuthValidateReply_sp ecificationVersion
| ccAuthService_paSpecificat ionVersion |
Directory server transaction ID (Not required for 3-D Secure 1.0.) | payerAuthValidateReply_dir
ectoryServerTransactionID | ccAuthService_directorySer
verTransactionID |