The following guideline is designed to protect integrators from financial loss by ensuring that pay outs are only classified as failed under the correct conditions.
Failure Handling Disclaimer for Pay Outs
When integrating with the pay outs (cashout) API, a pay out must only be considered failed under the following conditions:
- You receive a callback/webhook from our platform with the status failed.
- In contingency scenarios, you perform a reference-code lookup using our API and the returned status is explicitly failed.
- Additionally, client-side errors — HTTP status codes ≥ 400 and < 500, except for 409 Conflict — may be safely treated as failure cases.
However, the following scenarios must NOT be interpreted as failure:
- Connection errors
- Timeouts
- Server-side errors (HTTP status ≥ 500)
In these cases, the integrator must continue waiting for the final result, which will be provided either by the callback mechanism or by a subsequent status query.