Skip to main content

Visão geral

Este endpoint permite atualizar parcialmente os dados de um produto já cadastrado, como nome, preço e status.

Endpoint

curl --request PATCH \
  --url https://api.avanttifinance.com/v1/products/{product_id} \
  --header "Authorization: Bearer SEU_TOKEN_DE_ACESSO" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Plano Premium - Anual",
    "price": 99900
  }'

Parâmetros de path

product_id
string
required
Identificador único do produto a ser atualizado.

Parâmetros do corpo

name
string
Novo nome do produto.
price
integer
Novo preço do produto, em centavos.
status
string
Novo status do produto: active ou inactive.
description
string
Nova descrição do produto.

Resposta

Retorna o objeto do produto com os dados atualizados.
{
  "id": "prod_4f5e6d7c8b",
  "name": "Plano Premium - Anual",
  "price": 99900,
  "status": "active",
  "updated_at": "2026-06-11T10:00:00Z"
}
Alterar o preço de um produto não afeta cobranças e assinaturas já criadas — apenas novas cobranças geradas após a atualização.

Erros comuns

Código HTTPSignificado
400Dados inválidos no corpo da requisição
401Token de autenticação inválido ou ausente
404Produto não encontrado

Próximos passos

Listar produtos

Consulte todos os produtos cadastrados.

Deletar produto

Remova um produto da sua conta.