Status

Check transaction status

POST https://pretium.africa/api/v1/payment/status

Headers

---

Name	Type	Description
api-key	string	Partner access API key

Request Body

---

Name	Type	Description
transaction_code	string	Transaction code received on collection or disbursement API

200 - Success

{
    "code": 200,
    "message": "Transaction status",
    "data": {
        "id": 10,
        "transaction_code": "VM72C",
        "mobile": "0799770833",
        "amount": "5",
        "status": "PAID",
        "category": "CREDIT",
        "message": "Payment processed successfully",
        "created_at": "2024-05-01T15:44:11.000000Z"
    }
}

400 - Bad Request

{
   "code": 400,
   "message": "Failed - Bad Request"

"category" either "CREDIT" or "DEBIT" for Credit is when collecting from users while Debit is when disbursing to users.

"status" either "PENDING", "PAID" or "FAILED" shows transaction progress when collecting or disbursing from or to users.