Skip to main content
POST
Generate single-use virtual account

Overview

Generate a dynamic, single-use virtual account for a customer with a fixed receivable amount and a configurable expiry window. The account is tied to an exact amount - it will only accept a payment matching that value - and automatically becomes inactive once the lifespan elapses or the payment is received. This is ideal for checkout flows, invoice payments, or any scenario where you need a guaranteed, one-time payment collection without reusing a permanent account.

Authorizations

X-API-KEY
string
header
required

API key for authentication.

Body

application/json
customer_id
string
required

Unique ID of the customer to generate the account for

amount
number
required

The exact amount the account will accept

lifespan_minutes
integer
required

How long the account remains active, in minutes

Response

Dynamic virtual account created successfully

status
boolean
data
object
error
any[]
message
string