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

# Collection APIs

**Collection APIs** provide read and compliance-supplement access to incoming-funds (collection) transactions — the records created each time a payer wires money into one of your virtual accounts.

By integrating with these APIs, organizations can:

* **Retrieve collection transaction details:** Query any collection transaction by `orderId` to inspect the payer, amount, currency, order type, current status, and any trade orders that have already been matched to it.
* **Supplement platform-collection compliance information:** When a platform-collection transaction requires business-scenario and funds-nature classification (acquiring-institution or third-party-payment-receiver flows), submit the appropriate category codes and supporting documents to satisfy the platform's compliance requirements.
* **Register and match trade orders:** Submit PI/CI (Proforma Invoice / Commercial Invoice) trade-contract orders backed by contracts, logistics records, and product details, then match them against incoming collection transactions so each received payment is anchored to its corresponding commercial activity.

In essence, **Collection APIs** empower you to monitor every incoming payment, respond to compliance prompts, and link payments to their commercial background, keeping your funds moving through the Global Collections platform without unnecessary delays.

{% hint style="warning" %}
**Supplement Payer Information** and **Submit Trade Detail File** are not available — see the notices on those pages, linked in the table below. The Create Trade Order endpoint also has no schema-level (Zod) validation on the backend — see the hint on [Create Trade Order](/docs/global/global-collections/integration/collections/api-create-trade-order.md). **Supply Platform Collection Info** has open questions around its `requestId` and `bizScenario`/`fundsNature` fields — see the warning on that page.
{% endhint %}

### Endpoints

| Endpoint                                                                                                                          | Method & Path                                             | Status    |
| --------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | --------- |
| [Get Detail Collection Order](/docs/global/global-collections/integration/collections/get-detail-collection-order.md)             | `GET /v2/gc/collection-transactions`                      | Available |
| [Create Trade Order](/docs/global/global-collections/integration/collections/api-create-trade-order.md)                           | `POST /v2/gc/trade-orders`                                | Available |
| [Update Trade Order](/docs/global/global-collections/integration/collections/api-create-trade-order.md#update-trade-order)        | `PUT /v2/gc/trade-orders`                                 | Available |
| [Match Collection and Trade Order](/docs/global/global-collections/integration/collections/api-match-collection-trade-order.md)   | `POST /v2/gc/trade-orders/collection-match-trade`         | Available |
| [Supply Platform Collection Info](/docs/global/global-collections/integration/collections/api-supply-platform-collection-info.md) | `POST /v2/gc/platform/collection-transactions/supplement` | Available |
| [Webhook](/docs/global/global-collections/integration/collections/webhook.md)                                                     | —                                                         | Available |