Verify Payment Collection

Confirm the status of a payment

GET https://api.spotflow.co/api/v1/payments/verify?merchantId=&reference=

Headers

authorization String	Bearer SECRET_KEY Include your secret key in the request header as a Bearer token for authorization. Unauthorized requests will result in a 401 HTTP status code.

Query Parameters

merchant-id int32

This is the unique ID of the merchant you want to verify.

reference

This is the unique reference ID returned at payment creation.

Sample Response

200 OK

{
    "id": "7c7495f4-4f5d-4c0f-bfc1-7b85e22d8774",
    "reference": "ref-83fdbf78-ba13-47d1-9833-f87613579e14",
    "spotflowReference": "SPF-KPY-a2c688cd10c2459aa6576d8c9024ef80",
    "amount": 100.00,
    "currency": "NGN",
    "totalFees": 0.00,
    "channel": "bank_transfer",
    "status": "successful",
    "customer": {
        "id": "28d102db-6c7b-4b82-b0a1-5f7688ab9988",
        "name": "Leone Mayert",
        "email": "customer@email.com",
        "phoneNumber": "629-543-7126"
    },
    "rate": 1496.52,
    "region": "Nigeria",
    "bankDetails": {
        "accountNumber": "759046",
        "bankName": "wema"
    },
    "createdAt": "2025-02-21T09:50:36Z"
}