Skip to main content
A dynamic virtual account is lent to you for one payment of a set amount: one per invoice, order or checkout. When the right amount arrives it’s paid; if nothing arrives before it expires, it’s expired. Needs VIRTUAL_ACCOUNTS and DYNAMIC_VIRTUAL_ACCOUNTS, and virtual-accounts:write.

Create one

The answer’s payment_terms tell you what to show the payer:

Find it by your reference

You don’t have to store Mesh’s id: GET /v1/virtual-accounts?reference=INV-2026-0042 returns the list with at most one account, and an empty list when there’s none.

Outcomes

To withdraw an account before it’s paid, POST /v1/virtual-accounts/{accountId}/cancel. Only one still waiting for its payment can be cancelled; anything else is 409 (code 65).