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

# Cancel payout

`DELETE /v2/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`.

## Query parameters

- `testmode` boolean

## Headers

- `idempotency-key` string

## 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/mollie-api.md) · [All operations](https://skmtc.net/mollie/apis/mollie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mollie/mollie-api/revisions/d2a3bd80c1fa/schema)