Produtos e Ofertas
Criar Oferta
Cria uma oferta no produto: única (um preço) ou recorrente (assinatura com régua de preços). Devolve o checkout_url pronto.
POST
A oferta é o que o cliente compra. Ela nasce com um
checkout_url pronto para compartilhar. Uma oferta é de um dos dois tipos:
one_time: cobrança única. Só precisa denameeamount.recurring: assinatura. Precisa deintervale da régua de ciclos (cycles).
O
id (uuid) do produto que recebe a oferta.Parâmetros da Requisição
Tipo da oferta. Valores:
one_time, recurring.Nome da oferta (ex.: “Mensal”, “Anual”, “Vitalício”). Máximo: 80 caracteres.
Valor em centavos. Obrigatório para
one_time. Mínimo: 100 (R$ 1,00).Exemplo: 39900 = R$ 399,00Cadência da assinatura. Obrigatório para
recurring.Valores: monthly, quarterly, half-yearly, yearly.Dias de teste grátis antes da primeira cobrança. Mínimo:
1 | Máximo: 365.A régua de preços. Obrigatória para
recurring. Uma lista de faixas, de 1 a 50, contígua a partir do ciclo 1.Resposta
UUID da oferta.
Hash público da oferta (base do
checkout_url).one_time ou recurring.Nome da oferta.
Se a oferta está ativa (ver arquivar/restaurar).
O preço em centavos. Em
recurring, é a faixa estável (a última da régua), útil para exibir “a partir de”.Sempre
BRL.A cadência, em
recurring; null em one_time.Dias de teste.
A régua devolvida faixa a faixa (vazia em
one_time). end: null na última = “em diante”.O link pronto de checkout.
/s/{hash} para recurring, /c/{hash} para one_time.E agora?
Ocheckout_url já funciona: compartilhe e receba. Para vender por API (você já tem cliente e cartão), use o id da oferta como offer_id em POST /charges/subscriptions.