📌

Reserved Accounts

Permanent virtual account numbers dedicated to a specific customer or reference. Unlike disposable accounts, reserved accounts remain active across multiple payments until you explicitly close them.

♾️ Active until closed💳 Multiple payments🏷️ Reconcile by reference

How It Works

Assign a dedicated virtual account number to each customer. The account stays open indefinitely — the customer can make repeat payments to the same number without you needing to provision a new one each time. When you no longer need the account (customer offboarded, project closed), call Close Reserved Account to deactivate it.

Reconcile by reference — not account number

After a reserved account is closed, its account number may be reassigned to another customer. Always identify transactions using the reference field from the webhook payload, never by account number alone.

Bearer token required

All endpoints require a valid Bearer token. Obtain one from the Access Token endpoint and pass it as Authorization: Bearer <token>.

Endpoints

POST

Create Reserved Account

Assigns a persistent virtual account number to a customer or reference. Remains active across multiple payments until explicitly closed.

v1 legacy docs →

DELETEv2 · Recommended

Close Reserved Account

Permanently deactivates a reserved account. The account will no longer accept inbound credits and the number may be reassigned. Ensure all pending transactions are settled before closing.

v1 legacy docs →