Skip to main content
POST
Create a virtual account

Authorizations

X-Api-Key
string
header
required

An API key: lsk_<test|live>_<public_id>.. The key also has to be used from an address on its allowlist.

Headers

Idempotency-Key
string
required

A unique value per create (a UUID works). Retrying with the same key and body returns the first result with Idempotent-Replayed: true; the same key with a different body is 409 (code 53).

Body

application/json
type
string | null
required
Example:

"static"

customer_id
string<uuid> | null
label
string | null
Example:

"Lekki branch"

fee_bearer
string | null
Example:

"business"

reference
string | null
Example:

"INV-2026-0042"

amount_minor
integer<int64> | null
Example:

2500000

currency
string | null
Example:

"NGN"

expiry_minutes
integer<int32> | null
Example:

60

payer_name
string | null
Example:

"Adaeze Okafor"

collection_account_id
string<uuid> | null

Response

Created

success
boolean
required
message
string | null
required
request_id
string | null
required
Example:

"01a1775167aa7693a7acd8df7b596118"

data
object
code
string | null

Failures only: the numeric code a client branches on (see ErrorCodeNumbers).

Example:

"13"