Skip to main content
PATCH
Atualizar Produto

Visão Geral

Use este endpoint para atualizar as informações de um produto existente. Apenas os campos enviados serão atualizados.

Parâmetros de Path

string
required
UUID do produto a ser atualizado.

Parâmetros do Body

Todos os campos são opcionais. Envie apenas os que deseja atualizar.
string
Novo nome do produto.
string
Nova descrição do produto.
number
Novo preço do produto em Reais (BRL decimal, ex: 347.00), nunca em centavos. Envie 0 para deixar o produto sem preço; qualquer outro preço precisa ser de **pelo menos R5,00∗∗.DeR 5,00**. De R 0,01 a R$ 4,99, ou um valor negativo, a API responde 400.Omita o campo para manter o preço atual. A regra do mínimo só vale quando o pedido define um preço: um produto que já custava menos de R$ 5,00 continua vendendo, e um pedido que só troca o nome ou liga o PIX passa normalmente.
boolean
Habilitar/desabilitar pagamento via PIX.
boolean
Habilitar/desabilitar pagamento via cartão de crédito.
boolean
Habilitar/desabilitar pagamento via boleto.
boolean
Habilitar/desabilitar o Pix Automático (débito recorrente do Pix) no produto. Enviar false impede novas assinaturas por Pix Automático nesse produto; as assinaturas já ativas continuam sendo cobradas normalmente.
number
Novo número máximo de parcelas (1-12).
string
Nova URL da imagem do produto.
string
Nova URL de retorno após pagamento.
string
Novo texto do botão de retorno.
boolean
Transforma o produto em assinatura (true) ou em venda avulsa (false). Transformar um produto de assinatura em venda avulsa conta como definir o preço: o value guardado nele passa a ser o preço do link, e precisa ser 0 ou pelo menos R$ 5,00.

Exemplo de Requisição

Resposta de Sucesso (200 OK)

O uuid do produto não muda ao atualizar. O link de pagamento permanece o mesmo.

Erros Comuns

Solução: Envie um value de pelo menos 5.00, ou 0 para deixar o produto sem preço. Se você não quer mudar o preço, não envie value.
Solução: Verifique se o UUID do produto está correto.
Solução: Você só pode atualizar produtos criados com sua conta.

Próximos Passos

Excluir Produto

Desative um produto

Webhooks

Receba notificações de eventos