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 os exemplos:

Elegibilidade da conta

Essa mesma estrutura de payload é utilizada para o evento PIX_AUTOMATIC_RECURRING_ELIGIBILITY_UPDATED, existindo dois tipos de eligibility.status: ELIGIBLE e INELIGIBLE.

• Importante: Se uma conta que era elegível (ELIGIBLE) se tornar inelegível (INELIGIBLE) e posteriormente voltar a ser ELIGIBLE, não é necessário reconfigurar os eventos de webhook do Pix Automático que já estavam configurados. Nesse caso, os eventos voltarão a ser enviados normalmente.

{
   "id":"evt_ID",
   "event":"PIX_AUTOMATIC_RECURRING_ELIGIBILITY_UPDATED",
   "dateCreated":"2026-03-05 08:24:11",
   "account":{
      "id":"accountId",
      "ownerId":null
   },
   "eligibility":{
      "status":"INELIGIBLE",
      "ineligibleReasons":[
         // Lista dos motivos
      ]
   }
}

Instrução de pagamento

Nestes eventos, o payload é o mesmo, além das informações de instrução de pagamento, o que varia é o campo authorization.status, que pode assumir os valores CREATED, ACTIVE, CANCELLED, EXPIRED e REFUSED

{
  "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

Nestes eventos, o payload é o mesmo, além das informações de autorização, o que varia é o campo paymentInstruction.status, que assume os valores AWAITING_REQUEST (no momento em que a cobrança é criada), SCHEDULED, REFUSED e CANCELLED

{
  "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