> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Contas para saques

> Visão geral do objeto Conta para saques

Uma `payout_account` representa o destino configurado para os repasses de um
cadastro financeiro. Ela não é uma conta bancária genérica: o objeto descreve
especificamente a conta para saques usada na liquidação dos valores.

Organizações conectadas a uma plataforma veem esse destino por vínculo: quando
a organização atuante tem uma conta para saques conectada, **ela aparece em
`organization.payout_account`; antes disso, o campo vem `null`**.

A Chargefy nunca retorna o número completo da conta. Para identificação e
conciliação visual, **o objeto expõe apenas banco, agência, titular e os quatro
últimos dígitos da conta**.

Para exibir a conta atual de uma organização conectada no admin da plataforma,
prefira ler [`organization.payout_account`](/api-reference/organizations/object).
**Use os endpoints de `payout_accounts` quando precisar listar contas conectadas,
consultar um `pa_*` específico ou trocar/desconectar a conta principal.**

## Data Object

Este é o formato completo retornado em `organization.payout_account`, nos
endpoints de `payout_accounts` e em `data.object.payout_account` dos webhooks que
carregam uma `organization`.

```json theme={"theme":"css-variables"}
{
  "id": "pa_h3sTJmvEfdtwjv3n",
  "object": "payout_account",
  "account_number_last4": "5678",
  "bank_code": "001",
  "bank_name": "Banco Exemplo S.A.",
  "created_at": "2026-05-16T14:09:27Z",
  "holder_name": "Acme Ltda",
  "is_active": true,
  "is_verified": false,
  "livemode": true,
  "metadata": {},
  "routing_number": "0001",
  "type": "checking",
  "updated_at": "2026-05-16T14:20:00Z"
}
```

<Warning>
  `is_active: true` significa apenas que a conta é a principal cadastrada para
  recebimentos. Isso não garante que os repasses serão creditados: a organização
  deve conferir os recebimentos no extrato bancário e conciliá-los com as
  `transactions`.
</Warning>

<ResponseField name="id" type="string">
  Identificador público da conta para saques. Usa o prefixo `pa_*`.
</ResponseField>

<ResponseField name="object" type="string">
  Sempre `"payout_account"`.
</ResponseField>

<ResponseField name="account_number_last4" type="string">
  Últimos 4 dígitos da conta. O número completo nunca é retornado.
</ResponseField>

<ResponseField name="bank_code" type="string">
  Código do banco.
</ResponseField>

<ResponseField name="bank_name" type="string | null">
  Nome do banco. Vem `null` quando indisponível.
</ResponseField>

<ResponseField name="created_at" type="string | null">
  Data de criação em ISO 8601.
</ResponseField>

<ResponseField name="holder_name" type="string">
  Nome do titular da conta.
</ResponseField>

<ResponseField name="is_active" type="boolean">
  `true` quando esta é a conta principal no cadastro financeiro. Não indica se
  os repasses serão efetivamente creditados.
</ResponseField>

<ResponseField name="is_verified" type="boolean">
  Campo apenas informativo. Não representa elegibilidade para recebimentos e não
  deve ser usado para decidir se uma conta pode receber repasses.
</ResponseField>

<ResponseField name="livemode" type="boolean">
  `true` em produção; `false` em ambiente de teste.
</ResponseField>

<ResponseField name="metadata" type="object">
  Reservado para metadata pública do objeto. Atualmente retorna `{}`.
</ResponseField>

<ResponseField name="routing_number" type="string">
  Agência ou identificador de roteamento.
</ResponseField>

<ResponseField name="type" type="string">
  Tipo da conta para saques.

  | Valor      | Descrição       |
  | ---------- | --------------- |
  | `checking` | Conta corrente. |
  | `savings`  | Conta poupança. |
</ResponseField>

<ResponseField name="updated_at" type="string | null">
  Data da última atualização em ISO 8601.
</ResponseField>

## Operações

* [Criar uma conta para saques](/api-reference/payout-accounts/create)
* [Listar contas para saques](/api-reference/payout-accounts/list)
* [Consultar uma conta para saques](/api-reference/payout-accounts/get)
* [Desconectar uma conta para saques](/api-reference/payout-accounts/delete)

## Relações

O objeto `payout_account` também é retornado como campo aninhado em:

* [`organization.payout_account`](/api-reference/organizations/object)
* [`organization.updated.data.object.payout_account`](/api-reference/webhooks/organization.updated)