Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

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

Body

application/json
reference
string
required

Specify a unique reference ID generated by your company to identify each customer.

Example:

"string"

authorization
object
required

A confidential or secret code required to authenticate and verify identity for card transactions.

Response

A JSON array of authorize payment objects.

id
string<uuid>
Example:

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

reference
string
Example:

"REF123456789"

spotflowReference
string
Example:

"SPF-REF-001"

amount
number
Example:

100

currency
string
Example:

"USD"

localAmount
number
Example:

156000

totalFees
number
Example:

500

localCurrency
string
Example:

"NGN"

channel
string
Example:

"card"

status
string
Example:

"SUCCESS"

providerMessage
string
Example:

"Please enter your OTP sent to your phone"

rate
number
Example:

1560

region
string
Example:

"Nigeria"

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

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

metadata
object
Example: