Use this guide when you need to manually check the status of a Send Money disbursement.
Brick sends disbursement status updates through callback notifications, but manual status checks are useful when a callback is delayed, your server is temporarily unavailable, or the original API response leaves the transaction state unclear.
When to Check Status Manually
Processing for Too Long
If a disbursement remains in a processing state for more than expected, query the latest status before taking further action.
API Error During Creation
If the create-disbursement request returns a server error, do not immediately retry the payout. First, check the transaction by transaction ID or reference ID to avoid duplicate payouts.
Missed Callback
If your callback endpoint was unavailable or misconfigured, use the status API to reconcile your internal records.
Status Check Options
| Lookup method | API reference |
|---|---|
| Disbursement ID | Check Disbursement Status using Disbursement ID |
| Reference ID | Check Disbursement Status using Reference ID |
Recommended Flow
- Store the
transaction_idreturned by Brick and your ownreference_idwhen creating the disbursement. - If the callback is missing or the transaction state is unclear, query the status API.
- Retry a disbursement only when the queried status confirms that the original transaction failed or was not created.