We highly recommend that when you receive a notification from us, even after checking to ensure the hash values match, you should initiate a get transaction status request to us with the transactionReference to confirm the actual status of that transaction before updating the records on your database.
This endpoint is protected with OAuth 2.0 Bearer token
Endpoint URL: {{base_url}}/api/v2/transactions/{{transactionReference}}
Content-Type: application/json
HTTP Method: GET
The {{base_url}} for test is https://sandbox.monnify.com
but when you go live, it changes to the live url
You can get the transaction status with a simple GET request to the get status endpoint and simply add either of the following query params in the table below.
Kindly do a url_encode of the transactionReference before passing into the url endpoint
Request | |
---|---|
Field | Description |
transactionReference | Unique transaction reference generated by Monnify for each transaction |
Here’s a sample request and response
Get Transaction Status Request
{ "requestSuccessful": true, "responseMessage": "success", "responseCode": "0", "responseBody": { "transactionReference": "MNFY|20200226093601|002095", "paymentReference": "330854835", "amountPaid": "100.00", "totalPayable": "100.00", "settlementAmount": "99.21", "paidOn": "26/02/2020 09:38:13 AM", "paymentStatus": "PAID", "paymentDescription": "LahrayWeb", "currency": "NGN", "paymentMethod": "ACCOUNT_TRANSFER", "product": { "type": "WEB_SDK", "reference": "330854835" }, "cardDetails": null, "accountDetails": { "accountName": "DAMILARE SAMUEL OGUNNAIKE", "accountNumber": "******7503", "bankCode": "000001", "amountPaid": "100.00" }, "accountPayments": [ { "accountName": "DAMILARE SAMUEL OGUNNAIKE", "accountNumber": "******7503", "bankCode": "000001", "amountPaid": "100.00" } ], "customer": { "email": "ogunnaike.damilare@gmail.com", "name": "Lahray" }, "metaData": { "name": "Damilare", "age": "45" } } }