> 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/disbursement/integration/event-notification.md).

# Event Notification

## Usage

* This is the API that the Platform should create to receive notifications of events that occur from NeoX.
* Sequence Diagram

  * Notifies about balance amount

  <figure><img src="https://1419689564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFdTKNedABvGBtqJRHWA0%2Fuploads%2Fk6dVRIDLQm1KupMKh65Y%2FPicture1_7.png?alt=media&amp;token=52d32bea-f293-4242-9217-d3431e986865" alt=""><figcaption></figcaption></figure>

  * Notifies about disbursement transaction

  <figure><img src="https://1419689564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFdTKNedABvGBtqJRHWA0%2Fuploads%2FJ6imArtoGPcnNsSHRP4v%2FPicture1_9.png?alt=media&amp;token=e4eaf4d9-3cd3-4e75-85e9-e75b128a0a0e" alt=""><figcaption></figcaption></figure>

## API

* Path: the URL(*https\://<\<yourdomain.com/api/notifi>>*) Webhook is created and configured by Platform on Merchant Portal, in the “Disbursement service” menu
* Method: POST
* Request: Body

## Notification type

### **Notifies about balance amount**

<table><thead><tr><th width="144.33333333333334">Parameter</th><th width="126">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>service</td><td>String</td><td>“<em>DISBURSEMENT</em>”</td></tr><tr><td>type</td><td>String</td><td>“<em>BALANCE</em>”</td></tr><tr><td>value</td><td>Number</td><td>The current amount.</td></tr><tr><td>time</td><td>String</td><td>The time of the event.</td></tr><tr><td>secureHash</td><td><p>String</p><p>(Base64)</p></td><td>Use SHA256 to hash the above parameters (sort the key by Alphabet order) + Secret Key (configured on Merchant Portal, in the “Disbursement service” menu)</td></tr></tbody></table>

### **Notifies about disbursement transaction happened**

<table><thead><tr><th width="144">Parameter</th><th width="108.33333333333334">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>service</td><td>String</td><td>“<em>DISBURSEMENT</em>”</td></tr><tr><td>type</td><td>String</td><td>“<em>TRANSACTION</em>”</td></tr><tr><td>data</td><td>Object</td><td>Data response, refer to <a href="/docs/disbursement/integration/response-data-structure.md">DisbursementTransactionItem</a></td></tr><tr><td>time</td><td>String</td><td>The time of the event.</td></tr><tr><td>secureHash</td><td><p>String</p><p>(Base64)</p></td><td>Use SHA256 to hash the above parameters (sort the key by Alphabet order) + Secret Key (configured on Merchant Portal, in the “Disbursement service” menu)</td></tr></tbody></table>

### **Notifies about currency exchanged**

<table><thead><tr><th width="144">Parameter</th><th width="108.33333333333334">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>service</td><td>String</td><td>“<em>DISBURSEMENT</em>”</td></tr><tr><td>type</td><td>String</td><td>“<em>EXCHANGE</em>”</td></tr><tr><td>data</td><td>Object</td><td>Data response, refer to <a href="/docs/disbursement/integration/response-data-structure.md#exchangetransactionitem">ExchangeTransactionItem</a></td></tr><tr><td>time</td><td>String</td><td>The time of the event.</td></tr><tr><td>secureHash</td><td><p>String</p><p>(Base64)</p></td><td>Use SHA256 to hash the above parameters (sort the key by Alphabet order) + Secret Key (configured on Merchant Portal, in the “Disbursement service” menu)</td></tr></tbody></table>