# Payouts

## Endpoints

### Create a payout

- [POST /v1/payouts](https://docs.stripe.com/api/payouts/create.md)

### Update a payout

- [POST /v1/payouts/:id](https://docs.stripe.com/api/payouts/update.md)

### Retrieve a payout

- [GET /v1/payouts/:id](https://docs.stripe.com/api/payouts/retrieve.md)

### List all payouts

- [GET /v1/payouts](https://docs.stripe.com/api/payouts/list.md)

### Cancel a payout

- [POST /v1/payouts/:id/cancel](https://docs.stripe.com/api/payouts/cancel.md)

### Reverse a payout

- [POST /v1/payouts/:id/reverse](https://docs.stripe.com/api/payouts/reverse.md)

## Events

- `payout.canceled`
Occurs whenever a payout is canceled.

- `payout.created`
Occurs whenever a payout is created.

- `payout.failed`
Occurs whenever a payout attempt fails.

- `payout.paid`
Occurs whenever a payout is *expected* to be available in the destination account. If the payout fails, a `payout.failed` notification is also sent, at a later time.

- `payout.reconciliation_completed`
Occurs whenever balance transactions paid out in an automatic payout can be queried.

- `payout.updated`
Occurs whenever a payout is updated.

A `Payout` object is created when you receive funds from Stripe, or when you initiate a payout to either a bank account or debit card of a [connected Stripe account](https://docs.stripe.com/connect/bank-debit-card-payouts.md). You can retrieve individual payouts, and list all payouts. Payouts are made on [varying schedules](https://docs.stripe.com/connect/manage-payout-schedule.md), depending on your country and industry.

Related guide: [Receiving payouts](https://docs.stripe.com/payouts.md)