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

# Webhook

### Configure the webhook to receive the IPN

* Enable **Use APIs**
* Fill in the **URL to receive notifications for changes in credit limit**
* Fill in the **Secret Key**

<figure><img src="/files/6EzBZoBz58u6TxJALVr9" alt=""><figcaption></figcaption></figure>

### Sequence Diagram

<figure><img src="/files/nhBF7mBEU0esPAU5cDU5" alt=""><figcaption></figcaption></figure>

### Response Data

<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="/pages/FvYjr9HJVHxqeU1fDsHI">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>

### Sample data

```json
{
  "service": "DISBURSEMENT",
  "type": "TRANSACTION",
  "data": {
    "requestId": "826ae17b-8c96-42aa-aca2-196b94e21772",
    "amount": 200000,
    "fee": 0,
    "requestTransId": "transid-e360530e-5176-4830-aaf2-e744627ea931",
    "transId": "CH-101020230NLUW19L",
    "status": "SUCCESS",
    "receiver": "NGUYEN VAN A",
    "bankAccountNumber": "4396828945",
    "failedReason": "Successful transaction",
    "srcAmount": 200000,
    "srcCurrency": "VND",
    "fxRate": 1,
    "code": 1
  },
  "time": "2023-10-10T07:15:12.042Z",
  "secureHash": "ELsrE1knfvTD8JxPmyChO8VayUUzry6ptZJ0I+jPsac="
}
```

With the secretKey "123", the string used to create secureHash will be:

{% code overflow="wrap" %}

```
20000043968289451Successful transaction01NGUYEN VAN A826ae17b-8c96-42aa-aca2-196b94e21772transid-e360530e-5176-4830-aaf2-e744627ea931200000VNDSUCCESSCH-101020230NLUW19LDISBURSEMENT2023-10-10T07:15:12.042ZTRANSACTION123
```

{% endcode %}