---
title: "Cancel a payout order if is possible"
method: PATCH
path: "/payout_orders/{payout_order_id}/state"
tags: ["Payout orders Cancel"]
---

# Cancel a payout order if is possible

`PATCH /payout_orders/{payout_order_id}/state`

Can be used to cancel a payout order if it is still waiting to be processed

## Response `200`

Returns when was possible to cancel the payout order identified by the given id.

- PayoutOrderCancel — Cancel Payout order
  - `shinkansen_payout_order_state` string — The state of the payout order. This will have the value "cancelled" as other values return error.

## Other responses

- `404` — Requested payout is not found.
- `422` — Returns the error detail when payout-orders get endpoint fails

---

[API](https://skmtc.net/shinkansen/apis/payouts-shinkansen-endpoints.md) · [All operations](https://skmtc.net/shinkansen/apis/payouts-shinkansen-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shinkansen/payouts-shinkansen-endpoints/versions/1e4a6760b7e8/schema)