Virtual account API: How to build a scalable account infrastructure
A virtual accounts API helps you solve a problem that gets harder as payment volumes grow – working out where each inbound payment belongs.
This often happens when using pooled accounts, where payments from different customers, wallets, merchants, invoices, or business units all flow into the same underlying account. When payment references are inconsistent, reconciliation becomes time-consuming. And while opening a separate real bank account for every customer or use case can solve this, it’s more complex to manage at scale.
Virtual accounts offer a more scalable alternative by letting you assign unique account details to customers or entities you need to track in an internal ledger that falls under one or a few real accounts.
With a virtual accounts API, you can create and manage those virtual accounts directly from your own systems, helping automate account creation and reduce manual reconciliation work as volumes grow.
But choosing a virtual accounts API isn’t only a technical decision. The API matters, but so does the banking infrastructure behind it: where funds are held, how virtual accounts connect to real accounts, what payment data you receive, and whether the provider can support your account structure as you scale.
In this guide, we’ll explain how a virtual accounts API works, when it makes sense to integrate one, and what to look for in a provider.
We’ll cover:
- Virtual accounts: A quick overview
- How a virtual accounts API works
- When it makes sense to integrate a virtual accounts API
- Examples of virtual account APIs in practice
- Choosing the right provider for a virtual accounts API: What to consider
- Why choose ClearBank as your virtual accounts API provider
- Case study: How Allica Bank opened thousands of SME current accounts using ClearBank’s virtual accounts API
ClearBank is a UK- and EU-authorised B2B clearing bank. Through our API-first infrastructure and regulated account structure, you can implement virtual accounts and vIBANs to simplify your reconciliation and scaling operations. To get started right away, reach out to ClearBank.
Virtual accounts: A quick overview
To end customers sending or receiving payments, a virtual account will look and behave like a real account. In practice, a virtual account is a unique reference (vIBAN) or account number mapped to an underlying real account.
The important point to keep in mind is that virtual accounts don’t hold funds separately in the same way real accounts do. Instead, they serve as a routing layer on top of the real account, which helps you track, allocate, and reconcile payments more efficiently.
The exact capabilities of virtual accounts depend on the provider and account structure, so it’s important to check which payment types, currencies, reporting options, and account controls are supported.
Before getting into virtual account APIs, here are some key terms worth clarifying:
Real account
The underlying physical bank account held with a bank, where funds settle.
Virtual account
An account-like identifier that sits under a real account. It helps you track and allocate payments without needing to open a new real account every time.
IBAN
A standard international bank account number used to identify a real bank account for payments.
vIBAN (virtual IBAN)
vIBANs look and behave like IBANs to the person sending the payment, but they route funds into the virtual accounts.
API
The connection between your system and your provider’s banking infrastructure. It lets you create accounts, retrieve account information, manage payments, and receive transaction updates.
Webhook
An automated notification sent back to your system when something happens, such as a payment settling.
How a virtual account API works
A virtual accounts API enables you to create and manage virtual accounts directly from your own systems, rather than opening and managing every account manually through a banking portal.
Here’s what the flow can look like when using a virtual account API:
- You create a real account with your provider.
- You use the virtual accounts API to create virtual accounts under that real account and under your sort code.
- Each virtual account maps to a specific customer, payer, or purpose.
- The payer sends money to the virtual account details, such as a vIBAN or account number and sort code.
- The payment settles into the underlying real account.
- Your system receives transaction data showing which virtual account the payment was addressed to.
- You use that data to update your own ledger, customer balance, ERP, treasury system, or other reconciliation workflows.
For example, if each customer has their own virtual account, an inbound payment can be allocated to that customer automatically when it arrives. And if each invoice has its own virtual account, the payment can be matched to the invoice without relying solely on the payer entering the correct reference.
This is important because payment references can be unreliable. Customers may leave them blank, enter the wrong reference, combine multiple payments, or pay from a different account than expected.
If you’re still deciding what type of account to use: Real accounts vs virtual accounts: how to choose the best option for your business
When it makes sense to integrate a virtual accounts API
Here’s when you might implement a virtual accounts API:
- You need faster, cleaner reconciliation: By assigning virtual accounts to the payer, customer, or payment flow you need to track, incoming payments can be automatically matched based on where they were sent. This reduces manual investigation and gives your team a clearer audit trail.
- You’re outgrowing your existing account structure: If your team is opening more real accounts than it can manage efficiently, virtual accounts help simplify operations. This is especially useful when you need to scale account-like structures without adding more operational work or complexity.
- You want to improve the customer payment experience: Dedicated account details can make it easier for customers to send funds without relying on payment references alone, whether these are one-off or recurring payments. Virtual accounts issued under your own sort code can also support faster account creation and balance updates during onboarding, wallet setup, or repayments.
- You want to reduce manual workflows across payment operations: A virtual accounts API is most useful when it connects directly to your product, ledger, ERP, or treasury system. Your systems can trigger and receive updates automatically, instead of manually downloading transaction data or switching between portals.
Examples of virtual account APIs in practice
Here’s what virtual accounts can look like across different business models:
An EMI giving customers dedicated account details after onboarding
An EMI can create a virtual account for each customer once they pass onboarding checks. The customer can then receive inbound payments into dedicated account details, while funds settle into the EMI’s underlying account structure.
This creates a smoother customer experience without requiring the EMI to open a separate real account for every customer.
A marketplace tracking merchant funds separately
A marketplace can assign virtual accounts to individual merchants or sellers. Customer payments can settle into the underlying account while the marketplace tracks which merchant the funds belong to. This gives the finance team a cleaner audit trail and makes merchant settlement easier to manage.
A corporate allocating payments by customer, subsidiary, or region
A corporate with high-volume inbound payments can create virtual accounts for different customers, entities, subsidiaries, or markets.
For example, a business operating across several European markets could assign different virtual accounts by country or currency to make incoming funds easier to track and report on. Or a utilities firm for incoming bill payments to speed up the reconciliation process.
A digital asset platform allocating fiat deposits to the right customer wallet
A digital asset platform can assign a virtual account to each customer for GBP or EUR deposits. When the customer sends fiat funds, the platform can identify which wallet balance to update based on the virtual account used.
This helps reduce delays caused by missing references or manual deposit checks.
Choosing the right provider for a virtual accounts API: What to consider
For high-volume fintechs and enterprises, the 'best' provider is the one who can handle your specific requirements today and grow with you as your business evolves.
Here’s what you should ideally audit before deciding on a provider:
- Can you reliably automate reconciliation with the virtual accounts API?
Don’t just check whether the provider returns a virtual account ID. Check whether the transaction data is complete, timely, and structured enough to flow into your ERP, treasury system, or customer-facing balances without manual workarounds.
If payer details, references, timestamps, payment status, or virtual account identifiers aren’t preserved clearly enough, your team may still end up handling exceptions manually.
- Can your team integrate and test the API easily?
The API should be well documented, available in a sandbox, and supported by a clear QA and go-live process. Your team should be able to validate the full workflow before production: virtual account creation, payment receipt, transaction notifications, reporting, and exception handling. A strong integration experience reduces implementation risk and helps your team move from build to live operations faster.
- What infrastructure sits behind the API?
Your virtual accounts API won’t be working in isolation. The funds still need to settle somewhere, so it’s important to know who holds the underlying real account and how it’s structured. This matters most if you’re holding or moving money on behalf of customers, because the setup affects how you manage safeguarding compliance, reporting, and future growth.
- Which payment schemes can you access?
Virtual accounts help you identify and allocate incoming payments, but the payment rails determine how fast and reliably money actually moves.
Look beyond the list of supported schemes (Faster Payments, SEPA Instant, etc.) and ask: does the provider have direct scheme access, or do they route through intermediaries? Direct scheme access eliminates intermediary handoffs and can deliver faster settlement, lower failure rates, and greater operational control compared to routed solutions.
- Will you need to rebuild in 12 months?
A virtual accounts API may solve today’s reconciliation problem, but your needs can change as transaction volumes grow.
You may later want multi-currency accounts, more advanced banking features like savings accounts, or additional payment schemes. Choosing a provider with broader banking capabilities can reduce the chance that you’ll need to stitch together multiple vendors or migrate your account infrastructure later.
Why choose ClearBank as your virtual accounts API provider
ClearBank is a UK- and EU-authorised B2B bank. We enable financial institutions, fintechs, and UK corporates to offer virtual accounts with our cloud-native, API-first infrastructure.
Our virtual accounts are built for flexibility, allowing you to open millions of accounts with no limit on the number of layers of logic you can create. You can open virtual accounts any time, 365 days a year, using your own BIC or sort code.
Your real account is held with ClearBank, with virtual accounts created underneath it. Funds settle into the real account, while each virtual account acts as a unique identifier for allocating incoming payments to the right customer or use case.
This structure is useful because it gives you two things at once:
- Centralised fund holding: Funds settle into the underlying real account held with ClearBank.
- Granular payment allocation: Each virtual account can be mapped to the internal record you need to track.
Depending on your business model, virtual accounts can sit within different ClearBank account types, such as customer segregated accounts, client money accounts, operating accounts, or eligible multi-currency accounts.
You can read more about our different account types in our documentation.
Here are more reasons why companies like Allica Bank, One.io, and PingPong use ClearBank for their virtual accounts API:
- ClearBank’s API-first approach is built with implementation teams in mind. Developers get clear documentation making it easier to integrate virtual accounts into your existing systems without adding unnecessary complexity.
- 100% of sterling client funds are held securely at the Bank of England, while euro client funds are held at De Nederlandsche Bank and the European Central Bank. This means client funds are available 24/7, year-round.
- Built as a “bank for banks,” we don’t compete for your end customers. You can focus on building your client base while ClearBank supports the banking infrastructure in the background.
- We have direct access to major UK and European payment schemes. ClearBank is a direct participant in Faster Payments, SEPA Credit Transfer, SEPA Instant, Bacs, and CHAPS. This helps you reduce reliance on intermediary providers and give customers faster ways to send and receive money.
- Expand beyond your virtual account use case. ClearBank also supports capabilities such as Confirmation of Payee in the UK and Verification of Payee in the eurozone, as well as more advanced banking models like embedded banking with real, FSCS-protected savings accounts and Cash ISAs.
Case study: How Allica Bank opened thousands of SME current accounts using ClearBank’s virtual accounts API
Allica Bank offers no-nonsense business banking built especially for firms with 5-250 employees. They wanted to launch business current accounts for established SMEs, but needed a partner that could help them get to market quickly without taking on the cost and complexity of direct scheme connectivity.
Allica used ClearBank’s Virtual GBP Account solution to support its current account product. These virtual accounts gave Allica the flexibility to open accounts with their own addressable vIBANs while managing the logic within their own ledger.
In less than a year, Allica opened accounts for more than 2,000 established SME customers.
Allica also gained access to payment schemes including Faster Payments, CHAPS, Bacs Direct Credit, and outbound Bacs Direct Debits.
As a result, Allica could focus on building value-added services for SMEs, while ClearBank handled the accounts and payments infrastructure behind the scenes.
“ClearBank is a leader in its field and was an obvious partner for Allica because we’re aligned in many ways. We’re both API-first and focused on speed and execution.” Nida Sattar, Head of Product, Allica Bank
Read the full case study here: How Allica Bank delivers SME current accounts with ClearBank
Partner with ClearBank for a virtual accounts API that fits your wider account infrastructure
By the time you’re comparing virtual accounts API providers, the question usually isn’t whether virtual accounts can help. It’s whether the provider can support the way your business needs to hold, move, and reconcile funds as volumes grow.
That means looking at not only the API experience but also the underlying account structures, payment infrastructure, and future capabilities you may need.
With ClearBank’s API-first platform, you can create virtual accounts, use webhooks and transaction data to support reconciliation, and access wider banking capabilities as your business grows.
To learn more about how ClearBank can support your virtual account use case, get in touch with our team.
FAQs: Virtual account API
A virtual bank account API helps with reconciliation by letting you assign unique account details (such as a virtual IBAN) to specific customers, wallets, invoices, merchants, or payment flows. When a payment arrives via a bank transfer, your system can identify where it belongs based on the virtual account it was sent to, rather than relying only on payment references.
This is useful when payment references are missing, inconsistent, or entered incorrectly. Instead of manually investigating each exception, your ledger, ERP, treasury system, or customer-facing balance can be updated using the transaction data returned by the API in near real time.
With ClearBank, virtual accounts are created under real accounts held with ClearBank, and transaction notifications can help your systems allocate incoming payments and payouts more accurately.
A real account is the underlying bank account where funds actually settle. A virtual account sits under a real account and acts as a unique identifier, helping businesses track which beneficiary, invoice, wallet, or payment flow an incoming payment belongs to.
A vIBAN, or virtual IBAN, is an addressable account identifier that can be associated to a virtual account. To the payer, it can look and behave like normal payment details. Behind the scenes, however, funds still settle into the underlying real account.
With ClearBank, clients can create virtual accounts under real ClearBank accounts, with each virtual account able to have its own addressable vIBAN depending on the setup.
Virtual accounts typically don’t hold funds separately in the same way real bank accounts do. Instead, they help identify and allocate payments while the funds settle into an underlying real account.
This means virtual accounts can give customers or counterparties dedicated payment details, while the business keeps funds within a smaller number of real accounts. The exact capabilities depend on the provider, account structure, payment schemes, and currencies supported.
With ClearBank, virtual accounts sit under real accounts held with ClearBank, helping businesses combine centralised fund holding with more granular payment allocation.
When choosing a virtual accounts API provider, look beyond whether they can create virtual accounts. You’ll want to understand whether the API returns the transaction data your systems need, supports useful webhooks, and integrates cleanly into your ledger, ERP, treasury system, or customer-facing product.
You should also assess the infrastructure behind the API. That includes where funds are held, what real account structures are available, which payment schemes the provider supports, and if they provide clear API docs, reliable API endpoints, and support for real-time payment notifications.
ClearBank combines virtual accounts with real accounts held at a licensed bank, API-first infrastructure, UK and European payment scheme access, and broader capabilities such as embedded banking.