Transferências PIX

Eventos de saque e transferência.

Eventos de saque#

Evento	Disparado quando
`payout.created`	O saque é solicitado.
`payout.processing`	O saque foi aprovado e está saindo.
`payout.paid`	O dinheiro chegou à conta de destino.
`payout.failed`	Falhou. O motivo vem em `failed_reason`.

Transferências entre subcontas não geram evento próprio: elas aparecem no extrato do saldo, que você consulta em GET /v1/balance/statement.

Reconciliação

Para fechar o caixa, cruze os eventos de payout com o extrato. Cada movimento tem um lançamento correspondente no razão da conta.

payout.paid

{
  "event": "payout.paid",
  "sent_at": "2026-08-11T21:40:07Z",
  "data": {
    "id": "pyt_6Zq0Kd39",
    "status": "paid",
    "amount_centavos": 250000,
    "fee_centavos": 45,
    "net_centavos": 249955,
    "end_to_end_id": "E12345678202608112140...",
    "paid_at": "2026-08-11T21:40:05Z"
  }
}