---
title: "Criar um payout"
method: POST
path: "/payouts/create"
---

# Criar um payout

`POST /payouts/create`

Permite que você crie um novo payout para transferir valores da sua conta AbacatePay.

Você pode usar esta rota para:
- **Realizar saques** da sua conta para sua própria chave PIX
- **Enviar dinheiro** para outras contas
- **Realizar pagamentos** diretamente pela API
- **Efetuar transferências** para fornecedores, parceiros ou terceiros

**Importante**: A chave PIX de destino não precisa ter a mesma titularidade do CNPJ da sua conta. Você pode realizar payouts para qualquer chave PIX válida.

## Request body

- object — Dados necessários para criar um payout.
  - `amount` number, required — Valor do payout em centavos.
  - `description` string — Descrição opcional do payout.
  - `externalId` string, required — Identificador único do payout em seu sistema.

## Response `200`

Payout criado com sucesso.

- object
  - `data` object — Dados da transação de payout criada.
    - `id` string — Identificador único da transação.
    - `status` 'PENDING' | 'EXPIRED' | 'CANCELLED' | 'COMPLETE' | 'REFUNDED' — Status atual da transação.
    - `devMode` boolean — Indica se a transação foi criada em ambiente de testes.
    - `receiptUrl` string, uri, nullable — URL do comprovante da transação.
    - `amount` number — Valor da transação em centavos.
    - `platformFee` number — Taxa da plataforma em centavos.
    - `externalId` string — Identificador externo da transação.
    - `createdAt` string, date-time — Data de criação da transação.
    - `updatedAt` string, date-time — Data de atualização da transação.
  - `error` string, nullable
  - `success` boolean — Se a requisição obteve sucesso ou não.

## Other responses

- `401` — Não autorizado. Falha na autenticação.

---

[API](https://skmtc.net/abacatepay/apis/api-abacatepay.md) · [All operations](https://skmtc.net/abacatepay/apis/api-abacatepay/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/abacatepay/api-abacatepay/versions/6b89a7fa70f5/schema)