Skip to main content
DELETE
/
api
/
subscription-prices
/
{id}
Excluir Preço de Assinatura
curl --request DELETE \
  --url https://garu.com.br/api/subscription-prices/{id} \
  --header 'Authorization: Bearer <token>'

​
Visão Geral

Exclua um preço de assinatura. Preços com assinaturas ativas não podem ser excluídos.
Não é possível excluir preços com assinaturas ativas. Desative o preço (isActive: false) usando o endpoint de atualização em vez de excluir.

​
Exemplo de Requisição

curl -X DELETE https://garu.com.br/api/subscription-prices/456 \
  -H "Authorization: Bearer sk_test_sua_chave"

​
Resposta de Sucesso (204 No Content)

A resposta não contém corpo quando a exclusão é bem-sucedida.

​
Quando Usar

  • O preço foi criado por engano
  • O plano nunca foi utilizado
  • Não há assinaturas ativas neste preço

​
Alternativa: Desativar

Se o preço tem assinaturas ativas, desative-o em vez de excluir: 
curl -X PATCH https://garu.com.br/api/subscription-prices/456 \
  -H "Authorization: Bearer sk_test_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{"isActive": false}'
Isso impede novas assinaturas sem afetar as existentes.

​
Erros Comuns

{
  "statusCode": 400,
  "message": "Cannot delete price with active subscriptions"
}
Solução: Desative o preço em vez de excluí-lo, ou cancele todas as assinaturas primeiro.
{
  "statusCode": 404,
  "message": "Subscription price not found"
}
Solução: Verifique se o ID do preço está correto.

​
Próximos Passos

Criar Preço

Crie um novo preço de assinatura

Listar Preços

Consulte todos os preços