> 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/refund-request-management/webhook.md).

# Webhook

For general webhook delivery mechanics, retry schedules, and how to configure your `notifyUrl`, see [Event Notification](/docs/global/global-collections/integration/event-notification.md).

### Event data

| Field Name        | Type   | Description                                                                                                                                  |
| ----------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| refundRequestId   | string | Unique NeoX identifier for the refund request.                                                                                               |
| type              | string | Event type. Fixed value: `REFUND`.                                                                                                           |
| merchantCode      | string | NeoX merchant code associated with the originating account.                                                                                  |
| collectionOrderId | string | The NeoX collection order ID that was refunded.                                                                                              |
| amount            | number | Refund amount in the original transaction currency.                                                                                          |
| currency          | string | ISO 4217 currency code of the refund (e.g. `USD`, `EUR`, `HKD`).                                                                             |
| status            | string | Current status of the refund. Enum: `PROCESSING` \| `SUCCESS` \| `FAILED`. See Status Values table below.                                    |
| note              | string | Additional details or reason message provided with the refund status update, if any.                                                         |
| createdAt         | string | Timestamp when the refund request was created, in ISO 8601 format (e.g. `2024-05-01T10:30:00Z`).                                             |
| secureHash        | string | **Base64-encoded** SHA-256 HMAC of the sorted payload fields concatenated with the merchant Secret Key. Used to verify webhook authenticity. |

#### Status Values

| Status       | Description                                                                                       |
| ------------ | ------------------------------------------------------------------------------------------------- |
| `PROCESSING` | The refund has been accepted and is being processed by the payment network. Final status pending. |
| `SUCCESS`    | The refund has been completed successfully and funds have been returned to the original payer.    |
| `FAILED`     | The refund could not be completed. Refer to the `note` field for the failure reason.              |

### Sample data

```json
{
  "refundRequestId": "RF-20240501-000987654",
  "type": "REFUND",
  "merchantCode": "MERCH-00012345",
  "collectionOrderId": "CO-20240501-000123456",
  "amount": 1500.00,
  "currency": "USD",
  "status": "SUCCESS",
  "note": "",
  "createdAt": "2024-05-01T10:30:00Z",
  "secureHash": "dGhpcyBpcyBhIHNhbXBsZSBiYXNlNjQtZW5jb2RlZCBoYXNo"
}
```


---

# 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/refund-request-management/webhook.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.