> 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/introduction.md).

# Introduction

NeoX Global Collections (NeoX GC) is a system that provides a programmatic interface allowing Merchants to perform **cross-border collection and payout operations** via APIs.

Where the domestic Collection service handles in-country (Vietnam) collection, Global Collections extends the same model to **international flows**: collecting funds from overseas buyers into multi-currency virtual accounts, converting between currencies, and remitting funds out to overseas beneficiaries.

The Merchant must register an account on the Merchant Portal and activate the **Global Collections service** before using it.

## Actors

| Actor           | Role                                                                  |
| --------------- | --------------------------------------------------------------------- |
| Merchant        | The master account that integrates with NeoX GC APIs.                 |
| Sub-Merchant    | A seller / business onboarded under the Merchant and KYC-verified.    |
| Virtual Account | A multi-currency collection account that receives incoming funds.     |
| Payer           | The overseas buyer who sends funds into a virtual account.            |
| Beneficiary     | A registered payee that receives an outgoing payout / remitout.       |
| NeoX            | Operates the API, routes to the provider, signs and verifies traffic. |

## Business flows

The service supports three end-to-end flows. Each is described in detail in the relevant API section.

### 1. Collection (incoming funds)

```
Onboard sub-merchant ─► Open virtual account ─► Register trade order
        ─► Payer wires funds ─► COLLECTION webhook ─► Match collection to trade order
        ─► Reconcile & settle
```

### 2. Payout / Remitout (outgoing funds)

```
Register beneficiary ─► (optional) Lock FX rate via payout inquiry
        ─► Create payout request ─► PAYOUT webhook (result) ─► Reconcile balance
```

### 3. FX-only conversion

```
Query FX rates ─► FX inquiry (lock rate, get token) ─► Create FX order
        ─► Track FX order status ─► Track delivery status
```

## Key facts

* All APIs are **RESTful** and exchange JSON unless explicitly stated (file upload uses `multipart/form-data`).
* Authentication is **OAuth 2.0 Bearer Token** — see [Security Method](/docs/global/global-collections/integration/security-method.md).
* Every request carries a merchant-generated `requestId` used for **idempotency**.
* Asynchronous results (account approval, incoming funds, payout outcome) are delivered via **webhooks** — see [Event Notification](/docs/global/global-collections/integration/event-notification.md).