Transaction Status

Verify a transaction.

To complete a charge, a transaction should be verified and a transaction reference must be supplied.

When verifying a transaction, the following should be checked:

• Confirm both the value of the payment and the destination currency are correct.

• Confirm the status of the transaction is successful.

A sample code of how to implement server-side validation:

POST {{env_url}}/nucleus/tnx/merchant/status

Request Body

Name	Type	Description
tnxRef*	String	Transaction reference

{
    "tnxRef": "tnxRef"
}

Response Body

200: OK

{
    "txRef": "tnxRef",
    "destinationCurrency": "NGN",
    "sourceAmount": 2500.000000,
    "sourceCurrency": "NGN",
    "status": "successful",
    "destinationAmount": 2500.000000,
    "customer": {
        "id": 6132,
        "name": null,
        "email": "[e-mail]",
        "phone": "09012332122",
        "createdAt": "2022-01-24 13:25:31",
        "updatedAt": "2022-01-24 13:25:31"
    }
}

400: Bad Request

{
   "status": "pending"
}