Disbursement: Verify Payout Possibility
Related API Reference
API Reference: Check if disbursement possible
Introduction
Before initiating a disbursement using the 8B Payments API, verify that the payout is eligible for processing. This check ensures that recipient details are valid, sufficient funds are available, and compliance conditions are met — reducing the risk of failed or rejected payouts.
This step is optional and not required for every disbursement.
However, performing a verification check before initiating the disbursement is strongly recommended, especially for new recipients or large payouts.
What You Need to Verify a Disbursement
Single-transaction check:
Each verification request can be used to check only one disbursement. If you need to validate multiple disbursements, send separate requests for each.
To submit a verification request, you must prepare the following information:
| Requirement | Description |
|---|---|
| Access Token | Bearer token for authentication. See Auth: Get Access and Refresh Tokens. |
| Settlement Account ID | The account from which the payout will be made. |
| Sender (Payer) | The profile or account ID of the sender in your system. |
| Receiver (Payee) | The beneficiary’s account information, such as bank details or wallet ID. |
| Receiver Platform Code | Identifier of the payout method/platform. See Supported Payment Methods for a list of available codes. |
| Platform Account | The receiver’s platform-specific account ID (e.g., IBAN, wallet number). |
| Disbursement Amount | The amount and currency to be disbursed. |
How It Works
Possible Outcomes
Verification does not guarantee success.
The check reflects conditions at the time of the request. If another transaction consumes available funds before your disbursement is submitted, it may still fail.
Verification Passed
✔ Recepient's account is valid
✔ Recepient is eligable to receive payouts (not blacklisted)
✔ Recepient name is correct
✔ There is sufficient funds on your 8B Disbursement Account
Verification Failed.
✘ Invalid account format
✘ Unsupported country or method
✘ Insufficient funds
✘ Blocked recipient
✘ Regulatory restriction
Updated about 23 hours ago