The general details about the Diool's RESTful API and the prerequisites to use or test this endpoint with Postman can be found on the introductory article: Getting Started with the Diool API | Introduction.

The status endpoint executes a request to get the status of a particular transaction (payment, transfer, etc.).

It accepts only one additional parameter, which is the uniqueReference of the transaction.




HTTP Method: POST

Sample Request

# Here is a curl example
  curl -d 
 '{ "uniqueReference": "HAUNMYVD" }'
  -H "Authorization: Bearer [API-KEY]"
  -H "Content-Type: application/json"
  -X POST "ENVIRONMENT_URL/status"

Sample Response - Prod

{
    "code": 0,
    "message": "Operation Successful",
    "developerMessage": "Operation Successful",
    "moreInfo": "www.diool.com",
    "resultType": "SUCCESS",
    "result": {
        "statusCode": 11,
        "statusDescription": "The sender does not have enough credit to perform this transfer",
        "timeStamp": "1692627147105"
    }
}

Need Help?

Already using or testing the API and need a hand?

Self service: Check out the FAQ.
Have a question..? Chat with us instantly through the Live Chat on our Help Center.
Totally stuck..? Send us a mail at helpdesk@diool.com and we will get back to you as soon as possible.

Updated on: 23/08/2023