Page Comparison

...

Info
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/merchantsdk/cards/chargesecure-3d/authorize

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

language	json

 {
    "transactionReference": "MNFY|1934|20210430115705|00024320220405130551|182349",
    "apiKey":"XXXXXXXX",
    "collectionChannel": "API_NOTIFICATION",
    "card": {
        "cvvnumber": "123XXXXXX", 
        "expiryMonth": "12XX", 
        "expiryYear": "2022XXXX", 
        "numberpin": "4000000000000002XXXX", 
        "pincvv": "1234XXX"
        }
 }

...

Sample Response

Code Block

language	json

{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "status": "

...

SUCCESS",
        "

...

transactionReference": "MNFY|

...

34|

...

20220405130551|

...

182349",
        "paymentReference": "

...

u063ysqjp809883",
        "authorizedAmount":

...

20.0
    }
}

Field Parameters

Field	Description
transactionReference	Unique reference generated for the transaction by Monnify
collectionChannel	`"API_NOTIFICATION"` only enabled merchants can access resource
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)

...

Versions Compared

Old Version 2

New Version Current

Key