This endpoint is to be called whenever an OTP is to be authorized.
This endpoint is protected with OAuth 2.0 Bearer token
Endpoint URL: {{base_url}}/api/v1/merchant/cards/otp/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
{ "transactionReference": "MNFY|54|20210429142945|000208", "collectionChannel": "API_NOTIFICATION", "tokenId": "2000.00-e944ba213f0acbc90a16b292ba353b2f", "token": "123456" }
Sample Response
{ "requestSuccessful": true, "responseMessage": "success", "responseCode": "0", "responseBody": { "status": "SUCCESS", "message": "Transaction Successful", "transactionReference": "MNFY|54|20210429142945|000208", "paymentReference": "1619702984105", "authorizedAmount": 2000.00 } }
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) |