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

# Refund Request APIs

**Refund Request APIs** provide merchants with the ability to initiate and track the return of collected funds back to the original payer when a transaction needs to be reversed. By leveraging NeoX Global Collections' refund infrastructure, merchants can manage refund lifecycles programmatically without manual intervention, ensuring a seamless experience for both the merchant and the end customer.

By integrating with these APIs, organizations can:

* **Initiate refunds programmatically:** Submit a refund request against any eligible collection transaction (identified by `orderId`) using a single API call, specifying who bears the refund transfer fee.
* **Track refund outcomes asynchronously:** Receive real-time refund status updates via the `TRADE_COLLECTION_REFUND_PROCESS`/`TRADE_COLLECTION_REFUND_SUCCESS` webhook events, eliminating the need for constant polling. See [Webhook](/docs/global/global-collections/integration/refund-requests/webhook.md).
* **Monitor collection transaction state:** Observe refund progress directly on the related collection transaction, which transitions through `REFUND_PROCESS` and `REFUND_SUCCESS` states as the refund progresses — see [Get Detail Collection Order](/docs/global/global-collections/integration/collections/get-detail-collection-order.md).
* **Ensure idempotent operations:** Use a merchant-generated `requestId` (UUID) on every refund submission to safely retry requests without creating duplicate refunds.

In essence, **Refund Request APIs** empower you to automate the full refund lifecycle — from initiation through final settlement confirmation — within your existing payments workflow.

## Available Endpoints

| Endpoint                                                                                                          | Method | Description                                         |
| ----------------------------------------------------------------------------------------------------------------- | ------ | --------------------------------------------------- |
| [Create Refund Request](/docs/global/global-collections/integration/refund-requests/api-create-refund-request.md) | POST   | Initiate a refund for an incoming collection order. |