Transaction Status

Verify a transaction.

Before giving value for any charge, it's advised to use the transaction status api below to verify the final status of the charge, using the transaction reference supplied during the charge initiation.

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.

Check transaction status

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

Request Body

Name	Type	Description
tnxRef*	String	Transaction reference

{
    "tnxRef": "6e003f69-55e3-4117-aa7a-f4259ad227ae"
}

Response Body

200: OK

{
    "txRef": "6e003f69-55e3-4117-aa7a-f4259ad227ae",
    "destinationCurrency": "NGN",
    "sourceAmount": 2500.000000,
    "sourceCurrency": "NGN",
    "status": "successful",
    "destinationAmount": 2500.000000,
    "customer": {
        "id": 6132,
        "name": Demo Tester,
        "email": "[email protected]",
        "phone": "09012332122",
        "createdAt": "2022-01-24 13:25:31",
        "updatedAt": "2022-01-24 13:25:31"
    }
}

400: Bad Request