curl -X POST https://pay.autorizou.dev/api/v1/products \
-H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc" \
-H "Content-Type: application/json" \
-d '{
"name": "Clube Órbita",
"soft_descriptor": "CLUBE ORBITA",
"description": "Acesso mensal ao clube."
}'
{
"id": "51655469-5e1c-4356-bf9a-d593a7d61a0a",
"name": "Clube Órbita",
"description": "Acesso mensal ao clube.",
"soft_descriptor": "CLUBE ORBITA",
"image_url": null,
"is_active": true,
"show_plan_selector": false,
"selector_url": null,
"external_reference": null,
"offers": [],
"created_at": "2026-07-20T03:16:18.000000Z",
"updated_at": "2026-07-20T03:16:18.000000Z"
}
Produtos e Ofertas
Criar Produto
Cria a vitrine que agrupa as ofertas. Criar um produto é dar um nome; o preço vive nas ofertas.
POST
/
api
/
v1
/
products
curl -X POST https://pay.autorizou.dev/api/v1/products \
-H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc" \
-H "Content-Type: application/json" \
-d '{
"name": "Clube Órbita",
"soft_descriptor": "CLUBE ORBITA",
"description": "Acesso mensal ao clube."
}'
{
"id": "51655469-5e1c-4356-bf9a-d593a7d61a0a",
"name": "Clube Órbita",
"description": "Acesso mensal ao clube.",
"soft_descriptor": "CLUBE ORBITA",
"image_url": null,
"is_active": true,
"show_plan_selector": false,
"selector_url": null,
"external_reference": null,
"offers": [],
"created_at": "2026-07-20T03:16:18.000000Z",
"updated_at": "2026-07-20T03:16:18.000000Z"
}
O produto é a vitrine. Ele reúne as ofertas e, sozinho, não cobra nada. Criar é simples: o mínimo é um nome.
Parâmetros da Requisição
string
required
Nome do produto. Máximo: 255 caracteres.
string
Descrição exibida no checkout. Padrão: o próprio nome.
string
O que aparece na fatura do cartão do comprador. Máximo: 13 caracteres. Padrão: derivado do nome.
string
URL de uma imagem do produto (exibida no checkout). Deve ser uma URL válida.
string
Seu identificador do produto (para conciliar com o seu sistema). Máximo: 255 caracteres.
boolean
default:"false"
Quando
true, o produto ganha um selector_url que mostra todas as ofertas recorrentes lado a lado para o cliente escolher.Resposta
string
UUID do produto (use nas demais rotas).
string
Nome do produto.
string
Descrição.
string
Descritor na fatura.
string
URL da imagem (ou
null).boolean
Se o produto está ativo.
boolean
Se o seletor de ofertas está ligado.
string
URL do seletor de ofertas (
/s/p/{hash}), quando show_plan_selector é true; senão null.string
Seu identificador (ou
null).array
As ofertas do produto (vazio ao criar). Ver Criar Oferta.
curl -X POST https://pay.autorizou.dev/api/v1/products \
-H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc" \
-H "Content-Type: application/json" \
-d '{
"name": "Clube Órbita",
"soft_descriptor": "CLUBE ORBITA",
"description": "Acesso mensal ao clube."
}'
{
"id": "51655469-5e1c-4356-bf9a-d593a7d61a0a",
"name": "Clube Órbita",
"description": "Acesso mensal ao clube.",
"soft_descriptor": "CLUBE ORBITA",
"image_url": null,
"is_active": true,
"show_plan_selector": false,
"selector_url": null,
"external_reference": null,
"offers": [],
"created_at": "2026-07-20T03:16:18.000000Z",
"updated_at": "2026-07-20T03:16:18.000000Z"
}
Rotas relacionadas
Todas escopadas ao seu merchant: um produto de outro lojista não resolve (devolve404).
| Método | Rota | O que faz |
|---|---|---|
GET | /v1/products | Lista os seus produtos (paginado), cada um com suas ofertas. |
GET | /v1/products/{id} | Um produto e suas ofertas (com checkout_url de cada). |
PUT | /v1/products/{id} | Edita nome, descrição, imagem, show_plan_selector etc. |
DELETE | /v1/products/{id} | Remove o produto. |
GET | /v1/products/{id}/offers | Lista as ofertas do produto. |
POST | /v1/products/{id}/offers | Cria uma oferta. |