A guide to implementing 3DS v2. When this function is enabled, every REST API real-time transaction call will run through the 3-D Secure process before it processes the payment.
The real-time transaction API (POST Make a live card transaction) remains the same, except there are now two new fields that it supports which become mandatory for merchants that have 3DS v2 enabled. The new fields are “CallbackUrl” and “BrowserInfo” - see sample below:
{
"ProcessType": "COMPLETE",
"Reference": "3DS Test1",
"Description": "This is an example real-time transaction",
"Amount": 100,
"CurrencyCode": "AUD",
"CardToken": null,
"Card": {
"CardNumber": "4111111111111111",
"CardholderName": "TEST Card",
"ExpiryYear": 2023,
"ExpiryMonth": 10,
"Ccv": "123"
},
"Payer": null,
"CallbackUrl" : "https://www.integrapay.com/3ds",
"BrowserInfo" : {
"UserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.106 Safari/537.36",
"AcceptHeader": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
"Language": "en-US",
"TimeZone": "0",
"ColorDepth": 24,
"ScreenHeight": 768,
"ScreenWidth": 1024,
"JavaEnabled": true
},
"Audit": {
"Username": "Example-User",
"UserIP": "1.2.3.4"
}
}