Subscription events

You can use webhooks for your system to be notified about changes that occur in bank transfers and transfers between Asaas accounts. The events that Asaas notifies are:

• SUBSCRIPTION_CREATED - Generation of a new signature.
• SUBSCRIPTION_UPDATED - Change in subscription.
• SUBSCRIPTION_INACTIVATED - Subscription inactivated.
• SUBSCRIPTION_DELETED - Subscription removed.
• SUBSCRIPTION_SPLIT_DIVERGENCE_BLOCK - Subscription blocked due to split divergence.
• SUBSCRIPTION_SPLIT_DIVERGENCE_BLOCK_FINISHED - Subscription blocking due to split divergence has been completed.

Example of JSON to be received [POST]

The notification consists of a POST containing a JSON, as in this example:

{
  "id": "evt_6561b631fa5580caadd00bbe3b858607&9193",
  "event": "SUBSCRIPTION_CREATED",
  "dateCreated": "2024-10-16 11:11:04",
  "subscription": {
    "object": "subscription",
    "id": "sub_m5gdy1upm25fbwgx",
    "dateCreated": "16/10/2024",
    "customer": "cus_000000008773",
    "paymentLink": null,
    "value": 19.9,
    "nextDueDate": "22/11/2024",
    "cycle": "MONTHLY",
    "description": "Assinatura Plano Pró",
    "billingType": "BOLETO",
    "deleted": false,
    "status": "ACTIVE",
    "externalReference": null,
    "sendPaymentByPostalService": false,
    "discount": {
      "value": 10,
      "limitDate": null,
      "dueDateLimitDays": 0,
      "type": "PERCENTAGE"
    },
    "fine": {
      "value": 1,
      "type": "PERCENTAGE"
    },
    "interest": {
      "value": 2,
      "type": "PERCENTAGE"
    },
    "split": [
      {
        "walletId": "a0188304-4860-4d97-9178-4da0cde5fdc1",
        "fixedValue": null,
        "percentualValue": 20,
        "externalReference": null,
        "description": null
      }
    ]
  }
}

👍

Webhook return with typing and ENUMs

If you want to know the type of each field and the available ENUM returns, check the 200 response in the "Retrieve a single signature" endpoint in the documentation.

🚧

• With the introduction of new products and functions within Asaas, it is possible that new attributes are included in the Webhook. It is very important that your code is prepared not to generate exceptions if Asaas returns new attributes not handled by your application, as this could interrupt the synchronization queue.

• We will send an email and notify on our Discord when new fields are included in the Webhook. The notification will be sent to the email defined in the webhook settings.
• The split array will be returned only when the charge has Payment Split configurations.