Referência da API

Listar ofertas do produto

Atalho para listar as Offers de um Product específico. Equivalente a `GET /v2/offers?productId=:id`. A diferença: este endpoint **valida ownership do Product primeiro** (404 se o Product não é seu), evitando exposição lateral via productId.

GET/v2/products/:id/offers

Autenticação

HTTP Basic Auth. Envie sua secret key no header:

Authorization: Basic {base64(secret:SUA_SECRET_KEY)}

Parâmetros

idstring (path, UUID)obrigatório

UUID do produto.

Exemplo: prd_111aaa-bbb-ccc

activeboolean (query, string)opcional

Filtra por offers ativas. Sem o parâmetro, retorna todas (mas só não-deletadas).

Exemplo: true

pagenumber (query, 0-indexed)opcional

Página. Padrão: 0.

Exemplo: 0

limitnumber (query)opcional

Por página. Padrão: 20. Máximo: 100.

Exemplo: 20

Respostas

200

Lista paginada de Offers desse Product.

JSON

{
  "result": [
    {
      "id": "off_xyz789",
      "externalId": null,
      "name": "Pagamento único",
      "description": "Acesso vitalício",
      "amount": 49700,
      "billingCycle": null,
      "billingCycleCount": 1,
      "maxCycles": null,
      "trialDays": 0,
      "deliveryPdfUrl": null,
      "active": true,
      "createdAt": "2026-05-26T14:35:00.000Z"
    },
    {
      "id": "off_abc123",
      "name": "Mensal 12x",
      "amount": 4900,
      "billingCycle": "MONTHLY",
      "billingCycleCount": 1,
      "maxCycles": 12,
      "trialDays": 7,
      "active": true,
      "createdAt": "2026-05-26T14:38:00.000Z"
    }
  ],
  "totalCount": 2
}

404

Produto não encontrado na sua conta.

JSON

{ "status": 404, "error": "Produto nao encontrado" }

Exemplos

cURL

curl -X GET "https://api.pagnovo.com/v2/products/prd_111aaa-bbb-ccc/offers?active=true" \
  -H "Authorization: Basic $(echo -n 'secret:SUA_SECRET_KEY' | base64)"