Virtual Accounts

Planbok Virtual Accounts provide fiat custody accounts for Nigerian Naira (NGN). They are the fiat counterpart to onchain wallets and support both organization-custody and customer-custody models.

Supported currencies

• Currency: NGN only

Custody models

Organization custody

Organization-custody virtual accounts are created in bulk through a single API call. They require:

• A live organization and a live API key.
• MPC to be configured for the organization.
• The encrypted organization secret when trustless MPC is enabled.
• A unique refId per account for idempotency and reconciliation.

Customer custody

Customer-custody virtual accounts are created per customer and per currency through the existing challenge + PIN verification flow. The customer authorizes creation of one or more currencies in a single PIN verification.

Transfers

Both custody types support transfers:

• Organization custody: Direct transfer endpoint with MPC-secret verification.
• Customer custody: Transfer challenge endpoint followed by PIN verification.
• Destinations can be external Nigerian bank accounts or internal virtual accounts within the same organization.

Read-only lookups

The following provider-proxied lookup endpoints are available:

• List supported banks
• Account balance
• Provider-side customer details
• Transaction history and details
• External bank account name enquiry
• Internal Loma virtual account name enquiry

Billing

Virtual accounts affect billing independently from onchain wallets:

• The flat infrastructure fee applies when an organization has 10+ active onchain wallets or 1+ active virtual accounts.
• Higher usage tiers are based on the combined total of active wallets and virtual accounts.