Editar oferta
Edita campos comerciais de uma oferta já criada. Envie apenas os campos que deseja atualizar (edição parcial) — o corpo não pode vir vazio.
Diferente da consulta (GET /offers/{identifier}, que usa o código da oferta, PPP seguido de 10 dígitos), esta
rota identifica a oferta pelo id (uuid).
Não é possível alterar product_id, cycle/cycle_interval (assinatura) ou
is_default por aqui — a troca de oferta padrão continua sendo feita apenas pelo painel.
Sem campo de autorização: o portal autentica por você com a sua chave de Homologação e as requisições rodam só no ambiente de testes.
Token de acesso devolvido por POST /auth/token. Envie como "Authorization: Bearer ". Vale 24 horas.
In: header
Path Parameters
uuidPreço da oferta em centavos, número inteiro — a mesma unidade de offer.value. 4990 = R$ 49,90. Valor com casas decimais retorna 400.
0 <= valuePIX. Mínimo de R$ 5,00. Os três meios começam ligados, mas cada um só fica ligado se o preço atinge o mínimo dele: PIX R$ 5,00, cartão R$ 5,00 e boleto R$ 10,00. Abaixo do mínimo, o meio é desligado ao salvar, mesmo enviando true. Envie false para desligar um meio acima do mínimo. Na edição sem price, só os meios enviados são recalculados; com price, os três são recalculados.
trueCartão de crédito. Mínimo de R$ 5,00. Os três meios começam ligados, mas cada um só fica ligado se o preço atinge o mínimo dele: PIX R$ 5,00, cartão R$ 5,00 e boleto R$ 10,00. Abaixo do mínimo, o meio é desligado ao salvar, mesmo enviando true. Envie false para desligar um meio acima do mínimo. Na edição sem price, só os meios enviados são recalculados; com price, os três são recalculados.
trueBoleto. Mínimo de R$ 10,00. Os três meios começam ligados, mas cada um só fica ligado se o preço atinge o mínimo dele: PIX R$ 5,00, cartão R$ 5,00 e boleto R$ 10,00. Abaixo do mínimo, o meio é desligado ao salvar, mesmo enviando true. Envie false para desligar um meio acima do mínimo. Na edição sem price, só os meios enviados são recalculados; com price, os três são recalculados.
trueMáximo de parcelas no cartão de crédito. O valor de cada parcela (price / max_credit_card_installments) não pode ficar abaixo de R$ 5,00 — abaixo disso, a criação/edição retorna 400.
Response Body
curl -X PATCH "https://pagpolar-api.creativecode.dev.br/v1/offers/d5e6f7a8-b9c0-4d1e-2f3a-4b5c6d7e8f9a" \ -H "Content-Type: application/json" \ -d '{ "price": 24790, "title": "Plano Mensal Promocional" }'{
"data": {
"id": "d5e6f7a8-b9c0-4d1e-2f3a-4b5c6d7e8f9a",
"identifier": "PPP1234567890",
"title": "Plano Mensal Promocional",
"price": 247.9,
"is_active": true,
"is_default": false,
"product_id": "c4d5e6f7-a8b9-4c0d-1e2f-3a4b5c6d7e8f",
"payment_methods": {
"pix": true,
"credit_card": true,
"billet": false
},
"max_credit_card_installments": 6,
"cycle": null,
"cycle_interval": null,
"cycle_interval_limit": null,
"allow_purchase_quantity": false,
"purchase_quantity_limit": null,
"purchase_quantity_min": 1,
"expires_at": null,
"created_at": "2026-01-15T12:00:00.000Z"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}{
"error": {
"code": "invalid_request",
"message": "string",
"request_id": "string"
}
}