Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Endpoint URL: {{base_url}}/api/v1/merchantsdk/cards/secure-3d/chargeauthorize

HTTP Method: POST

Info

The {{base_url}} for test is https://sandbox.monnify.com but when you go live, it changes to the live url

Sample Request

Info
  • 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.

Code Block
languagejson
 {
    "transactionReference": "MNFY|1993|20210430115705|00024320220324165559|279401",
    "apiKey":"XXXXXXXX",
    "collectionChannel": "API_NOTIFICATION",
    "card": {
        "cvvnumber": "123XXXXXX", 
        "expiryMonth": "12XX", 
        "expiryYear": "2022XXXX", 
        "numberpin": "4000000000000002XXXX", 
        "pincvv": "1234XXX"
        }
 }

Sample Response

Code Block
languagejson
{
    "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
    }
}

...