Consultar oferta pelo código
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
Response Body
curl -X GET "https://pagpolar-api.creativecode.dev.br/v1/offers/string"{
"data": {
"id": "d5e6f7a8-b9c0-4d1e-2f3a-4b5c6d7e8f9a",
"identifier": "PPP1234567890",
"title": "Plano Mensal",
"price": 197.9,
"is_active": true,
"requires_shipping": false,
"is_default": false,
"product_id": "c4d5e6f7-a8b9-4c0d-1e2f-3a4b5c6d7e8f",
"payment_methods": {
"pix": true,
"credit_card": true,
"billet": false
},
"max_credit_card_installments": 12,
"cycle": "MONTHLY",
"cycle_interval": 1,
"cycle_interval_limit": 12,
"allow_purchase_quantity": false,
"purchase_quantity_limit": 10,
"purchase_quantity_min": 1,
"expires_at": null,
"created_at": "2026-01-10T10: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"
}
}Criar oferta POST
Cria uma oferta (preço) avulsa para um produto já existente do seu catálogo. `product_id` precisa pertencer à sua conta — produtos de outro whitelabel retornam 404. Esta rota **não cria assinatura**: `cycle`/`cycle_interval` não são aceitos aqui. Toda oferta criada pela API pública é de cobrança avulsa. Limites de quantidade de compra, texto promocional, cobrança de taxas do comprador e ajuste de taxa de parcelamento também não são aceitos nesta versão — configure-os pelo painel, se necessário. `is_default` não pode ser definido pelo corpo: a primeira oferta criada para um produto é marcada automaticamente como padrão pela plataforma.
Consultar o frete de uma oferta GET
Devolve as opções de entrega de uma oferta de produto físico para um CEP. Use o `id` da opção escolhida em `shipping_option_id` na criação do pagamento. Pré-requisito, feito pelo vendedor no painel: a integração de logística cadastrada, as dimensões e o peso do produto preenchidos e pelo menos uma configuração de frete ativa. Sem configuração de frete, a consulta responde `400`. Oferta que não é de produto físico responde `200` com a lista vazia. Se a transportadora não responder, as opções de frete calculado ficam de fora e as opções grátis e de valor fixo continuam na lista.