> ## 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.

# Evento payout.account.created

> Evento payout.account.created.

## Evento `payout.account.created`

Disparado quando uma `payout_account` é criada e conectada à organização
atuante. Use este evento para registrar qual conta de recebimento ficou
disponível para a organização e para atualizar telas de conciliação, cadastro
financeiro ou ativação.

`data.object` usa o mesmo shape de [`GET /v1/payout-accounts/:id`](/api-reference/payout-accounts/get).
O número completo da conta nunca é retornado: identifique a conta por
`bank_code`, `routing_number`, `holder_name` e `account_number_last4`.

<Warning>
  `is_active: true` significa que a conta foi definida como principal no
  cadastro financeiro; não garante que os repasses serão creditados. A
  organização deve acompanhar o extrato bancário e conciliar cada recebimento.
</Warning>

## Quando acontece

| Situação                                             | Como aparece no payload                                                 |
| ---------------------------------------------------- | ----------------------------------------------------------------------- |
| Conta para saques criada pela API                    | `data.object.id` traz o novo `pa_*` e `created_at` marca a criação.     |
| Conta conectada à organização atuante                | O envelope top-level traz `organization` com a organização de contexto. |
| Conta definida como principal no cadastro financeiro | `is_active: true`.                                                      |

## Como processar

* Registre o `id` do evento (`evt_*`) para processar o webhook de forma idempotente.
* Use `data.object.id` (`pa_*`) como chave da conta para saques no seu sistema.
* Mostre apenas dados mascarados ou não sensíveis, como `account_number_last4`, `bank_name` e `routing_number`.
* Use `organization` no envelope para saber em qual organização a conta foi conectada.
* Não use `is_active` ou `is_verified` como confirmação de crédito; concilie as `transactions` com o extrato bancário.

## Campos importantes

| Campo                     | O que observar                                                                                  |
| ------------------------- | ----------------------------------------------------------------------------------------------- |
| `data.object.id`          | Identificador público da conta para saques.                                                     |
| `bank_code` / `bank_name` | Banco associado à conta.                                                                        |
| `routing_number`          | Agência ou identificador de roteamento.                                                         |
| `account_number_last4`    | Quatro últimos dígitos da conta; o número completo não é exposto.                               |
| `holder_name`             | Titular da conta.                                                                               |
| `is_active`               | Indica se esta é a conta principal no cadastro financeiro; não confirma o crédito dos repasses. |
| `is_verified`             | Campo informativo, sem semântica de elegibilidade para recebimentos.                            |
| `metadata`                | Reservado para metadata pública do objeto; normalmente `{}`.                                    |

## Tipos de conta

| Valor      | Descrição       |
| ---------- | --------------- |
| `checking` | Conta corrente. |
| `savings`  | Conta poupança. |

## Exemplo de payload

```json theme={"theme":"css-variables"}
{
  "id": "evt_H42rhfRuKjAkJ7t2",
  "object": "event",
  "created_at": "2026-05-16T14:20:01Z",
  "data": {
    "object": {
      "id": "pa_bR9LsckSvDz3NG3g",
      "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"
    }
  },
  "livemode": true,
  "organization": "org_GAzrqYSW8pK5fEJf",
  "request": {
    "id": null
  },
  "type": "payout.account.created"
}
```