# Ofertas

URL: https://staging.pagpolar.com/docs/referencia/ofertas

> Crie, consulte e altere as ofertas de um produto.

Objeto principal: **[Oferta](/docs/referencia/entidades/oferta)**.

| Campo | Tipo | Obrigatório | Nulo | Descrição |
| --- | --- | --- | --- | --- |
| `id` | texto (uuid) | não | não | Exemplo: `d5e6f7a8-b9c0-4d1e-2f3a-4b5c6d7e8f9a`. |
| `identifier` | texto | não | não | Código da oferta: prefixo `PPP` seguido de 10 dígitos. Exemplo: `PPP1234567890`. |
| `title` | texto | não | sim | Exemplo: `Plano Mensal`. |
| `price` | número | não | não | Exemplo: `197.9`. |
| `is_active` | booleano | não | não | Exemplo: `true`. |
| `requires_shipping` | booleano | não | não | true quando o produto é físico: a cobrança exige `address` e `shipping_option_id`. Consulte as opções em `GET /offers/{identifier}/shipping`. Exemplo: `false`. |
| `is_default` | booleano | não | não | Exemplo: `false`. |
| `product_id` | texto (uuid) | não | não | Exemplo: `c4d5e6f7-a8b9-4c0d-1e2f-3a4b5c6d7e8f`. |
| `payment_methods` | objeto | não | não | Meios de pagamento ligados. Cada meio 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. |
| `payment_methods.pix` | booleano | não | não | Exemplo: `true`. |
| `payment_methods.credit_card` | booleano | não | não | Exemplo: `true`. |
| `payment_methods.billet` | booleano | não | não | Exemplo: `false`. |
| `max_credit_card_installments` | inteiro | não | não | Exemplo: `12`. |
| `cycle` | enum | não | sim | null para oferta avulsa (não recorrente). Preenchido só quando a oferta é de assinatura. Valores: `DAILY`, `WEEKLY`, `MONTHLY`, `YEARLY`. Exemplo: `MONTHLY`. |
| `cycle_interval` | inteiro | não | sim | Exemplo: `1`. |
| `cycle_interval_limit` | inteiro | não | sim | null quando a assinatura não tem limite de ciclos. Exemplo: `12`. |
| `allow_purchase_quantity` | booleano | não | não | Exemplo: `false`. |
| `purchase_quantity_limit` | inteiro | não | sim | Exemplo: `10`. |
| `purchase_quantity_min` | inteiro | não | não | Exemplo: `1`. |
| `expires_at` | texto (date-time) | não | sim | Exemplo: `null`. |
| `created_at` | texto (date-time) | não | não | Exemplo: `2026-01-10T10:00:00.000Z`. |