> For the complete documentation index, see [llms.txt](https://docs.neox.vn/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neox.vn/docs/global/global-collections/integration/virtual-accounts.md).

# Virtual Account APIs

**Virtual Account APIs** provide a complete lifecycle for applying, managing, and monitoring multi-currency collection (virtual) accounts. A virtual account is a dedicated bank account number issued in the merchant's name that can receive cross-border funds in one or more currencies. Merchants apply for a virtual account through the platform, submit any required KYC material, and receive the assigned account number and bank details once the application is approved.

By integrating with these APIs, organizations can:

* **Open multi-currency collection accounts:** Submit a virtual account application specifying the registration country, intended use, and the currencies to accept — all through a single API call.
* **Fulfill KYC requirements seamlessly:** When a virtual account application requires supplementary material, submit the additional KYC details using the dedicated supplement endpoint so the review can proceed without manual intervention.
* **Track application progress in real time:** Poll the detail and request-record endpoints to monitor every stage of the application lifecycle — from initial submission through to final approval and bank detail assignment.
* **List and filter your account portfolio:** Retrieve a paginated view of all virtual account applications with filters for status, currency, date range, and sub-merchant, making reconciliation and reporting straightforward.
* **Monitor material review outcomes:** Check the review status of submitted supplementary material and retrieve reviewer feedback to resolve any rejection quickly and resubmit corrected information.
* **Support sub-merchant collections:** Associate virtual accounts with specific sub-merchants, enabling platforms to manage collection accounts on behalf of their end-business clients.
* **Review common service questions:** Read the VA Service Q\&A for clarifications on settlement, documentation, limits, fees, and account allocation rules.

In essence, **Virtual Account APIs** empower you to automate the full virtual account workflow — from application and KYC fulfilment through to live collection-account management — without any manual portal intervention.

## Endpoints

| Method | Endpoint                                                                                                                                       | Description                                                                       |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| POST   | [Create Virtual Account](/docs/global/global-collections/integration/virtual-accounts/api-create-virtual-account.md)                           | Apply for a new multi-currency collection account.                                |
| POST   | [Supplement Virtual Account Material](/docs/global/global-collections/integration/virtual-accounts/api-supplement-virtual-account-material.md) | Submit additional KYC material for a pending application.                         |
| GET    | [Get Detail Virtual Account](/docs/global/global-collections/integration/virtual-accounts/get-detail-virtual-account.md)                       | Retrieve the current status and bank details of a virtual account application.    |
| GET    | [Get List Virtual Accounts](/docs/global/global-collections/integration/virtual-accounts/get-list-virtual-accounts.md)                         | Retrieve a paginated list of virtual account applications.                        |
| GET    | [Get Virtual Account Request Records](/docs/global/global-collections/integration/virtual-accounts/get-virtual-account-request-records.md)     | Retrieve the history of all submitted requests for a virtual account application. |
| GET    | [Get Supplement Material Status](/docs/global/global-collections/integration/virtual-accounts/get-supplement-material-status.md)               | Retrieve the review status of supplementary KYC material.                         |
| -      | [VA Service Q\&A](/docs/global/va-service-qa.md)                                                                                               | Common questions and answers about VA service rules and requirements.             |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.neox.vn/docs/global/global-collections/integration/virtual-accounts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.