Submit a Request to the 3D Secure ACS Server and Retrieve a PaRes

If the enrollment check indicates that the card is enabled for 3D Secure, you can then redirect the cardholder to their card issuer's ACS server to retrieve a payment authentication response (PaRes). This phase must be handled by your merchant system. A brief overview is provided here; for more details, consult the Verified by Visa and Mastercard SecureCode documentation available from the respective web sites.

Example Request Form Posted to ACS Server
<form action="https://vbv.issueracs.com/3ds/acsendpoint?foo=bar" method="POST">
<input type="hidden" name="PaReq" value="eJxVUslOwzAQ/ZWIe2MndrZqaqkFBEiA2NRyq1xnRKMSJzhO0/49dhcW+TJvlueZNwNva4N49YqqNyjgAbtOfmBQlZMLs9nTkIbRsmrqUWuacjR0I8qWEU8LzjJO02VcxEm6zPPoQsDT9AW/BGzRdFWjReRKYyBn6JiNWkttBUj1Nbt7FJwmaZIBOUGo0dxdiSSmjPGE5ol7aQrk6AYtaxTXnZItBm9rDF4atQluejS6wz0COcRBNb22Zi/y2FWeAfTmU6ytbbsxIcMwhBrtSupdqJraJRkkqLdh+wnEJwL57fSp91bniHdVKeSisPfvs/0qfrYle7DscTGf55vVbJhOgPgMKKVFEdMopVmcBLQYUzb2rRz8IGvfkVeGurGPAFr/x/QU8YG/DnBbMajVeaIzAty1jUaX4ST+sYH8Nnx564VW1kuaRUURJQXjlGeMcy/5IeBZKidQlNEjjQdAfCk5bZOcDsJZ/w7lG2iWuLM=">
<input type="hidden" name="TermUrl" value="https://www.test.paysafe.com/cgi-bin/echo">
<input type="hidden" name="MD" value="MkRYRFA3UkE5TktOUzhZWjZD">
<input type="submit" value="go">
</form>

From the Enrollment Lookup request, you will need to map the 3D Secure API field names to the 3D Secure field names, and provide your own TermUrl and MD fields.

Form Field

Type

Required?

Description

N/A String Yes The URL of the card issuer's ACS server: the acsURL from the Enrollment Lookup request response. This is the URL in the <form> opening element, to which the other parameters within the form are POSTed.
PaReq String Yes This is the paReq (note capitalization) from the Enrollment Lookup request response, containing zipped Base64-encoded data about the transaction, received from the Visa/Mastercard directory servers.
TermUrl String Yes This is the URL your customer will be returned to at the end of the 3D Secure authentication process.
MD String No Your merchant data, which will be posted back to your TermUrl at the end of the 3D Secure authentication process.

In a test enrollment lookup, the response acsURL field contains a link to the Test ACS 3D Secure Simulator. For more information on using the Simulator, see Testing Instructions.

After 3DS authentication has taken place, the ACS server will POST a response back to your TermUrl URL using Content-Type: application/x-www-form-urlencoded, and containing the following key/value pairs.

Key Required? Type Description Example Value
MD No String The merchant data that was optionally POSTed to the 3D Secure ACS server. In most implementations, you will need to use the session data passed back in this field to reconnect the browser session back to the customer. MkRYRFA3UkE5TktOUzhZWjZD
PaRes Yes String The payment authentication response. An encoded string, similar to the paReq but usually longer. You need to pass this string back to the 3D Secure API in an Authentications request. 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
TermURL Yes String The TermUrl from the original POST. https://www.test.paysafe.com/cgi-bin/echo

Constraints on these fields are undocumented and can vary based on the ACS implementation. Data sizes can exceed 64kb for the PaRes result in some instances.

Did you find this page useful?