Skip to main content

​
subscription.canceled

Disparado quando uma assinatura é cancelada — manualmente pelo integrador ou por política interna após falhas recorrentes de cobrança.
Payload
{
  "type": "subscription.canceled",
  "id": "hook_b2c3d4e5f6a1",
  "data": {
    "code": "sub_abc123xyz",
    "status": "RecurringCanceled",
    "value": 99.90,
    "payment_type": "CreditCard",
    "canceled_at": "2026-05-27T10:00:00.000000Z",
    "invoices_count": 6
  }
}
CampoTipoDescrição
codestringCódigo único da assinatura
statusstringSempre RecurringCanceled
valuedecimalValor por ciclo em reais
payment_typestringMétodo de pagamento da assinatura
canceled_atstringData/hora do cancelamento (ISO 8601)
invoices_countintegerTotal de faturas geradas antes do cancelamento

​
subscription.delayed

Disparado quando uma assinatura entra em atraso — ou seja, uma fatura não foi paga dentro do prazo e a assinatura aguarda regularização.
Payload
{
  "type": "subscription.delayed",
  "id": "hook_c3d4e5f6a1b2",
  "data": {
    "code": "sub_xyz789abc",
    "status": "RecurringOverdue",
    "value": 149.90,
    "payment_type": "CreditCard",
    "overdue_since": "2026-05-01T00:00:00.000000Z",
    "overdue_invoice_code": "ord_overdue456"
  }
}
CampoTipoDescrição
codestringCódigo único da assinatura
statusstringSempre RecurringOverdue
valuedecimalValor por ciclo em reais
payment_typestringMétodo de pagamento da assinatura
overdue_sincestringData em que entrou em atraso (ISO 8601)
overdue_invoice_codestringCódigo do pedido da fatura em aberto

​
subscription.regularized

Disparado quando uma assinatura que estava em atraso é regularizada — após o pagamento da fatura em aberto.
Payload
{
  "type": "subscription.regularized",
  "id": "hook_d4e5f6a1b2c3",
  "data": {
    "code": "sub_xyz789abc",
    "status": "Recurring",
    "value": 149.90,
    "payment_type": "CreditCard",
    "regularized_at": "2026-05-27T14:00:00.000000Z",
    "paid_invoice_code": "ord_overdue456"
  }
}
CampoTipoDescrição
codestringCódigo único da assinatura
statusstringSempre Recurring
valuedecimalValor por ciclo em reais
payment_typestringMétodo de pagamento da assinatura
regularized_atstringData/hora da regularização (ISO 8601)
paid_invoice_codestringCódigo do pedido da fatura que foi quitada
Ao receber subscription.regularized, reative o acesso do cliente ao produto ou serviço que havia sido suspenso por atraso.