Cancelar assinatura
Cancela uma assinatura. Ação irreversível.
O id é o único ponto de cancelamento: não existe cancelar por cliente, por produto ou em lote.
Quando o cancelamento passa a valer:
| Situação da assinatura | effective | O que acontece |
|---|---|---|
| Próxima cobrança no futuro | end_of_paid_period | O comprador mantém o acesso até o fim do período que já pagou. Nenhuma cobrança nova é feita. |
| Assinatura vencida | immediate | O cancelamento vale na hora. |
Escopo: subscriptions:cancel. Exige Idempotency-Key.
Restrições: assinaturas de parcelamento inteligente e de boleto parcelado não podem ser canceladas por aqui (422). Assinatura já cancelada também responde 422.
Limites desta rota, mais estreitos que os do resto da API: 5 requisições por minuto e 50 por dia. Além disso, um token que acumula muitas respostas 404 (busca por id que não existe ou não é seu) é bloqueado temporariamente nesta rota.
Authorizations
Token opaco no formato ticto_live_... (produção) ou ticto_test_... (sandbox). Enviado como Authorization: Bearer <token>.
Headers
UUID v4 único por operação. Garante que retries não criem recursos duplicados.
Path Parameters
ID da assinatura a cancelar.
Response
Assinatura cancelada.
Resultado do cancelamento (POST /subscriptions/{id}/cancel).