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

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

Last updated