Eventos para verificar situação da conta

Escute os eventos do Asaas para ter sua integração em dia.

É possível utilizar webhook para que seu sistema seja notificado sobre alterações que ocorram
na situação de sua conta ou subcontas. Os eventos que o Asaas notifica são:

  • ACCOUNT_STATUS_BANK_ACCOUNT_INFO_APPROVED - Conta bancária aprovada
  • ACCOUNT_STATUS_BANK_ACCOUNT_INFO_AWAITING_APPROVAL - Conta bancária está em análise
  • ACCOUNT_STATUS_BANK_ACCOUNT_INFO_PENDING - Conta bancária voltou para pendente
  • ACCOUNT_STATUS_BANK_ACCOUNT_INFO_REJECTED - Conta bancária reprovada
  • ACCOUNT_STATUS_COMMERCIAL_INFO_APPROVED - Informações comerciais aprovada
  • ACCOUNT_STATUS_COMMERCIAL_INFO_AWAITING_APPROVAL - Informações comerciais em análise
  • ACCOUNT_STATUS_COMMERCIAL_INFO_PENDING - Informações comerciais voltou para pendente
  • ACCOUNT_STATUS_COMMERCIAL_INFO_REJECTED - Informações comerciais reprovada
  • ACCOUNT_STATUS_DOCUMENT_APPROVED - Documentos aprovados
  • ACCOUNT_STATUS_DOCUMENT_AWAITING_APPROVAL - Documentos em análise
  • ACCOUNT_STATUS_DOCUMENT_PENDING - Documentos voltaram para pendente
  • ACCOUNT_STATUS_DOCUMENT_REJECTED - Documentos reprovados
  • ACCOUNT_STATUS_GENERAL_APPROVAL_APPROVED - Conta aprovada
  • ACCOUNT_STATUS_GENERAL_APPROVAL_AWAITING_APPROVAL - Conta em análise
  • ACCOUNT_STATUS_GENERAL_APPROVAL_PENDING - Conta voltou para pendente
  • ACCOUNT_STATUS_GENERAL_APPROVAL_REJECTED - Conta reprovada

Exemplo de JSON a ser recebido [POST]

A notificação consiste em um POST contendo um JSON, conforme este exemplo:

{
    "id": "evt_05b708f961d739ea7eba7e4db318f621&368604920",
    "event": "ACCOUNT_STATUS_COMMERCIAL_INFO_APPROVED",
    "dateCreated": "2024-06-12 16:45:03",
    "accountStatus": {
        "id": "175027c1-029c-41e5-8b9a-e289b9788c33",
        "commercialInfo": "APPROVED",
        "bankAccountInfo": "APPROVED",
        "documentation": "APPROVED",
        "general": "APPROVED"
    }
}

👍

Retorno do Webhook com tipagem e ENUMs

Caso você queira saber qual o tipo de cada campo e os retornos de ENUMs disponíveis, confira a resposta 200 no endpoint "Consultar situação cadastral da conta" na documentação.

🚧

  • Com a entrada de novos produtos e funções dentro do Asaas, é possível que novos atributos sejam incluídos no Webhook. É muito importante que seu código esteja preparado para não gerar exceções caso o Asaas devolva novos atributos não tratados pela sua aplicação, pois isso poderá causar interrupção na fila de sincronização.
  • Enviaremos um e-mail e avisaremos em nosso Discord quando novos campos forem incluídos no Webhook. O disparo será feito para o e-mail de notificação definido nas configurações do webhook.