Versions Compared

Key

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

...

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
languagejson
 {
    "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
languagejson
{
    "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)

...