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. O número completo da conta nunca é retornado: identifique a conta por bank_code, routing_number, holder_name e account_number_last4.

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.

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

{
  "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"
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Evento payout.account.created