> 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/request-disbursement-api.md).

# Request disbursement API

* This is the API to create the disbursement requests.
* Sequence Diagram

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

* API:
  * Path: /v2/dib/disbursementRequests
  * Method: POST
  * Request: Content-Type: application/json
* Request Parameter

<table><thead><tr><th width="144">Parameter</th><th width="178">Data Type</th><th width="126">Required</th><th>Description</th></tr></thead><tbody><tr><td>requestId</td><td>String</td><td>Y</td><td><p>UUID is generated by merchant. (Unique)</p><p>Exp:“90e7340b-5cbe-4ce7-886f-55181040af4f”</p></td></tr><tr><td>transactions</td><td><p>Array</p><p>[TransactionItem]</p></td><td>Y</td><td>List of disbursement transactions</td></tr></tbody></table>

* #### TransactionItem

<table><thead><tr><th width="224">Parameter</th><th width="117">Data Type</th><th width="102">Required</th><th>Description</th></tr></thead><tbody><tr><td>amount</td><td>Number</td><td>Y</td><td>The disbursement amount in VND (integer)</td></tr><tr><td>bankSwiftCode</td><td>String</td><td>Y</td><td>Swift Code of the receiving bank.</td></tr><tr><td>bankAccountNumber</td><td>String</td><td>Y</td><td>The bank account number of the receiver.</td></tr><tr><td>bankAccountName</td><td>String</td><td>Y</td><td>The bank account name of the receiver.</td></tr><tr><td>description</td><td>String</td><td>Y</td><td>The description of disbursement ([a-zA-Z0-9 _-])</td></tr><tr><td>bankBranchName</td><td>String</td><td>N</td><td>The branch name of the receiving bank.</td></tr><tr><td>requestTransId</td><td>String</td><td>Y</td><td>The Unique ID of disbursement transaction is provided by the merchant (when submitting the request).</td></tr><tr><td>srcAmount</td><td>Number</td><td>N</td><td>The amount - foreign currency (different from VND). Which will be deducted from pre-fund account</td></tr><tr><td>srcCurrency</td><td>String</td><td>N</td><td>The prefund account currency.</td></tr><tr><td>fxRate</td><td>Number</td><td>N</td><td>The exchange rate between the srcCurrency against the VND</td></tr></tbody></table>

* Response Data

<table><thead><tr><th width="185">Parameter</th><th width="119">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>code</td><td>Number</td><td>System’s error code<br>refer to <a href="/pages/dSbs6Tn2xEmuiQznix2E">table of error codes</a></td></tr><tr><td>message</td><td>String</td><td>Error description</td></tr><tr><td>data</td><td>Object</td><td>Data response, refer to <a href="/pages/FvYjr9HJVHxqeU1fDsHI">DisbursementRequestRespData</a></td></tr></tbody></table>