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": "03d06d45-b99b-4ec3-8853-ed2711cfa783",
    "reference": "ref-2a0b9ee8-b48d-4849-8a09-e50827fd0bed",
    "spotflowReference": "SPF-FLW-5b006ceeb0a54bb1acbd1c7da87784f0",
    "amount": 5000.00,
    "currency": "NGN",
    "channel": "card",
    "status": "successful",
    "customer": {
        "id": "3839716c-35b4-40f9-a04f-af8a399fb147",
        "email": "customer@email.com"
    },
    "providerMessage": "successful",
    "rate": 1,
    "provider": "flutterwave",
    "region": "Nigeria",
    "createdAt": "2024-08-20T11:49:41Z"
}