Documentation v1.0

List Transaction

List transactions carried out on your integration.

GET /transaction

Headers

Param Required Description
authorization
string
Yes Set value to Bearer SECRET_KEY

Query Param

Param Required Description
amount
integer
(Optional) Filter transactions by amount. Specify the amount
status
string
(Optional) Filter transactions by status ('failed', 'pending', 'success', 'abandoned')
customer
integer
(Optional) Specify an ID for the customer whose transactions you want to retrieve
{
    "status": true,
    "message": "Transactions retrieved",
    "data": [
        {
            "id": 44,
            "currency": "NGN",
            "amount": "2000",
            "reference": "16434005201755524296",
            "ip_address": null,
            "channel": null,
            "domain": "test",
            "fees": null,
            "plan": null,
            "requested_amount": "2000",
            "status": "success",
            "gateway": null,
            "created_at": "2022-01-28T20:08:40.000000Z",
            "paid_at": "2022-01-28 20:11:51",
            "customer": {
                "id": 3,
                "first_name": null,
                "last_name": null,
                "email": "customer@email.com",
                "phone": null,
                "customer_code": "CUS_3hqlcizuoffygev",
                "domain": "test",
                "metadata": "{}",
                "status": "active"
            }
        },
        {
            "id": 45,
            "currency": "NGN",
            "amount": "2300",
            "reference": "1643400746693960617",
            "ip_address": null,
            "channel": null,
            "domain": "test",
            "fees": null,
            "plan": null,
            "requested_amount": "2300",
            "status": "success",
            "gateway": null,
            "created_at": "2022-01-28T20:12:26.000000Z",
            "paid_at": "2022-01-28 20:14:30",
            "customer": {
                "id": 3,
                "first_name": null,
                "last_name": null,
                "email": "customer@email.com",
                "phone": null,
                "customer_code": "CUS_3hqlcizuoffygev",
                "domain": "test",
                "metadata": "{}",
                "status": "active"
            }
        },
        {
            "id": 46,
            "currency": "NGN",
            "amount": "300",
            "reference": "1643446267206306434",
            "ip_address": null,
            "channel": "card",
            "domain": "test",
            "fees": null,
            "plan": null,
            "requested_amount": "300",
            "status": "success",
            "gateway": "Interswitch",
            "created_at": "2022-01-29T08:51:07.000000Z",
            "paid_at": "2022-01-29 19:52:58",
            "customer": {
                "id": 3,
                "first_name": null,
                "last_name": null,
                "email": "customer@email.com",
                "phone": null,
                "customer_code": "CUS_3hqlcizuoffygev",
                "domain": "test",
                "metadata": "{}",
                "status": "active"
            }
        },
        {
            "id": 47,
            "currency": "NGN",
            "amount": "20000",
            "reference": "61e469c330c2bb",
            "ip_address": null,
            "channel": null,
            "domain": "test",
            "fees": null,
            "plan": null,
            "requested_amount": "20000",
            "status": "pending",
            "gateway": null,
            "created_at": "2022-01-29T23:57:40.000000Z",
            "paid_at": null,
            "customer": {
                "id": 4,
                "first_name": null,
                "last_name": null,
                "email": "customer1@budpay.com",
                "phone": null,
                "customer_code": "CUS_ig2yjfnhtphlgt0",
                "domain": "test",
                "metadata": "{}",
                "status": "active"
            }
        },
        {
            "id": 48,
            "currency": "NGN",
            "amount": "20000",
            "reference": "61e469c330c2bc",
            "ip_address": null,
            "channel": null,
            "domain": "test",
            "fees": null,
            "plan": null,
            "requested_amount": "20000",
            "status": "pending",
            "gateway": null,
            "created_at": "2022-01-31T16:22:03.000000Z",
            "paid_at": null,
            "customer": {
                "id": 4,
                "first_name": null,
                "last_name": null,
                "email": "customer1@budpay.com",
                "phone": null,
                "customer_code": "CUS_ig2yjfnhtphlgt0",
                "domain": "test",
                "metadata": "{}",
                "status": "active"
            }
        }
    ],
    "total_count": 5
}
curl https://budpay.ng/api/v1/transaction
-H "Authorization: Bearer YOUR_SECRET_KEY"
-X GET