Eventos de Conta v1

Formato legado de notificação de status de conta. Clientes que cadastraram webhooks com account_status.update continuam recebendo este formato sem alterações.

Migração recomendada: Para receber o payload enriquecido com detalhamento por sócio e suporte a BIOMETRIC_REJECTED, cadastre um novo webhook com account_holder_status.update — ver Eventos de Conta v2.

Status da Conta

Status	Descrição	Ação recomendada
PENDING	KYC em processamento	Aguardar
KYC_APPROVED	KYC aprovado	Chamar POST /activate (PAYFAC)
KYC_REPROVED	KYC rejeitado	Corrigir dados via PUT

Exemplos de Payload

KYC Aprovado

{
  "event": "account.kyc.approved",
  "processedAt": "2026-01-30T16:00:00Z",
  "data": {
    "accountId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "accountType": "business",
    "status": "KYC_APPROVED",
    "reasons": []
  }
}

KYC Rejeitado

{
  "event": "account.kyc.reproved",
  "processedAt": "2026-01-30T16:00:00Z",
  "data": {
    "accountId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "accountType": "business",
    "status": "KYC_REPROVED",
    "reasons": ["NAME_MISMATCH"]
  }
}

KYC Pendente

{
  "event": "account.kyc.in_analysis",
  "processedAt": "2026-01-30T16:00:00Z",
  "data": {
    "accountId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "accountType": "business",
    "status": "PENDING",
    "reasons": []
  }
}