Skip to main content
POST
Cancelar Assinatura
Permite cancelar uma assinatura ativa. O cancelamento será agendado para a data da próxima cobrança, garantindo que o cliente tenha acesso até o fim do período pago.
Importante: O cancelamento não é imediato. A assinatura será cancelada na data da próxima cobrança (next_charge_at), permitindo que o cliente aproveite o período já pago.

Parâmetros da Requisição

string
required
UUID da assinatura a ser cancelada Formato: UUID válido Exemplo: "550e8400-e29b-41d4-a716-446655440000"
string
required
Data/hora em que o cancelamento foi solicitado Formato: ISO 8601 Exemplo: "2024-01-15T14:30:00Z"
string
required
Motivo do cancelamento (mínimo 3 caracteres) Exemplos: "Cliente solicitou", "Mudança de plano", "Insatisfação com o serviço"

Exemplos de Requisição

Resposta

string
Mensagem de sucesso ou erro do cancelamento

Exemplos de Resposta

200 OK - Sucesso
500 Internal Server Error - Erro

Códigos de Status

Fluxo de Cancelamento

O que acontece ao cancelar?

  1. Status atualizado para cancelation_requested
  2. Data de cancelamento definida para next_charge_at (próxima cobrança)
  3. Cliente mantém acesso até a data de cancelamento
  4. Cobranças futuras são automaticamente canceladas
  5. Webhook enviado informando o cancelamento

Timeline do Cancelamento

Próximos Passos

Após cancelar uma assinatura:
  1. Envie email de confirmação ao cliente
  2. Configure webhook para o evento subscription.inactivated
  3. Revogue acessos na data de canceled_at
  4. Considere pesquisa de satisfação para entender motivo