Skip to main content
POST
Create payment

Authorizations

Authorization
string
header
required

Secret key: Authorization: Bearer sk_test_... or sk_live_.... Business and live/test mode are inferred from the key.

Body

application/json
reference
string
required

Your unique payment reference (e.g. order id)

Example:

"order_98234"

amount
number
required
Required range: x >= 1
Example:

7500

currency
enum<string>
required
Available options:
usd,
ngn,
eur
title
string

Checkout title shown to the customer. Defaults to your business name.

Maximum string length: 200
Example:

"Invoice #98234"

description
string

Optional checkout description shown under the title.

Maximum string length: 1000
Example:

"Payment for March subscription"

customer
object
callback_url
string<uri>
metadata
object

Response

Payment created

message
string
Example:

"Success"

data
object | null