Skip to main content
Uma oferta é um plano de precificação vinculado a um produto. Ela define quanto o cliente paga, como paga e em quais condições. Um mesmo produto pode ter múltiplas ofertas, como um preço promocional para lançamento e um preço cheio permanente. Este guia cobre a criação de ofertas de pagamento único, onde o cliente é cobrado uma única vez no momento da compra.

​
Criando uma oferta de pagamento único

1

Obtenha o hash do produto

Você precisa do hash do produto ao qual deseja vincular a oferta. Esse valor está disponível no campo hash da resposta ao criar um produto via POST /products, ou pode ser consultado na listagem de produtos pelo painel ou pela API.
2

Prepare o payload

Monte o corpo da requisição com o nome da oferta, o preço em centavos e o tipo de cobrança. Para pagamento único, use charge_type: "one_time".
O valor 19700 representa R$ 197,00. O preço mínimo aceito é 500 (R$ 5,00).
3

Envie a requisição

Faça um POST para /api/v2/products/{hash}/offers, substituindo {hash} pelo hash do produto. Inclua o Idempotency-Key para evitar duplicações em caso de retentativas.
4

Use o checkout_url

Uma resposta 201 Created confirma a criação da oferta. O campo checkout_url já está pronto para ser compartilhado com seus clientes ou integrado ao seu site.
O id da oferta (O709D4B48) é o code, o identificador canônico usado no checkout_url. A oferta nasce ativa (is_active: true) e pode ser usada imediatamente. Campos de entrada como name e charge_type não são repetidos na resposta.

​
Campos da oferta

​
string
required
Nome da oferta exibido no checkout e nos relatórios. Use um nome descritivo, como “Plano Básico” ou “Oferta de Lançamento”.
​
integer
required
Preço em centavos (inteiro). Mínimo: 500 (R$ 5,00). Exemplos: 19700 = R$ 197,00 · 9990 = R$ 99,90 · 50000 = R$ 500,00.
​
string
required
Tipo de cobrança. Use one_time para pagamento único. Para assinaturas recorrentes, consulte o guia de ofertas recorrentes.
O campo checkout_url na resposta é o link de checkout pronto para compartilhar com seus clientes. Guarde-o na sua central após criar a oferta, assim você não precisará consultar a API novamente para obtê-lo.

​
Métodos de pagamento padrão

Para produtos digitais (course, ebook, mentoring etc.), a Ticto configura automaticamente os métodos de pagamento mais utilizados no mercado brasileiro. Nenhuma configuração adicional é necessária: A Ticto preenche automaticamente essas configurações para maximizar sua conversão sem nenhuma configuração manual.

Ofertas Recorrentes

Aprenda a configurar planos de assinatura com intervalo, trial gratuito e número de ciclos.

Referência: Criar Oferta

Veja todos os campos disponíveis e exemplos de resposta na referência completa do endpoint.