---
title: "Stop payment for a disbursement"
method: POST
path: "/v1/disbursements/{id}/stop"
tags: ["disbursements"]
---

# Stop payment for a disbursement

`POST /v1/disbursements/{id}/stop`

Stop payment for a disbursement sent via check.

This prevents the recipient from depositing the check. If the check has already been deposited, the stop payment request will fail.

**Requirements:**
- Disbursement must be in `submitted` status
- Disbursement must be sent via check
- Check must not have already been deposited

After successfully stopping payment, the disbursement status will be updated to `stopped`.

## Path parameters

- `id` string, required

## Request body

- object
  - `reason` 'mail_delivery_failure' | 'not_authorized' | 'voided' | 'unknown', required — The reason for stopping a disbursement payment. Possible values include: - `mail_delivery_failure`: The check could not be delivered. - `not_authorized`: The check was not authorized. - `voided`: The check was stopped and voided. - `unknown`: The reason for stopping the disbursement payment is unknown.

## Response `202`

The stop payment request was accepted

## Other responses

- `400` — The request is invalid or contains invalid parameters
- `401` — Unauthorized. The request is missing the security (OAuth2 Bearer token) requirements and the server is unable to verify the identify of the caller.
- `403` — Access denied
- `404` — Resource Not Found
- `412` — Precondition Failed
- `500` — Internal Server Error

---

[API](https://skmtc.net/chariot-giving/apis/chariot-api-4.md) · [All operations](https://skmtc.net/chariot-giving/apis/chariot-api-4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chariot-giving/chariot-api-4/versions/c194d399d515/schema)