---
title: "Sacar da subconta"
method: POST
path: "/sub-accounts/withdraw"
---

# Sacar da subconta

`POST /sub-accounts/withdraw`

## Request

- Base URL: `https://api.abacatepay.com/v2`
- URL: `https://api.abacatepay.com/v2/sub-accounts/withdraw`
- Auth: HTTP bearer

Saca o saldo de uma subconta por PIX. O destino é sempre a chave CPF/CNPJ igual ao `taxId` da subconta, por isso não há campo de chave.

## Request body

- object
  - `id` string, required: ID da subconta.
  - `amount` integer, required: Valor em centavos, mínimo `100` (R$ 1,00). Sai do saldo da subconta; a taxa (`platformFee`) é descontada desse valor.
  - `externalId` string, required: Identificador do saque no seu sistema.
  - `description` string: Descrição do PIX.

## Response `200`

Saque criado.

- object
  - `data` object
    - `id` string: Identificador único da transação.
    - `subAccountId` string: Subconta de onde o saque saiu.
    - `status` 'COMPLETE' | 'FAILED': `FAILED` quando o envio falha; o valor volta para o saldo da subconta.
    - `devMode` boolean
    - `receiptUrl` string, uri: URL do comprovante.
    - `amount` number: Valor do saque em centavos, com a taxa incluída.
    - `platformFee` number: Taxa em centavos, descontada do `amount`.
    - `externalId` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `error` string, nullable
  - `success` boolean: Se a requisição obteve sucesso ou não.

## Other responses

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

## Changes

- **2026-11-02** `8be803988b57`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/abacatepay/apis/api-abacatepay/changes/sub-accounts/withdraw/post.md)

---

[API](https://skmtc.dev/abacatepay/apis/api-abacatepay.md) - [All operations](https://skmtc.dev/abacatepay/apis/api-abacatepay/llms.txt) - [OpenAPI document](https://skmtc.dev/abacatepay/apis/api-abacatepay/revisions/8be803988b57?raw)