subscription.delayed

Disparado quando uma assinatura é suspensa por falhas consecutivas de cobrança (cartão recusado, etc.).

Quando é disparado

• O job de renovação tenta cobrar e o pagamento falha.
• Após um número configurado de falhas (ex.: 3), a assinatura passa para status suspended e este evento é disparado.

Exemplo de payload

{
  "event": "subscription.delayed",
  "data": {
    "subscriptionId": "uuid-da-assinatura",
    "productId": "uuid-do-produto",
    "productName": "Nome do Produto",
    "amount": 47.00,
    "currency": "BRL",
    "frequency": "monthly",
    "customer": {
      "email": "cliente@email.com",
      "name": "Nome do Cliente",
      "document": "12345678900",
      "phone": "11999999999"
    },
    "failureCount": 3,
    "lastFailureDate": "2025-01-28T17:00:00.000Z",
    "status": "suspended",
    "error": "Cartão recusado"
  },
  "timestamp": "2025-01-28T17:00:00.000Z",
  "webhookId": "uuid-do-webhook"
}

Campos do data

Campo	Tipo	Descrição
subscriptionId	string	ID da assinatura no TukanoPay.
productId	string	ID do produto.
productName	string	Nome do produto.
amount	number	Valor da assinatura em reais.
currency	string	Moeda.
frequency	string	Frequência (ex.: monthly).
customer	object	Dados do assinante.
failureCount	number	Quantidade de falhas consecutivas.
lastFailureDate	string	Data da última falha em ISO 8601.
status	string	Status da assinatura (ex.: suspended).
error	string	Mensagem do último erro de cobrança.