unified-payments
  1. Payments
unified-payments
  • Unified Payments
    • Overview
    • Encryption
    • Authentication
    • Card (Non-3DS)
    • Card (3DS)
    • Apple Pay
  • Unified Payments API
    • Payments
      • Initiate Payment
        POST
      • List Payments
        GET
      • Get Payment
        GET
    • Refunds
      • Initiate Refund
      • List Refunds
      • Get Refund
  • Schemas
    • Schemas
      • SuccessResponse
    • ErrorResponse
    • PaymentRequest
    • PaymentResponse
    • WebhookPayload
  1. Payments

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 ********************
or
Query Params

Responses

🟢200Success
application/json
Body

Request 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 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
Previous
Initiate Payment
Next
Get Payment
Built with