Atualizar um preço

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

{
  "id": "price_QNjfpEBuo53tWCY3",
  "object": "price",
  "compare_at_amount": null,
  "created_at": "2026-05-16T14:09:27Z",
  "currency": "brl",
  "is_active": false,
  "livemode": true,
  "metadata": {},
  "name": "Mensal",
  "product": "prod_QifDJ3R6oFJZW3j2",
  "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 dessa plataforma.

Parâmetros de caminho

integer | null

Preço de referência em centavos, maior que unit_amount, ou null para remover. Exemplo: 149700 com unit_amount=29700 permite exibir “De R

1.497 por R

297”. Só aparece quando checkout_experience.show_compare_at_amount=true. Não altera a cobrança. Pode ser editado; sessões já criadas conservam a referência original.

string

obrigatório

ID do preço (price_*).

Attributes

Todos os campos são opcionais.

boolean

false tira o preço de novos fluxos de compra. true reativa.

object

Substitui completamente o metadata atual quando enviado.

string \| null

Rótulo interno. Envie null para limpar.

string

Como o imposto se relaciona ao valor.

Valor	Descrição
`unspecified`	Comportamento de imposto não definido.
`inclusive`	Imposto já incluso no valor.
`exclusive`	Imposto somado ao valor.

curl -X POST "https://api.chargefy.io/v1/prices/price_QNjfpEBuo53tWCY3" \
  -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_QNjfpEBuo53tWCY3",
  "object": "price",
  "compare_at_amount": null,
  "created_at": "2026-05-16T14:09:27Z",
  "currency": "brl",
  "is_active": false,
  "livemode": true,
  "metadata": {},
  "name": "Mensal",
  "product": "prod_QifDJ3R6oFJZW3j2",
  "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

Status	`code`	Quando ocorre
`400`	`invalid_request`	Tentativa de atualizar campo imutável (`currency`, `unit_amount`, `type`, `recurring`, `product_id`)
`400`	`invalid_request`	`is_active` não-boolean; `metadata` não-objeto; `tax_behavior` inválido
`404`	`resource_missing`	Preç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.

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

{
  "id": "price_QNjfpEBuo53tWCY3",
  "object": "price",
  "compare_at_amount": null,
  "created_at": "2026-05-16T14:09:27Z",
  "currency": "brl",
  "is_active": false,
  "livemode": true,
  "metadata": {},
  "name": "Mensal",
  "product": "prod_QifDJ3R6oFJZW3j2",
  "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"
}

Fundamentos da API

MCP

Objetos de sistema

Webhooks e eventos

SDKs

Atualizar um preço

Autenticação

Parâmetros de caminho

Attributes

Resposta

Erros comuns

Webhook

​Autenticação

​Parâmetros de caminho

​Attributes

​Resposta

​Erros comuns

​Webhook

Autenticação

Parâmetros de caminho

Attributes

Resposta

Erros comuns

Webhook