List payments by merchant id

GET

/api/v1/payment/{merchant-id}

Reporting API available to fetch list of payments based on specific selection criteria.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://example.com/api/v1/payment/?offset=5&limit=10&amountEquals=1000&amountGreaterThan=500&amountLessThan=900&currency&originBankId=12345&originAccount=1288398743&originAccountName=12345&destinationBankId=67890&destinationAccount=1288398743&destinationAccountName=12345&description=Payment for groceries&reference=iausdfh12892j&status=SUCCESS&startDate&endDate'

Responses

🟢200OK

application/json

Body

Example

[
    {
        "id": "szokiqnitlsqbi1g1fp9vhwo",
        "amount": 1080000,
        "ownerId": "k235v1ujhhnpwv0zmyk4by6t",
        "currency": "NGN",
        "reference": "somerandomreferenceforwatch2",
        "originBankId": null,
        "originAccount": null,
        "originAccountName": null,
        "destinationBankId": "dqv8ldz5mk4eu7ykcvrr8g84",
        "destinationAccount": "1234ABCXXX",
        "destinationAccountName": "Alphabets Inc",
        "description": "Watch purchase",
        "status": "OPEN",
        "callbackUrl": "https://pay.flashpayweb.com",
        "statusWebhook": null,
        "createdAt": "2024-06-24T16:09:59.085Z",
        "updatedAt": null,
        "expiresAt": null
    }
]

Modified at 2025-07-28 21:19:44

New payment intent

Payment details by payment ID