# Webhook

[***Configure the webhook***](/docs/global/collections/integration/event-notification.md)

### **Sequence Diagram**

<figure><img src="/files/5GsZzNpLXPuqTh3QQWct" alt=""><figcaption></figcaption></figure>

**Event data**

<table><thead><tr><th width="245">Parameter</th><th width="142.33333333333331">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>transId</td><td>String</td><td>The ID of transaction.</td></tr><tr><td>type</td><td>String</td><td>TRANSACTION</td></tr><tr><td>merchantCode</td><td>String</td><td>Merchant Code</td></tr><tr><td>transDate</td><td>String</td><td>The time of transaction.</td></tr><tr><td>virtualAccountRequestId</td><td>String</td><td>The ID of seller/business is provided by merchant.</td></tr><tr><td>virtualAccountId</td><td>String</td><td>The ID of virtual account.</td></tr><tr><td>accountName</td><td>String</td><td>The account name.</td></tr><tr><td>amount</td><td>Number</td><td>The amount of collection transaction.</td></tr><tr><td>note</td><td>String</td><td>Note.</td></tr><tr><td>serviceInformation</td><td>Object</td><td>Extra data includes "code", "groupId", "desc"</td></tr><tr><td>debitorInformation</td><td>Object</td><td>Debitor info object include:<br>"bankName": Debit fom bank name<br>"bankAccountNumber": Debitor bank account<br>"bankAccountName": Debitor bank account name<br>"bankRemark": Transaction remark received from debitor's bank.</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 Collection service menu)</td></tr></tbody></table>

### Sample data

```json
{
    "transId": "FT246560944209",
    "type": "TRANSACTION",
    "merchantCode": "UFLIYL",
    "transDate": "2023-10-10T07:06:37.436Z",
    "virtualAccountRequestId": "54f35db9-553b-4078-8271-7863162903c0",
    "virtualAccountId": "NEO0001675",
    "accountName": "HIEP HOANG",
    "amount": 20000,
    "note": "NEO1696918592059",
    "serviceInformation": {
        "code": "GRAB",
        "desc": "testtttt",
        "groupId": "DRIVER"
    },
    "debitorInformation": {
        "bankName": "Simulator connector",
        "bankAccountNumber": "09874732621",
        "bankAccountName": "Simulator account",
        "bankRemark": "691079-CTY TNHH TMDT HIEP HOANG payment for order 123456 NEO188879_NEO0001675"
    },
    "secureHash": "dXNENfQTIa9KgImBXJu2qFRprAcPhYydbBY8AlnmvgY="
}
```

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

{% code overflow="wrap" %}

```
HIEP HOANG20000Simulator account09874732621Simulator connector691079-CTY TNHH TMDT HIEP HOANG payment for order 123456 NEO188879_NEO0001675UFLIYLNEO1696918592059GRABtestttttDRIVER2023-10-10T07:06:37.436ZFT246560944209TRANSACTIONNEO000167554f35db9-553b-4078-8271-7863162903c0SUMTING
```

{% endcode %}


---

# Agent Instructions: 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/collections/transaction-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.