---
title: "Cancel payout"
method: DELETE
path: "/payouts/{payoutId}"
tags: ["Payouts API"]
---

# Cancel payout

`DELETE /payouts/{payoutId}`

Cancel a payout. A payout can only be canceled while it has the status `requested`. Once the payout moves to `initiated`, it is too late to cancel.

The canceled payout object is returned with the status set to `canceled`.

> 🔑 Access with
>
> [API key](/reference/authentication)
>
> [Advanced access token with **payouts.write**](/reference/authentication)

## Query parameters

- `testmode` boolean

## Response `200`

The canceled payout object.

## Other responses

- `404` — No entity with this ID exists.
- `409` — The payout cannot be canceled in its current state. This happens when the payout has already moved past the `requested` status.
- `429` — Rate Limit has been reached.

---

[API](https://skmtc.net/mollie/apis/accepting-payments.md) · [All operations](https://skmtc.net/mollie/apis/accepting-payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mollie/accepting-payments/revisions/4b45df3039ef/schema)