Initiating a 3DS Method

When calling the transaction creation service, the three_ds_method_url field can be returned. This indicates that an invisible frame must be rendered on the cardholder's screen pointing to this URL. To do this, it's necessary to make an HTTP POST in the application/x-www-form-urlencoded format passing the threeDSMethodData field, which is a Base64 encoded JSON.

threeDSMethodData object parameters

Parameter	Description	Format	Mandatory
threeDSMethodNotificationURL	The URL that will receive the notification of 3DS Method completion from the ACS.	< 256 AN	YES
threeDSServerTransID	3DS Server transaction ID.	= 36 AN	YES

Examples

threeDSMethodData JSON:

{
   "threeDSServerTransID":"12341234-1234-1234-1234-123412341234",
   "threeDSMethodNotificationURL":"threeDSMethodNotificationURL"
}

threeDSMethodData Base64:

ewogICAidGhyZWVEU1NlcnZlclRyYW5zSUQiOiIxMjM0MTIzNC0xMjM0LTEyMzQtMTIzNC0xMjM0MTIzNDEyMzQiLAogICAidGhyZWVEU01ldGhvZE5vdGlmaWNhdGlvblVSTCI6InRocmVlRFNNZXRob2ROb3RpZmljYXRpb25VUkwiCn0=

HTML form:

<form name="frm" method="POST" action="Rendering URL">
    <input type="hidden" name="threeDSMethodData" value="ewogICAidGhyZWVEU1NlcnZlclRyYW5zSUQiOiIxMjM0MTIzNC0xMjM0LTEyMzQtMTIzNC0xMjM0MTIzNDEyMzQiLAogICAidGhyZWVEU01ldGhvZE5vdGlmaWNhdGlvblVSTCI6InRocmVlRFNNZXRob2ROb3RpZmljYXRpb25VUkwiCn0=">
</form>

3DS Method notification

This call will be performed by the ACS on the URL informed by the 3DS Requestor (threeDSMethodNotificationURL field) using the same format of the form described above. This call is important for sending the three_ds_comp_ind field on the authentication service.