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

Success

{
    "status": "success",
    "data": {
        "status": "successful",
        "message": "Payments fetched successfully",
        "data": {
            "items": [
                {
                    "id": "01KEH0ZC38ED8ER4D2EFH1YC47",
                    "merchant_id": "01KC9KZB6078W70PF20VF0DMHB",
                    "merchant_reference": "00b738db-f574-438f-9405-33d6c2bb1b3f",
                    "amount": 10000,
                    "currency": "USD",
                    "description": "Test 3DS Transaction",
                    "payment_type": "card_no3ds",
                    "status": "completed",
                    "current_step": "payment_approved",
                    "redirect_url": "https://example.com/callback",
                    "failure_reason": null,
                    "created": 1767950495848
                },
                {
                    "id": "01KD10P3AJ4HXPREPVY7BFWFSR",
                    "merchant_id": "01KC9KZB6078W70PF20VF0DMHB",
                    "merchant_reference": "97d5eea4-26c6-41ca-93a5-aa5f35034101",
                    "merchant_meta": {
                        "customer_id": "cust_1234",
                        "order_type": "retail"
                    },
                    "amount": 5000,
                    "currency": "GBP",
                    "description": "Premium Subscription - Annual",
                    "payment_type": "card_3ds",
                    "status": "completed",
                    "current_step": "3ds_final_payment_approved",
                    "redirect_url": "https://webhook.site/28d494d4-ec86-4728-87c7-e3fcdbe159ce",
                    "webhook_url": "https://webhook.site/28d494d4-ec86-4728-87c7-e3fcdbe159ce",
                    "failure_reason": null,
                    "created": 1766339579218
                },
                {
                    "id": "01KCRHH8EMFAGA2A42EK20VWXW",
                    "merchant_id": "01KC9KZB6078W70PF20VF0DMHB",
                    "merchant_reference": "d5b94a2a-2cff-4796-958c-2572b40a5814",
                    "merchant_meta": {
                        "customer_id": "cust_1234",
                        "order_type": "retail"
                    },
                    "amount": 5000,
                    "currency": "GBP",
                    "description": "Premium Subscription - Annual",
                    "payment_type": "card_3ds",
                    "status": "completed",
                    "current_step": "3ds_final_payment_approved",
                    "redirect_url": "https://webhook.site/28d494d4-ec86-4728-87c7-e3fcdbe159ce",
                    "webhook_url": "https://webhook.site/28d494d4-ec86-4728-87c7-e3fcdbe159ce",
                    "failure_reason": null,
                    "created": 1766055256532
                }
            ],
            "meta": {
                "pagination": {
                    "order": "desc",
                    "limit": 20,
                    "has_previous": false,
                    "previous_cursor": "01KEH0ZC38ED8ER4D2EFH1YC47",
                    "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