PATCH /api/v1/products/:id

Atualiza campos de um produto existente

Atualiza um produto. Apenas os campos enviados são modificados.

Este endpoint não cria nem modifica preços. Para manipular preços use POST /v1/prices ou PATCH /v1/prices/:id. Pra apontar o default_price_id pra um preço existente, envie o ID aqui.

​

Autenticação

Requer um token de acesso válido (CHARGEFY_ACCESS_TOKEN) no header Authorization.

​

Path

Parâmetro	Tipo	Obrigatório	Descrição
id	string	Sim	ID do produto

​

Body

name · string

Novo nome do produto.

description · string

Nova descrição (Markdown suportado).

metadata · object

Metadata livre. Substitui o objeto existente (não faz merge).

is_archived · boolean

Arquivar (true) ou desarquivar (false) o produto inteiro.

is_tax_applicable · boolean

Ajusta a flag de tributação.

default_price_id · string

Aponta o default pra outro preço existente do mesmo produto. Deve estar active.

​

Resposta

Retorna o produto completo atualizado — mesmo shape que Obter Produto.

​

Exemplo

cURL

curl -X PATCH "https://api.chargefy.io/api/v1/products/prod_abc123" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Plano Pro Plus",
    "default_price_id": "price_y002"
  }'