PagnovoPagnovodocs

Referência da API

Buscar oferta

Retorna a Offer completa com o Product vinculado e um bloco `stats` que inclui `canEditSnapshotFields` — `true` se a Offer não tem dependentes ativos e você pode editar `amount`/`billingCycle`/etc; `false` caso contrário.

GET/v2/offers/:id

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 da Offer.

Exemplo: off_xyz789

Respostas

200

Offer encontrada com Product embedded e stats.

JSON
{
  "id": "off_xyz789",
  "productId": "prd_111aaa-bbb-ccc",
  "name": "Mensal 12x",
  "amount": 4900,
  "billingCycle": "MONTHLY",
  "billingCycleCount": 1,
  "maxCycles": 12,
  "trialDays": 7,
  "active": true,
  "createdAt": "2026-05-26T14:38:00.000Z",
  "product": {
    "id": "prd_111aaa-bbb-ccc",
    "name": "Curso de Marketing Digital",
    "description": "...",
    "imageUrl": "..."
  },
  "stats": {
    "activeSubscriptions": 47,
    "activePaymentLinks": 2,
    "canEditSnapshotFields": false
  }
}
404

Offer não encontrada.

JSON
{ "status": 404, "error": "Oferta nao encontrada" }

Exemplos

cURL
curl -X GET "https://api.pagnovo.com/v2/offers/off_xyz789" \
  -H "Authorization: Basic $(echo -n 'secret:SUA_SECRET_KEY' | base64)"