List Payments

GET

/v2/payments

Fetch a list of payments

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/v2/payments?status=&merchant_reference&currency&date_from&prev_cursor&next_cursor&limit' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "status": "success",
    "data": {
        "status": "successful",
        "message": "Payments fetched successfully",
        "data": {
            "items": [
                {
                    "id": "01KEH1FAPH0J9V1GDZGQV4SHBX",
                    "merchant_id": "01KC9KZB6078W70PF20VF0DMHB",
                    "merchant_reference": "7e093f5a-60b3-41e7-9d08-bd0ed118e965",
                    "provider_id": "8110000000022138879",
                    "amount": 10000,
                    "currency": "USD",
                    "description": "Test 3DS Transaction",
                    "payment_type": "card_3ds",
                    "status": "completed",
                    "current_step": "3ds_final_payment_approved",
                    "redirect_url": "https://example.com/callback",
                    "failure_reason": null,
                    "created": 1767951018705
                }
            ],
            "meta": {
                "pagination": {
                    "order": "desc",
                    "limit": 20,
                    "has_previous": false,
                    "previous_cursor": "01KEH1FAPH0J9V1GDZGQV4SHBX",
                    "has_next": false,
                    "next_cursor": null
                },
                "filters_applied": {
                    "merchant_id": "01KC9KZB6078W70PF20VF0DMHB",
                    "status": "completed",
                    "sort": {
                        "field": "_id",
                        "order": "desc"
                    }
                }
            }
        }
    }
}

Modified at 2026-01-13 12:01:54

Initiate Payment

Get Payment