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.

POST /api/v2/products/{hash}/offers

cURL

pagamento-unico

curl --request POST \
  --url https://api.ticto.cloud/api/v2/products/{hash}/offers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "name": "Oferta padrão",
  "price": 19900,
  "charge_type": "one_time",
  "payment_methods": [
    "credit_card",
    "pix",
    "boleto"
  ]
}
'

201

{
  "object": "offer",
  "id": "O709D4B48",
  "reference_id": 11,
  "product_id": "PABC123",
  "price": 19900,
  "is_active": true,
  "checkout_url": "https://checkout.ticto.app/O709D4B48",
  "created_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

Token opaco no formato ticto_live_... (produção) ou ticto_test_... (sandbox). Enviado como Authorization: Bearer <token>.

Headers

Idempotency-Key · string<uuid> · required

UUID v4 único por operação. Garante que retries não criem recursos duplicados.

Path Parameters

hash · string · required

Hash do produto (identificador canônico da API, ex.: PABC123).

Body

application/json

name · string · required

Maximum string length: 255

price · integer · required

Preço em centavos (mín. 500 = R$5,00).

Required range: x >= 500

charge_type · enum<string> · required

Available options: one_time, recurring

recurrence · object

Obrigatório quando charge_type=recurring; proibido quando one_time.

Show child attributes

payment_methods · enum<string>[]

Métodos aceitos. Padrão: todos.

Available options: credit_card, pix, boleto

Response

201

application/json

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.

object · string

Example:

"offer"

id · string

Código da oferta — identificador canônico da API.

Example:

"O709D4B48"

reference_id · integer

ID numérico legado (reconcilia com a dashboard). Não é fronteira de segurança.

Example:

11

product_id · string

Hash do produto pai.

Example:

"PABC123"

price · integer

Preço em centavos.

Example:

19900

is_active · boolean

Example:

true

checkout_url · string

Link de checkout pronto para compartilhar. Formato: base do checkout da Ticto + código da oferta.

Example:

"https://checkout.ticto.app/O709D4B48"

created_at · string<date-time>