---
title: "Cancel pending payouts"
method: POST
path: "payouts/{payoutId}/cancel"
tags: ["Payments / Payouts"]
---

# Cancel pending payouts

`POST payouts/{payoutId}/cancel`

## Request

- Base URL: `https://payments.air-pay.io`
- URL: `https://payments.air-pay.io/payouts/{payoutId}/cancel`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/airtm/apis/airtm-enterprise-api-v1/docs/payouts/:payoutId/cancel/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows users to cancel specific `PENDING` individual
payouts—those that have been created and committed but where the
recipient has not yet signed up on Airtm.com.

To manually cancel a pending payout, users must provide the transaction
`id`, which can be retrieved when creating the payout through either the
**Create & Commit** or **One-Step** payout flows. Pending payouts will
automatically cancel after 90 days (by default, other time periods are
avilable in dashboard settings) from the creation date.

Once canceled:

*   Funds are automatically returned to the user's Airtm balance.

*   The individual payout status is updated to `CANCELED`.

*   The response will include all relevant details of the canceled
payout.

Additional information about canceled payouts can be accessed through
the **Enterprise Portal** (enterprise.airtm.com) or by querying
[**Operations**](642228876c87a11a975b0c47) .

**Note:** _This feature is only available for partners who have migrated
to the new infrastructure solution based on Bridge Ventures._

## Path parameters

- `payoutId` string, required

## Request body

- object

## Response `200`

OK

- object
  - `id` string
  - `amount` string
  - `confirmation_uri` string
  - `failure_uri` string
  - `failure_reason` string
  - `airtm_user_id` string
  - `airtm_user_email` string
  - `created_at` string
  - `updated_at` string
  - `status` string
  - `description` string
  - `airtm_operation_id` string
  - `operation_type` string
  - `airtm_operation_hash` string
  - `partner_id` string

## Other responses

- `400`: Payout is not in pending status.
- `500`: Not valid {payoutId}

---

[API](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v1.md) - [All operations](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v1/revisions/4e8326a04343?raw)