On This Page
Simple Order API
Request Fields
The
payerAuthEnrollService_referenceID
field is mapped from the payerAuthSetupReply_referenceID
field as discussed in Step 1: Payer Authentication Setup Service.payerAuthEnrollService_returnURL
is set to the URL where the issuing bank will redirect the
customer as discussed in Step 4: Step-Up IFrame.To request the Payer Authentication Check Enrollment service, you must send either the
customer’s card number, encrypted payment data, transient token, or a TMS token or
transient token or some other equivalent of card data used by your integration. The
request fields may include any of these:
- card_accountNumber
- encryptedPayment_data
- encryptedPayment_descriptor
- recurringSubscriptionInfo_subscriptionID
- tokenSource_transientToken
These fields are required (merchant ID is in the header):
- billTo_city
- billTo_country
- billTo_email
- billTo_firstName
- billTo_lastName
- billTo_postalCode
- billTo_state
- billTo_street1
- card_cardType
- card_expirationMonth
- card_expirationYear
- merchantID
- merchantReference Code
- payerAuthEnrollService_referenceID
- payerAuthEnrollService_returnURL
- payerAuthEnrollService_run
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
You can send additional request data to reduce your issuer step-up authentication rates.
Send all available fields. As a backup, if device data collection fails, it is a good
idea to include the 11 device information fields listed among the optional fields for
the Check Enrollment service in your request. If a failure does occur, adding these
device information fields ensures a transaction is not downgraded to 3-D Secure 1.0. If
you do not have data for a field, do not send dummy data.
The size of the step-up iframe discussed in Step 4: Step-Up IFrame can vary depending on the 3-D Secure version of the transaction (1.0 or 2.x). You can
send the size of the challenge window in the
payerAuthEnrollService_acsWindowSize
request field. Requesting a specific window size does not guarantee this size. Parsing the PAReq as
described in Step 4: Step-Up IFrame determines the actual
size.
For further details on individual API fields, refer to the . The field values should
use the ISO 3166-2 format.