---
title: "Cancel pending payouts"
method: DELETE
path: "/payout/v3/pending"
tags: ["Payouts"]
---

# Cancel pending payouts

`DELETE /payout/v3/pending`

Allows merchants to cancel pending payout transactions. 

<!-- theme: warning -->
> ⚠️ Try It
> 
> To use the Try It feature for this endpoint, you must use the credentials for your [Sandbox API user](https://docs.nexiopay.com/docs/sandbox-environments).


<div style="display:none;">

## Request parameters
- ids

## Response parameters
- message

</div>

## Request body

- object
  - `ids` integer[] — The ID values auto-generated by Nexio when the payout requests were submitted. These values are the same as the `payoutId` parameter values.

## Response `200`

OK

- object
  - `message` string — A message from Nexio about the state of the request.

## Other responses

- `101` — Pending payouts with ids nnnn do not exist
- `401` — Unauthorized. For help with this error and other error codes, see [Common errors](https://docs.nexiopay.com/docs/common-errors) in the Guides area.

---

[API](https://skmtc.dev/nexiopay/apis/payments-api-reference.md) · [All operations](https://skmtc.dev/nexiopay/apis/payments-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nexiopay/payments-api-reference/revisions/b414b73979e5/schema)