Skip to main content
PUT
Depois de criada, a oferta é gerenciada por id. Você edita o nome, o valor (única) ou a régua inteira (recorrente), e liga/desliga a oferta com arquivar/restaurar.
id
string
required
O id (uuid) da oferta.

Editar

PUT /v1/product-offers/{id}
name
string
Novo nome. Máximo: 80 caracteres.
amount
integer
Novo valor em centavos (ofertas one_time). Mínimo 100.
interval
string
Nova cadência (ofertas recurring): monthly, quarterly, half-yearly, yearly.
trial_days
integer
Dias de teste (1 a 365).
cycles
array
A régua nova, inteira (ofertas recurring). Segue as mesmas regras da criação: começa no ciclo 1, contígua, só a última aberta.
Reescrever a régua é seguro: a régua congela na assinatura de cada cliente no momento em que ele assinou. Editar a oferta muda apenas quem assinar dali para frente. Ninguém é reprecificado.

Arquivar e restaurar

Arquivar desliga a oferta: o checkout_url dela para de aceitar novas compras, mas as ofertas irmãs do produto seguem vivas, e quem já assinou não é afetado.

Resposta

As três rotas devolvem a oferta atualizada, no mesmo formato de Criar Oferta (com cycles e checkout_url).
Posse por construção: uma oferta de outro lojista não resolve (devolve 404), mesmo com um id válido.