ContinueAuthentications¶
Use ContinueAuthentications to continue a 3DS 2.x authentication session that has the CONTINUE
authentication status.
Endpoints¶
POST
/api/v2/merchants/{mid}/orders/{orderId}/continueauthentications
Resumes a 3DS authentication session.
Request parameters¶
Path parameter | Requirement | Description | Type |
---|---|---|---|
mid | Required | The merchant account reference number. | Number |
orderId | Required | The reference to uniquely identify a payment. | String |
Sample request¶
CURL
curl -X POST \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer 573cec25a87526dcceacad786bbbba83b1a5172' \
https:// /api/v2/merchants/1570616552/orders/order_example_1/continueauthentications
Sample response¶
3DS Frictionless Authentication
{
"mid": 1570616552,
"orderId": "order_example_1",
"orderAmount": 0,
"fulfilmentAmount": 0,
"capturedAmount": 0,
"refundedAmount": 0,
"currency": "EUR",
"baseCurrency": "EUR",
"baseOrderAmount": 0,
"baseFulfilmentAmount": 0,
"baseCapturedAmount": 0,
"baseRefundedAmount": 0,
"capturable": false,
"cancelable": false,
"refundable": false,
"completable": false,
"dccIndicator": false,
"timestamp": "2020-02-21T10:03:52.021Z",
"transactionReferences": [
{
"transactionId": 10042958342,
"transactionTypeId": 166,
"mid": 1570616552,
"orderId": "order_example_1",
"transactionType": "ContinueAuthentication",
"transactionDate": "2020-02-21T10:04:25.668Z",
"refTransactionId": 10042958341,
"transactionDesc": "Transaction Accepted",
"statusCode": 0,
"status": "Processed",
"amount": 10.50,
"currency": "EUR",
"baseAmount": 10.50,
"baseCurrency": "EUR",
"paymentMethod": "Visa",
"paymentMethodId": 1001,
"maskedAccountNumber": "411111xxxxxx1111",
"cardExpiryDate": "12-2024",
"cardAuthenticationInfo": {
"xid": "MDAwMDAwMDAwMTAwNDI5NTgzNDE=",
"cavv": "QUNTRU1VP0ZnaTE0YEZccyBzYjg=",
"eci": "5",
"authRequired": "Y",
"authenticationResult": "Y",
"authenticationProtocolVersion": "3DS2.1.0",
"authenticationDsTransId": "5f091e85-8356-562e-8000-00000000f021"
},
"authenticationStatus": "SUCCESSFUL"
}
]
}
3DS Challenge with 3D Method Authentication
{
"mid": 1570616552,
"orderId": "order_example_1",
"orderAmount": 0,
"fulfilmentAmount": 0,
"capturedAmount": 0,
"refundedAmount": 0,
"currency": "EUR",
"baseCurrency": "EUR",
"baseOrderAmount": 0,
"baseFulfilmentAmount": 0,
"baseCapturedAmount": 0,
"baseRefundedAmount": 0,
"capturable": false,
"cancelable": false,
"refundable": false,
"completable": false,
"dccIndicator": false,
"timestamp": "2020-02-21T10:27:27.424Z",
"transactionReferences": [
{
"transactionId": 10042960004,
"transactionTypeId": 166,
"mid": 1570616552,
"orderId": "order_example_1",
"transactionType": "ContinueAuthentication",
"transactionDate": "2020-02-21T10:29:33.244Z",
"refTransactionId": 10042960003,
"transactionDesc": "Authentication required",
"statusCode": 26016,
"status": "Processed",
"amount": 10.50,
"currency": "EUR",
"baseAmount": 10.50,
"baseCurrency": "EUR",
"paymentMethod": "Visa",
"paymentMethodId": 1001,
"maskedAccountNumber": "411111xxxxxx1111",
"cardExpiryDate": "12-2024",
"cardAuthenticationInfo": {
"xid": "MDAwMDAwMDAwMTAwNDI5NjAwMDM=",
"authRequired": "Y",
"authenticationResult": "C",
"authenticationProtocolVersion": "3DS2.1.0",
"authenticationDsTransId": "bfbed979-489b-5650-8000-00000000f026"
},
"authenticationStatus": "REQUIRED",
"authenticationUrl": "https://dsx.modirum.com:443/dstests/ACSEmu2",
"authenticationRedirectParameters": "{\"creq\":\"ewogICAiYWNzVHJhbnNJRCIgOiAiMDAwMDAwMDAtMDAwNS01YTVhLTgwMDAtMDE3MDY3NGJhODU1IiwKICAgImNoYWxsZW5nZVdpbmRvd1NpemUiIDogIjA1IiwKICAgIm1lc3NhZ2VUeXBlIiA6ICJDUmVxIiwKICAgIm1lc3NhZ2VWZXJzaW9uIiA6ICIyLjEuMCIsCiAgICJ0aHJlZURTU2VydmVyVHJhbnNJRCIgOiAiYmZiZWQ5NzktNDg5Yi01NjUwLTgwMDAtMDAwMDAwMDBmMDI2Igp9\",\"TermUrl\":\"https://somereturn.com/callback\"}",
"authenticationRedirectMethod": "POST"
}
]
}