---
title: "Commit payout"
method: POST
path: "payouts/{payoutId}/commit"
tags: ["Payments / Payouts"]
---

# Commit payout

`POST payouts/{payoutId}/commit`

## Request

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

After calling this endpoint, Airtm will execute/process the previously
received payout instruction. The RESPONSE confirms the reception and
incorporation of the payout instruction for processing. Funds will be
deducted from your balance while the payout execution process is being
carried out.

Please note that a 200 response doesn't necessarily mean the money
moved, it simply means the system is now trying to send the amount. Use
webhooks OR call `/operations/:id` to get an update.

The status of the payout will either be `committed`, `pending` or
`failed`, A `committed` status means that the recipient's email has been
identified as an active Airtm user and the payout process has
successfully started. A `pending` status means that the recipient's
email does not have an Airtm account. The payout process will be
completed when the user signs up at Airtm. A `committed` payout will
eventually move on to `completed` once the payout execution process
finishes. Extra information of the recently `completed` payout can be
queried by calling /operations/:id

## Path parameters

- `payoutId` string

## Request body

- object

## Response `200`

OK

- object
  - `id` string: Unique identifier automatically generated on payout creation.
  - `partner_id` string: ID of the partner who created and committed the payout.
  - `status` string: Payout is commited and is the process of being executed
  - `amount` string: Amount in USD that was committed.
  - `description` string: Description of the payout, inputted in the creation.
  - `confirmation_uri` string: Deprecated. Airtm no longer calls this URL, and new payout requests that include it are rejected. Use webhooks instead.
  - `cancel_uri` string: Deprecated. Airtm no longer calls this URL, and new payout requests that include it are rejected. Use webhooks instead.
  - `failure_uri` string: Deprecated. Airtm no longer calls this URL, and new payout requests that include it are rejected. Use webhooks instead.
  - `failure_reason` string: This field will be populated if the payout fails, providing a reason for the failure.
  - `callback_uri` string: Deprecated. Airtm no longer calls this URL, and new payout requests that include it are rejected. Use webhooks instead.
  - `airtm_operation_id` string: Unique identifier for the payout operation within the Airtm system.
  - `created_at` string: Timestamp of when the payout was created.
  - `updated_at` string: Timestamp of the last update made to the payout information.
  - `airtm_user_email` string: This is the email of the Airtm user who is associated with this payout.
  - `airtm_user_id` string: This is the unique identifier for the Airtm user who is associated with this payout.
  - `operation_type` string: This field indicates the type of operation. In this case, it's a "payout".
  - `code_reason` string: This field will be populated if the payout failed or canceled, providing a code to referenced in the codes catalog.

## Other responses

- `404`: Payout not found

---

[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)