Skip to main content
GET
/
payments
/
verify
cURL
curl --request GET \
  --url https://api.spotflow.co/api/v1/payments/verify \
  --header 'Authorization: Bearer <token>'
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "reference": "REF123456789",
  "amount": 100,
  "currency": "USD",
  "status": "SUCCESS",
  "spotflowReference": "SPF-REF-001",
  "localAmount": 156000,
  "totalFees": 500,
  "localCurrency": "NGN",
  "channel": "card",
  "mode": "TEST",
  "customer": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "[email protected]"
  },
  "providerMessage": "Transaction successful",
  "rate": 1560,
  "region": "Nigeria",
  "authorization": {
    "mode": "Pin"
  },
  "ussd": {
    "code": "*737#",
    "paymentCode": "123456"
  },
  "bankDetails": {
    "accountName": "John Doe",
    "accountNumber": "0123456789",
    "bankName": "Access Bank"
  },
  "card": {
    "type": "VISA",
    "firstSix": "412345",
    "lastFour": "6789"
  },
  "createdAt": "2025-10-17T15:21:11.287Z",
  "metadata": {
    "orderId": "ORD-000123",
    "note": "First payment"
  },
  "totalTaxAmount": 50,
  "totalLocalAmount": 156050,
  "planId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "mobileMoney": {
    "otp": "1234",
    "code": "MTN",
    "name": "MTN Mobile Money",
    "phoneNumber": "+233540000000"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
reference
string<uuid>
required

The unique identifier of the payment.

Response

A JSON array of payment objects.

​
id
string<uuid>
required
Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

​
reference
string
required
Example:

"REF123456789"

​
amount
number
required
Example:

100

​
currency
string
required
Example:

"USD"

​
status
string
required
Example:

"SUCCESS"

​
spotflowReference
string
Example:

"SPF-REF-001"

​
localAmount
number
Example:

156000

​
totalFees
number
Example:

500

​
localCurrency
string
Example:

"NGN"

​
channel
string
Example:

"card"

​
mode
string
Example:

"TEST"

​
customer
object
​
providerMessage
string
Example:

"Transaction successful"

​
rate
number
Example:

1560

​
region
string
Example:

"Nigeria"

​
authorization
object
​
ussd
object
​
bankDetails
object
​
card
object
​
createdAt
string<date-time>
Example:

"2025-10-17T15:21:11.287Z"

​
metadata
object
Example:
{
  "orderId": "ORD-000123",
  "note": "First payment"
}
​
totalTaxAmount
number
Example:

50

​
totalLocalAmount
number
Example:

156050

​
planId
string<uuid>
Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

​
mobileMoney
object