Disbursement Account Validation
Disbursement Account Validation is the Send Money validation endpoint for checking a recipient bank account before creating a payout. Use this endpoint to validate the bank short code and account number, and to retrieve the account holder name when it is returned by the bank network.
Run account validation before creating a disbursement when account details come from users, partners, vendors, or other external systems. This endpoint validates bank account data for payout readiness; it does not validate Ewallet accounts and does not replace KYC, KYB, ownership checks, or fraud-risk review.
Request query parameters
| Key Parameters | Data Type | Description |
|---|---|---|
| accountNumber | String | Account number that the funds are intended to be sent to. |
| bankShortCode | String | This should be the institution that your end-customer intends to receive funds in. Please see this link for full list of bank accounts you can send to. This API only able to validate bank account and not Ewallet account. |
Response parameters
| Key Parameters | Data Type | Description |
|---|---|---|
| message | String | Message response for the request. |
| accountNo | String | The verified bank account number. |
| accountName | String | The name associated with the bank account. |
| bankShortCode | String | The short code of the bank institution. |
| activityId | String | Tracker ID used for tracing the request. Either provided by the client or generated by Brick. |
Store the activityId with your payout record when you need request tracing, support investigation, or reconciliation between your system and Brick records.
Related Financial Insight guide: Bank Account Validation.