Skip to main content
curl -X POST "https://api.chargefy.io/v1/prices/price_123" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "is_active": false
  }'

{
  "id": "price_123",
  "object": "price",
  "created_at": "2026-05-16T14:09:27Z",
  "currency": "brl",
  "is_active": false,
  "livemode": true,
  "metadata": {},
  "name": "Mensal",
  "product": "prod_123",
  "recurring": {
    "interval": "month",
    "interval_count": 1,
    "trial_period_days": null,
    "usage_type": "licensed"
  },
  "tax_behavior": "unspecified",
  "type": "recurring",
  "unit_amount": 9990,
  "updated_at": "2026-05-16T15:02:10Z"
}
Atualiza um price com semântica de merge. Campos de valor são imutáveis: currency, unit_amount, type, recurring e product_id. Para mudar valor ou cadência, crie outro preço e desative o antigo. A resposta direta não carrega diff; quem precisa de diff lê o webhook price.updated.

​
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.

​
Parâmetros de caminho

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

​
Attributes

Todos os campos são opcionais.
​
is_active
boolean
false tira o preço de novos fluxos de compra. true reativa.
​
metadata
object
Substitui completamente o metadata atual quando enviado.
​
name
string \| null
Rótulo interno. Envie null para limpar.
​
tax_behavior
string
unspecified, inclusive ou exclusive.
curl -X POST "https://api.chargefy.io/v1/prices/price_123" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "is_active": false
  }'

​
Resposta

200 OK com o objeto price completo (mesmo shape de GET /v1/prices/:id). 
{
  "id": "price_123",
  "object": "price",
  "created_at": "2026-05-16T14:09:27Z",
  "currency": "brl",
  "is_active": false,
  "livemode": true,
  "metadata": {},
  "name": "Mensal",
  "product": "prod_123",
  "recurring": {
    "interval": "month",
    "interval_count": 1,
    "trial_period_days": null,
    "usage_type": "licensed"
  },
  "tax_behavior": "unspecified",
  "type": "recurring",
  "unit_amount": 9990,
  "updated_at": "2026-05-16T15:02:10Z"
}

​
Erros comuns

StatuscodeQuando ocorre
400invalid_requestTentativa de atualizar campo imutável (currency, unit_amount, type, recurring, product_id)
400invalid_requestis_active não-boolean; metadata não-objeto; tax_behavior inválido
404resource_missingPreço não existe nesta organização

​
Webhook

A atualização dispara price.updated com o price completo em data.object e o diff em data.previous_attributes.