Table of Contents
To be granted access to this API, you will be required to be PCI-DSS certified. For further inquiries, please reach out to integrations@monnify.com
Charge Card with no OTP
This endpoint is protected with OAuth 2.0 Bearer token
Endpoint URL: {{base_url}}/api/v1/merchant/cards/charge
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 Body (with no OTP)
{ "transactionReference": "MNFY|20190514172736|000001", "collectionChannel": "API_NOTIFICATION", "card": { "number": "4111111111111111", "expiryMonth": "10", "expiryYear": "2022", "pin": "1234", "cvv": "122" } }
Sample Response (with no OTP)
{ "requestSuccessful": true, "responseMessage": "success", "responseCode": "0", "responseBody": { "status": "SUCCESS", "message": "Transaction Successful", "transactionReference": "MNFY|54|20210429142557|000206", "paymentReference": "1619702756719", "authorizedAmount": 2000.00 } }
Charge Card with OTP
This endpoint is protected with OAuth 2.0 Bearer token
Endpoint URL: {{base_url}}/api/v1/merchant/cards/charge
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 Body (with OTP)
{ "transactionReference": "MNFY|54|20210429142945|000208", "collectionChannel": "API_NOTIFICATION", "card": { "number": "5061040000000000215", "expiryMonth": "09", "expiryYear": "2022", "pin": "1234", "cvv": "122" } }
Sample Response (with OTP)
{ "requestSuccessful": true, "responseMessage": "success", "responseCode": "0", "responseBody": { "status": "OTP_AUTHORIZATION_REQUIRED", "message": "OTP Authorization required", "otpData": { "id": "2000.00-e944ba213f0acbc90a16b292ba353b2f", "message": "Please enter OTP. Use 123456 as token" }, "transactionReference": "MNFY|54|20210429142945|000208", "paymentReference": "1619702984105", "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) |