Outros Eventos

Esta página cobre eventos de webhook relacionados a mudanças de conta e aprovação de contas whitelabel.

ACCOUNT_STATUS_UPDATED

Disparado quando o status de uma conta registrada é alterado — por exemplo, de ACTIVE para BLOCKED. Como registrar:

{
  "eventType": "ACCOUNT_STATUS_UPDATED",
  "url": "https://seuservidor.com.br/webhooks/conta-atualizada",
  "authorizationScheme": "BEARER",
  "authorization": "seu-token"
}

Payload:

{
    "bankAccount": "999999",
    "eventType": "ACCOUNT_STATUS_UPDATED",
    "status": "BLOCKED",
    "updatedAt": "2026-03-06T13:31:47.999Z"
}

Campo	Descrição
`bankAccount`	Número da conta Delfinance que sofreu a alteração
`eventType`	`"ACCOUNT_STATUS_UPDATED"`
`status`	Novo status da conta: `ACTIVE`, `BLOCKED` ou `FINISHED`
`updatedAt`	Timestamp da mudança

WHITELABEL_CUSTOMER_APPROVED / DOCUMENTATION_REJECTED

Disparado quando uma conta criada via Whitelabel é aprovada ou tem sua documentação rejeitada. Como registrar:

{
  "eventType": "WHITELABEL_CUSTOMER_APPROVED",
  "url": "https://seuservidor.com.br/webhooks/conta-aprovada",
  "authorizationScheme": "BEARER",
  "authorization": "seu-token"
}

{
  "eventType": "WHITELABEL_CUSTOMER_DOCUMENTATION_REJECTED",
  "url": "https://seuservidor.com.br/webhooks/conta-rejeitada",
  "authorizationScheme": "BEARER",
  "authorization": "seu-token"
}

Payload — Conta aprovada:

{
    "name": "JOSEVALDO",
    "document": "61263079091",
    "bankAccountNumber": 13102
}

Payload — Documentação rejeitada:

{
    "name": "Fulano da silva",
    "document": "49126271869",
    "bankAccountNumber": null
}

Campo	Descrição
`name`	Nome registrado na conta
`document`	CPF ou CNPJ registrado
`bankAccountNumber`	Número da conta criada (preenchido apenas quando aprovada; `null` quando rejeitada)

Introdução

Autenticação

Receber via Pix (Pix Cash-in)

Pagar via Pix (Pix Cash-out)

Cobranças via Boleto

Split de Pagamentos

Webhooks

ACCOUNT_STATUS_UPDATED

WHITELABEL_CUSTOMER_APPROVED / DOCUMENTATION_REJECTED

​ACCOUNT_STATUS_UPDATED

​WHITELABEL_CUSTOMER_APPROVED / DOCUMENTATION_REJECTED

ACCOUNT_STATUS_UPDATED

WHITELABEL_CUSTOMER_APPROVED / DOCUMENTATION_REJECTED