Criar oferta
Cria uma oferta para um produto. Você envia apenas o essencial; a Ticto preenche os ~80 campos internos com padrões seguros a partir de um preset. Escopo: offers:write. Exige Idempotency-Key.
Authorizations
Token opaco no formato ticto_live_... (produção) ou ticto_test_... (sandbox). Enviado como Authorization: Bearer <token>.
Headers
UUID v4 único por operação. Garante que retries não criem recursos duplicados.
Path Parameters
Hash do produto (identificador canônico da API, ex.: PABC123).
Body
255Preço em centavos (mín. 500 = R$5,00).
x >= 500one_time, recurring Obrigatório quando charge_type=recurring; proibido quando one_time.
Métodos aceitos. Padrão: todos.
credit_card, pix, boleto Response
Oferta criada.
Retorno de uma oferta. É o corpo devolvido ao criar (POST) e ao consultar (GET) — a resposta é a mesma. Campos como nome, tipo de cobrança e recorrência são de entrada (CreateOffer) e não são ecoados na resposta.
"offer"
Código da oferta — identificador canônico da API.
"O709D4B48"
ID numérico legado (reconcilia com a dashboard). Não é fronteira de segurança.
11
Hash do produto pai.
"PABC123"
Preço em centavos.
19900
true
Link de checkout pronto para compartilhar. Formato: base do checkout da Ticto + código da oferta.
"https://checkout.ticto.app/O709D4B48"