API · Assinaturas

Cancelar assinatura

DELETE /api/crypto/v1/subscriptions/{id} — encerre a recorrência.

DELETE /api/crypto/v1/subscriptions/{id}

Autentique com X-Manage-Token, usando o token retornado na criação. O backend também aceita manageToken na query, mas prefira o cabeçalho para evitar exposição em histórico e logs.

curl -X DELETE 'https://api.caedral.com/api/crypto/v1/subscriptions/ID_DA_ASSINATURA' \
  -H 'X-Manage-Token: SEU_MANAGE_TOKEN'

200 retorna { "message": "Assinatura cancelada" }. O cancelamento altera o estado para canceled; uma solicitação repetida também retorna sucesso. A implementação desta rota não informa estorno nem cancela explicitamente uma ordem já aberta; reconcilie o ciclo separadamente.

404: assinatura não encontrada ou token inválido; 500: falha interna. A rota de pausa não retoma uma assinatura cancelada.

Exemplo de resposta 200

Os valores são ilustrativos e variam conforme o ambiente e a ordem.

{
  "message": "Assinatura cancelada"
}