Eventos para Pix Automático

É possível utilizar webhook para que seu sistema seja notificado sobre alterações que ocorram nas instruções e autorizações do Pix automático. Os eventos que o Asaas notifica são:

• PIX_AUTOMATIC_RECURRING_ELIGIBILITY_UPDATED - Elegibilidade da conta atualizada (para operações com subcontas).
• PIX_AUTOMATIC_RECURRING_AUTHORIZATION_CREATED - Autorização criada.
• PIX_AUTOMATIC_RECURRING_AUTHORIZATION_ACTIVATED - Autorização ativa.
• PIX_AUTOMATIC_RECURRING_AUTHORIZATION_CANCELLED - Autorização cancelada.
• PIX_AUTOMATIC_RECURRING_AUTHORIZATION_EXPIRED - Autorização expirada por falta de pagamento.
• PIX_AUTOMATIC_RECURRING_AUTHORIZATION_REFUSED - Autorização recusada pelo banco.
• PIX_AUTOMATIC_RECURRING_PAYMENT_INSTRUCTION_CREATED - Instrução de pagamento criada.
• PIX_AUTOMATIC_RECURRING_PAYMENT_INSTRUCTION_SCHEDULED - Instrução de pagamento agendada.
• PIX_AUTOMATIC_RECURRING_PAYMENT_INSTRUCTION_REFUSED - Instrução de pagamento recusada.
• PIX_AUTOMATIC_RECURRING_PAYMENT_INSTRUCTION_CANCELLED - Instrução de pagamento cancelada.

Exemplo de JSON a ser recebido [POST]

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

Instrução de pagamento

{
  "event": "PIX_AUTOMATIC_RECURRING_AUTHORIZATION_ACTIVATED",
  "authorization": {
    "id": "d51008fa-e28e-4823-82b4-4b1fcf485229",
    "status": "ACTIVE",
    "customerId": "cus_000006869125",
    "frequency": "MONTHLY",
    "value": 2.00,
    "startDate": "2025-08-01",
    "finishDate": "2028-01-01",
    "immediateQrCode": {
      "conciliationIdentifier": "ASAAS000000000000000000000000550ASA",
      "expirationDate": "2025-07-24 18:00:20"
    }
  }
}

Autorização

{
  "event": "PIX_AUTOMATIC_RECURRING_PAYMENT_INSTRUCTION_SCHEDULED",
  "paymentInstruction": {
    "id": "f6559451-cb41-4ec6-8487-2cda59a5f184",
    "status": "SCHEDULED",
    "dueDate": "2024-10-04",
    "payment": "pay_080225913252",
    "authorization": {
      "id": "c6b180f0-2196-454c-ac7e-72d662286bd1"
    }
  }
}

🚧

• 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