# Webhook

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

### **Sequence Diagram**

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

### **Event data**

<table><thead><tr><th width="173.33333333333331">Parameter</th><th width="156">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>requestId</td><td>String</td><td>The ID of the request.</td></tr><tr><td>type</td><td>String</td><td>“<em>ACCOUNT</em>”</td></tr><tr><td>merchantId</td><td>String</td><td>The ID of merchant.</td></tr><tr><td>virtualAccounts</td><td>Array</td><td><p>The array contains the list of created virtual accounts.</p><p>Refer to <a href="#virtualaccount">VirtualAccount</a> below</p></td></tr><tr><td>createdAt</td><td>String</td><td>The time of creating account.</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>

#### VirtualAccount

<table><thead><tr><th>Parameter</th><th width="158.33333333333331">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>accountName</td><td>String</td><td>The ID of seller/business is provided by merchant.</td></tr><tr><td>receiver</td><td>String</td><td>The name of receiver.</td></tr><tr><td>bankId</td><td>String</td><td>The Swift Code of the bank.</td></tr><tr><td>bankName</td><td>String</td><td>Bank name</td></tr><tr><td>serviceInfomation</td><td>Object</td><td>Refer to <a href="#service-information">Service Information</a></td></tr><tr><td>bankAccountNumber</td><td>String</td><td>The bank account number.</td></tr><tr><td>qrText</td><td>String</td><td>QR Code</td></tr><tr><td>virtualAccountRequestId</td><td>String</td><td>The ID of seller/business is provided by merchant</td></tr><tr><td>transferNote</td><td>String</td><td>Transfer Contents</td></tr><tr><td>code</td><td>Number</td><td>Refer to <a href="/pages/Z6i4pnK4y9vE73CiFAF9">Error Codes</a></td></tr><tr><td>status</td><td>String</td><td>Status of virtual account creation:<br>SUCCESS<br>FAILED<br>PROCESSING</td></tr></tbody></table>

#### Service Information

<table><thead><tr><th width="258">Parameter</th><th width="118">Data Type</th><th width="108">Required</th><th>Description</th></tr></thead><tbody><tr><td>code</td><td>String<br>(up to 10 latin chars)</td><td>N</td><td>Service code which is defined by the merchants. This code will be used to filter the VAs and grouped Reconciliations on Merchant Portal</td></tr><tr><td>groupId</td><td>String<br>(up to 10 latin chars)</td><td>N</td><td>Id of VA group which is defined by the merchants. This id will be used to filter the VAs on Merchant Portal</td></tr><tr><td>desc</td><td>String<br>(up to 256 latin chars)</td><td>N</td><td>Description of VA</td></tr></tbody></table>

### Sample data

```json
{
  "requestId": "63ea2832-8448-4993-8bff-9748cd3aed64",
  "merchantId": "62aa8e8311c8360019132856",
  "type": "ACCOUNT",
  "createdAt": "2023-11-15T02:27:18.241Z",
  "virtualAccounts": [
    {
      "virtualAccountRequestId": "5029e5b0-5824-4a0c-bd7a-808439cced22",
      "bankAccountNumber": "NEO0003044",
      "bankId": "MSCBVNVX",
      "bankName": "Military Commercial Joint stock Bank",
      "transferNote": "NEO1700015238057",
      "receiver": "ACC SBX 001",
      "accountName": "ACC SBX 001",
      "qrText": "00020101021238540010A000000727012400069704220110NEO00030440208QRIBFTTA53037045802VN5911ACC SBX 00162200816NEO17000152380576304FA4E",
      "serviceInformation": {
        "code": "code1",
        "desc": " test",
        "groupId": "group1"
      },
      "code": 1,
      "status": "SUCCESS"
    }
  ],
  "secureHash": "vpE2KAJ78GTrIXUkdxp8m3WOeR8rBRPAeth1/mP3sWE="
}
```

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

{% code overflow="wrap" %}

```
2023-11-15T02:27:18.241Z62aa8e8311c836001913285663ea2832-8448-4993-8bff-9748cd3aed64ACCOUNTACC SBX 001NEO0003044MSCBVNVXMilitary Commercial Joint stock Bank100020101021238540010A000000727012400069704220110NEO00030440208QRIBFTTA53037045802VN5911ACC SBX 00162200816NEO17000152380576304FA4EACC SBX 001code1 testgroup1SUCCESSNEO17000152380575029e5b0-5824-4a0c-bd7a-808439cced22123
```

{% 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/collections/virtual-account-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.