Sandbox: Fail a disbursement
Simulates a payment failure or return for testing purposes.
The disbursement must have a status of `submitted`.
This only applies for disbursements sent via ACH or check.
- **ACH disbursements**: Status becomes `failed` (payment was returned and cannot be retried)
- **Check disbursements**: Status becomes `validating_organization` (check was returned). When this happens, Chariot will investigate why the check failed to reach the organization, update any required recipient information (such as mailing address or organization contact details), and automatically reattempt payout once the issue is resolved.
<Note title="Sandbox Only" icon="fa-light fa-atom-simple">
This API is only available in the sandbox environment.
</Note>
Path parameters
id
The unique identifier for the disbursement
Headers
Authorization
Bearer authentication of the form Bearer <token>
, where token is your auth token.