subscription.renewed
Disparado quando uma assinatura é criada (primeira cobrança) ou renovada (cobranças recorrentes).
Quando é disparado
- Cliente assina um plano e a primeira cobrança é aprovada.
- O job de renovação cobra a próxima parcela e o pagamento é aprovado.
Exemplo de payload
{
"event": "subscription.renewed",
"data": {
"subscriptionId": "uuid-da-assinatura",
"transactionId": "uuid-da-transacao",
"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"
},
"currentPeriodStart": "2025-01-28T00:00:00.000Z",
"currentPeriodEnd": "2025-02-28T00:00:00.000Z",
"nextBillingDate": "2025-02-28T00:00:00.000Z",
"status": "active",
"createdAt": "2025-01-28T12:00:00.000Z"
},
"timestamp": "2025-01-28T12:00:00.000Z",
"webhookId": "uuid-do-webhook"
}
Campos do data
| Campo | Tipo | Descrição |
|---|---|---|
subscriptionId | string | ID da assinatura no TukanoPay. |
transactionId | string | ID da transação desta cobrança. |
productId | string | ID do produto. |
productName | string | Nome do produto. |
amount | number | Valor cobrado em reais. |
currency | string | Moeda. |
frequency | string | Frequência: monthly, yearly, etc. |
customer | object | Dados do assinante. |
currentPeriodStart | string | Início do período vigente em ISO 8601. |
currentPeriodEnd | string | Fim do período vigente em ISO 8601. |
nextBillingDate | string | Próxima data de cobrança em ISO 8601. |
status | string | Status da assinatura (ex.: active). |
createdAt | string | Data de criação da transação em ISO 8601. |