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

{
    "destinationCurrency": "NGN",
    "sourceAmount": 1,
    "sourceCurrency": "USD",
    "status": "successful",
    "destinationAmount": 560,
    "customer": {
        "id": 13,
        "name": "Klasha",
        "email": "[e-mail]",
        "phone": "09012323332",
        "createdAt": "2021-07-20 10:28:43",
        "updatedAt": "2021-07-20 10:28:43"
    }
}

400: Bad Request

{
   "status": "pending"
}