PUT
/api/v1/offers/{id}Atualizar Oferta
Atualiza campos da oferta. Apenas os enviados no body são modificados.
Escopowrite + offers
Parâmetros de caminho
| Parâmetro | Tipo | Descrição |
|---|---|---|
id required | uuid | ID da oferta. |
Corpo da requisição
| Parâmetro | Tipo | Descrição |
|---|---|---|
name | string | Nome interno. |
description | string | Descrição. |
price | number | Preço final. |
checkout_url | string | Slug do checkout. |
allow_pix | boolean | Aceita Pix? |
allow_credit_card | boolean | Aceita cartão? |
allow_boleto | boolean | Aceita boleto? |
require_address | boolean | Exige endereço? |
max_installments | integer | Máximo de parcelas. |
installments_without_interest | integer | Sem juros até. |
interest_rate | number | Juros mensal %. |
min_installment_value | number | Valor mínimo de parcela. |
is_subscription | boolean | É recorrente? |
subscription_interval | string | Intervalo de cobrança. |
status | string | active | inactive. |
Exemplo de requisição
bash
curl -X PUT https://devexpay-v3.vercel.app/api/v1/offers/cdc93c57-... \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "price": 397.00, "max_installments": 10 }'Resposta
json
{
"id": "cdc93c57-...",
"price": 397.00,
"max_installments": 10,
"updated_at": "2026-06-08T11:30:00Z"
}Erros possíveis
| Status | Descrição |
|---|---|
| 404 | Oferta não encontrada. |