Verify Payments

Verify transaction status. This endpoint is where your callback URL should call at.

Our system will send an http GET request to your callback URL using your transaction reference as a value to the query key: reference.

You should listen to the reference query in your callbacks

GET {{base_url}}/payment/:reference

Fields with * are required

Path Parameters

Name	Type	Description
reference*	String	Your transaction reference

Headers

Name	Type	Description
Authorization*	String	Bearer {{your_secret_key}}

200: OK

{
    "status": true,
    "message": "Transaction Retrieved Successfully",
    "data": {
        "reference": "edonbetter47u",
        "transaction_id": "edonbeta4u-CUS_BMW4WD2022-001",
        "amount": 9364760,
        "fee": 280943,
        "currency": "NGN",
        "success": true,
        "customer": {
            "name": "Ciroma Alade",
            "email": "[e-mail]",
            "phone": "08101234567"
        },
        "products": [
            {
                "name": "Cooling Refrigerator",
                "amount": 1092000,
                "description": "Twin Door; Green Colour"
            },
            {
                "name": "TV",
                "amount": 8000000,
                "description": "32 inches made in China"
            }
        ],
        "metadata": {
            "location": "Abuja"
        },
        "authorization": {
            "card_type": "visa",
            "first_six": "408412",
            "last_four": "2787",
            "expiry": "09/25"
        }
    }
}

404: Not Found Reference Error

{
    "success": false,
    "error": "Error in request",
    "message": "reference not found"
}