Skip to main content
Remove um price quando ele nunca foi usado. Se o preço já estiver referenciado por histórico financeiro, checkout ou assinatura, a Chargefy desativa o preço automaticamente com is_active=false e retorna o objeto completo atualizado em vez do shape curto de remoção.

​
Delete ou arquivamento: como decidimos

Você sempre chama a mesma rota, e a Chargefy escolhe o caminho seguro por você:
  • Nunca foi usado → o preço é removido de verdade. A resposta traz deleted: true.
  • Já teve venda, checkout ou assinatura → o preço é arquivado (is_active=false) em vez de apagado. A resposta traz o objeto completo com is_active: false.
Fazemos assim para nunca quebrar o histórico. Cobranças e assinaturas que já usaram aquele preço precisam continuar apontando para ele; apagar deixaria faturas e relatórios sem referência. Arquivar tira o preço de novos checkouts e assinaturas sem afetar nada que já foi cobrado.
É por isso que, para mudar de valor, você cria um preço novo e arquiva o antigo (is_active=false) — em vez de editar o valor. Assim as assinaturas ativas seguem no preço antigo e as novas pegam o novo, sem perder o histórico.

​
Autenticação

A API key da própria organização atua diretamente. A API key de plataforma exige o header Organization: <organization_id> apontando para uma organização conectada ativa dessa plataforma.

​
Parâmetros de caminho

​
string
required
ID do preço (price_*).

​
Resposta

200 OK com um destes dois shapes: Quando dá pra remover de verdade — objeto curto de remoção:
Quando o preço precisava permanecer auditável — mesmo shape de GET /v1/prices/:id com is_active=false.

​
Erros comuns

​
Webhook

Quando o preço é desativado em vez de removido, dispara price.updated com previous_attributes.is_active = true.