Produtos
Consultar um produto
GET /v1/products/{productId}
GET /v1/products/{productId}
Retorna o produto completo, incluindo todas as suas variantes com pricing.
Escopo requerido: products:read.
Requisição
curl -X GET "https://api.selectwin.io/v1/products/prd_01hqzvabc" \
-H "SelectKey: sk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ"Resposta 200 OK
{
"id": "prd_01hqzvabc",
"name": "Plano Premium",
"slug": "plano-premium",
"salesPage": "https://example.com/sales",
"description": "Full access plan",
"language": "pt-BR",
"enabled": true,
"salesQty": 42,
"type": "digital",
"category": "saas",
"externalReference": null,
"warrantyDays": 7,
"images": ["https://example.com/img1.png"],
"imageAssetIds": null,
"createdAt": "2026-04-12T17:56:33.000Z",
"updatedAt": "2026-04-12T17:56:33.000Z",
"variants": [
{
"id": "var_01hqzvabc",
"productId": "prd_01hqzvabc",
"name": "Mensal",
"slug": "mensal",
"description": "Monthly billing",
"sku": "SKU-M",
"primary": true,
"enabled": true,
"pricing": {
"unitPrice": 9900,
"oldPrice": null,
"costPerItem": 5000,
"currency": "BRL",
"schema": "unit",
"type": "recurring",
"billingType": "prepaid",
"billingFrequency": "monthly",
"billingFrequencyCount": 1
},
"images": null,
"metadata": null,
"attributes": null,
"externalReference": null,
"checkoutUrl": null,
"createdAt": "2026-04-12T17:56:33.000Z",
"updatedAt": "2026-04-12T17:56:33.000Z"
}
]
}Cada variante embutida no produto traz o objeto completo (incluindo
productId,slug,primary,pricing.costPerItem,metadata,attributesecheckoutUrl) — o mesmo objeto retornado na leitura individual da variante (GET /v1/variants/{variantId}, veja Variantes). Campos não aplicáveis ou ausentes vêmnull.
Erros
error.code | HTTP | Quando |
|---|---|---|
productNotFound | 404 | Produto não encontrado para esta conta |
invalidParameters | 400 | productId com prefixo/formato inválido |
Para listar vários produtos, veja Listar.
How is this guide?