This endpoint is to be called to authenticate 3DS Secure Transactions
This endpoint is protected with OAuth 2.0 Bearer token. To find out more about authorization for Monnify endpoints, check Here
Endpoint URL: {{base_url}}/api/v1/sdk/cards/secure-3d/authorize
HTTP Method: POST
The {{base_url}} for test is https://sandbox.monnify.com
but when you go live, it changes to the live url
Sample Request
To authorize charge on a users card using 3DS Secure Transactions, you make an authenticated post request providing transaction reference, collection channel, API key and card details to the 3DS Secure Transactions endpoint.
{ "transactionReference":"MNFY|93|20220324165559|279401", "apiKey":"XXXXXXXX", "collectionChannel":"API_NOTIFICATION", "card":{ "number": "XXXXXX", "expiryMonth": "XX", "expiryYear": "XXXX", "pin": "XXXX", "cvv": "XXX" } }
Sample Response
{ "requestSuccessful": true, "responseMessage": "success", "responseCode": "0", "responseBody": { "status": "BANK_AUTHORIZATION_REQUIRED", "message": "3D Secure Authorization required", "secure3dData": { "id": "2000.00-59077a3e5157fae7ca9dd260d911ccbb", "redirectUrl": "http://localhost:10001" }, "transactionReference": "MNFY|19|20210430115705|000243", "paymentReference": "1619780224192", "authorizedAmount": 1000 } }
Field Parameters
Field | Description |
---|---|
transactionReference | Unique reference generated for the transaction by Monnify |
collectionChannel |
|
card | Object containing card information |
number | Card number |
expiryMonth | Card expiration month |
expiryYear | Card expiration year |
pin | Card pin from card owner |
cvv | Security code behind card |
tokenId | Token id from the request response (otpData.id) |
token | OTP from card owner (use 12345 for test card) |