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",
  "spotflowReference": "SPF-REF-001",
  "amount": 100,
  "currency": "USD",
  "localAmount": 156000,
  "totalFees": 500,
  "localCurrency": "NGN",
  "channel": "card",
  "status": "SUCCESS",
  "mode": "TEST",
  "customer": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "john@example.com"
  },
  "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