Skip to main content
POST
Create a 30-minute NGN checkout wallet

Authorizations

x-api-key
string
header
required

Headers

X-Idempotency-Key
string
required

Unique key for this logical checkout request. Idempotency-Key is also accepted for backward compatibility.

Maximum string length: 255

Body

application/json
amount
integer
required

Underlying merchant order amount in NGN.

Required range: x >= 1
currency
enum<string>
required
Available options:
NGN
reference
string
required
Required string length: 1 - 100
Pattern: ^[A-Za-z0-9._:-]+$
feeBearer
enum<string>
required
Available options:
customer,
merchant
customer
object
metadata
object

Optional merchant data limited to 4,096 UTF-8 bytes and returned unchanged.

description
string
Maximum string length: 255

Response

Checkout session created or idempotently replayed

status
string
required
Allowed value: "success"
statusCode
enum<integer>
required
Available options:
200,
201
message
string
required
data
object
required