Criar oferta para produto
curl --request POST \
--url https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers \
--header 'Content-Type: application/json' \
--header 'X-Api-Client-Token: <api-key>' \
--data '
{
"name": "Oferta Premium",
"price": 49999999,
"allow_pix": true,
"allow_bank_slip": true,
"allow_credit_card": true,
"quantity_items": 50,
"allow_pix_recurring": true,
"pix_recurring_frequency": "monthly",
"pix_recurring_authorization_type": "monthly_auth_monthly_retry",
"allow_bank_slip_installments": true,
"bank_slip_days_due": 4,
"bank_slip_installments_limit": 6,
"credit_card_installments_options": [
18
],
"allow_affiliates": true,
"custom_commission": true,
"commission_only_first_installment": true,
"affiliates_subscription_percentage": 40.5,
"transfer_fixed_fee_to_buyer": true,
"allow_smart_installment": true,
"producer_pays_interest": true,
"subscription": {
"trial_days": 182,
"trial_days_text": true,
"first_charge_price": 49999999,
"is_extension": true,
"extension_length": 18,
"max_charges": 6,
"max_charges_attempts": 3
}
}
'import requests
url = "https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers"
payload = {
"name": "Oferta Premium",
"price": 49999999,
"allow_pix": True,
"allow_bank_slip": True,
"allow_credit_card": True,
"quantity_items": 50,
"allow_pix_recurring": True,
"pix_recurring_frequency": "monthly",
"pix_recurring_authorization_type": "monthly_auth_monthly_retry",
"allow_bank_slip_installments": True,
"bank_slip_days_due": 4,
"bank_slip_installments_limit": 6,
"credit_card_installments_options": [18],
"allow_affiliates": True,
"custom_commission": True,
"commission_only_first_installment": True,
"affiliates_subscription_percentage": 40.5,
"transfer_fixed_fee_to_buyer": True,
"allow_smart_installment": True,
"producer_pays_interest": True,
"subscription": {
"trial_days": 182,
"trial_days_text": True,
"first_charge_price": 49999999,
"is_extension": True,
"extension_length": 18,
"max_charges": 6,
"max_charges_attempts": 3
}
}
headers = {
"X-Api-Client-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Client-Token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Oferta Premium',
price: 49999999,
allow_pix: true,
allow_bank_slip: true,
allow_credit_card: true,
quantity_items: 50,
allow_pix_recurring: true,
pix_recurring_frequency: 'monthly',
pix_recurring_authorization_type: 'monthly_auth_monthly_retry',
allow_bank_slip_installments: true,
bank_slip_days_due: 4,
bank_slip_installments_limit: 6,
credit_card_installments_options: [18],
allow_affiliates: true,
custom_commission: true,
commission_only_first_installment: true,
affiliates_subscription_percentage: 40.5,
transfer_fixed_fee_to_buyer: true,
allow_smart_installment: true,
producer_pays_interest: true,
subscription: {
trial_days: 182,
trial_days_text: true,
first_charge_price: 49999999,
is_extension: true,
extension_length: 18,
max_charges: 6,
max_charges_attempts: 3
}
})
};
fetch('https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Oferta Premium',
'price' => 49999999,
'allow_pix' => true,
'allow_bank_slip' => true,
'allow_credit_card' => true,
'quantity_items' => 50,
'allow_pix_recurring' => true,
'pix_recurring_frequency' => 'monthly',
'pix_recurring_authorization_type' => 'monthly_auth_monthly_retry',
'allow_bank_slip_installments' => true,
'bank_slip_days_due' => 4,
'bank_slip_installments_limit' => 6,
'credit_card_installments_options' => [
18
],
'allow_affiliates' => true,
'custom_commission' => true,
'commission_only_first_installment' => true,
'affiliates_subscription_percentage' => 40.5,
'transfer_fixed_fee_to_buyer' => true,
'allow_smart_installment' => true,
'producer_pays_interest' => true,
'subscription' => [
'trial_days' => 182,
'trial_days_text' => true,
'first_charge_price' => 49999999,
'is_extension' => true,
'extension_length' => 18,
'max_charges' => 6,
'max_charges_attempts' => 3
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Client-Token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers"
payload := strings.NewReader("{\n \"name\": \"Oferta Premium\",\n \"price\": 49999999,\n \"allow_pix\": true,\n \"allow_bank_slip\": true,\n \"allow_credit_card\": true,\n \"quantity_items\": 50,\n \"allow_pix_recurring\": true,\n \"pix_recurring_frequency\": \"monthly\",\n \"pix_recurring_authorization_type\": \"monthly_auth_monthly_retry\",\n \"allow_bank_slip_installments\": true,\n \"bank_slip_days_due\": 4,\n \"bank_slip_installments_limit\": 6,\n \"credit_card_installments_options\": [\n 18\n ],\n \"allow_affiliates\": true,\n \"custom_commission\": true,\n \"commission_only_first_installment\": true,\n \"affiliates_subscription_percentage\": 40.5,\n \"transfer_fixed_fee_to_buyer\": true,\n \"allow_smart_installment\": true,\n \"producer_pays_interest\": true,\n \"subscription\": {\n \"trial_days\": 182,\n \"trial_days_text\": true,\n \"first_charge_price\": 49999999,\n \"is_extension\": true,\n \"extension_length\": 18,\n \"max_charges\": 6,\n \"max_charges_attempts\": 3\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Client-Token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers")
.header("X-Api-Client-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Oferta Premium\",\n \"price\": 49999999,\n \"allow_pix\": true,\n \"allow_bank_slip\": true,\n \"allow_credit_card\": true,\n \"quantity_items\": 50,\n \"allow_pix_recurring\": true,\n \"pix_recurring_frequency\": \"monthly\",\n \"pix_recurring_authorization_type\": \"monthly_auth_monthly_retry\",\n \"allow_bank_slip_installments\": true,\n \"bank_slip_days_due\": 4,\n \"bank_slip_installments_limit\": 6,\n \"credit_card_installments_options\": [\n 18\n ],\n \"allow_affiliates\": true,\n \"custom_commission\": true,\n \"commission_only_first_installment\": true,\n \"affiliates_subscription_percentage\": 40.5,\n \"transfer_fixed_fee_to_buyer\": true,\n \"allow_smart_installment\": true,\n \"producer_pays_interest\": true,\n \"subscription\": {\n \"trial_days\": 182,\n \"trial_days_text\": true,\n \"first_charge_price\": 49999999,\n \"is_extension\": true,\n \"extension_length\": 18,\n \"max_charges\": 6,\n \"max_charges_attempts\": 3\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Client-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Oferta Premium\",\n \"price\": 49999999,\n \"allow_pix\": true,\n \"allow_bank_slip\": true,\n \"allow_credit_card\": true,\n \"quantity_items\": 50,\n \"allow_pix_recurring\": true,\n \"pix_recurring_frequency\": \"monthly\",\n \"pix_recurring_authorization_type\": \"monthly_auth_monthly_retry\",\n \"allow_bank_slip_installments\": true,\n \"bank_slip_days_due\": 4,\n \"bank_slip_installments_limit\": 6,\n \"credit_card_installments_options\": [\n 18\n ],\n \"allow_affiliates\": true,\n \"custom_commission\": true,\n \"commission_only_first_installment\": true,\n \"affiliates_subscription_percentage\": 40.5,\n \"transfer_fixed_fee_to_buyer\": true,\n \"allow_smart_installment\": true,\n \"producer_pays_interest\": true,\n \"subscription\": {\n \"trial_days\": 182,\n \"trial_days_text\": true,\n \"first_charge_price\": 49999999,\n \"is_extension\": true,\n \"extension_length\": 18,\n \"max_charges\": 6,\n \"max_charges_attempts\": 3\n }\n}"
response = http.request(request)
puts response.read_body{
"code": "<string>",
"name": "<string>",
"type_of_charge": "one-time",
"price": 123,
"allow_credit_card": true,
"credit_card_installments_options": [
18
],
"allow_pix": true,
"allow_bank_slip": true,
"created_at": "2026-01-15 14:30:00",
"updated_at": "2026-01-15 14:30:00",
"fake_initial_price": 123,
"quantity_items": 50,
"allow_bank_slip_installments": true,
"bank_slip_days_due": 4,
"bank_slip_installments_limit": 6,
"allow_affiliates": true,
"affiliates_percentage": 40.5,
"affiliates_subscription_percentage": 40.5,
"commission_only_first_installment": true,
"producer_pays_interest": true,
"is_free": true,
"transfer_fixed_fee_to_buyer": true,
"subscription": {
"interval": "weekly",
"trial_days": 182,
"trial_days_text": true,
"first_charge_price": 123,
"is_extension": true,
"extension_length": 18,
"max_charges": 6,
"max_charges_attempts": 3
},
"freight": {
"type": "shipping_company",
"preparation_day": 123,
"start_day": 123,
"end_day": 123,
"fixed_price": 123,
"free_states": [
"<string>"
],
"blocked_states": [
"<string>"
],
"is_pac": true,
"pac_fallback_price": 123,
"pac_fallback_end_day": 123,
"is_sedex": true,
"sedex_fallback_price": 123,
"sedex_fallback_end_day": 123,
"zip_code": "<string>",
"weight": 123,
"length": 123,
"width": 123,
"height": 123
}
}Produtos
Criar oferta para produto
Cria uma nova oferta para um produto específico.
Campos obrigatórios:
price- Preço da oferta em centavos (valor mínimo aplicável)type_of_charge- Tipo de cobrança (‘unique’ ou ‘recurring’)allow_credit_card- Se aceita cartão de créditoallow_pix- Se aceita PIXallow_bank_slip- Se aceita boleto bancário
Campos obrigatórios condicionais:
credit_card_installments_options- Opções de parcelamento (obrigatório se allow_credit_card = true)bank_slip_days_due- Dias para vencimento do boleto (obrigatório se allow_bank_slip = true)subscription.interval- Intervalo da assinatura (obrigatório se type_of_charge = ‘recurring’)
Campos obrigatórios para produtos físicos (type = ‘physical’):
quantity_items- Quantidade de itens disponíveis (1-100 unidades)- Objeto
freightcom os parâmetros de frete descritos no schemaRequestOffer.freight
Regras de validação:
- Pelo menos um método de pagamento deve estar habilitado
- Para assinaturas, cartão de crédito é obrigatório se trial_days > 0
- Para assinaturas, dois cartões de crédito não são permitidos
- Preço deve respeitar o valor mínimo da moeda
POST
/
products
/
{product_hash}
/
offers
Criar oferta para produto
curl --request POST \
--url https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers \
--header 'Content-Type: application/json' \
--header 'X-Api-Client-Token: <api-key>' \
--data '
{
"name": "Oferta Premium",
"price": 49999999,
"allow_pix": true,
"allow_bank_slip": true,
"allow_credit_card": true,
"quantity_items": 50,
"allow_pix_recurring": true,
"pix_recurring_frequency": "monthly",
"pix_recurring_authorization_type": "monthly_auth_monthly_retry",
"allow_bank_slip_installments": true,
"bank_slip_days_due": 4,
"bank_slip_installments_limit": 6,
"credit_card_installments_options": [
18
],
"allow_affiliates": true,
"custom_commission": true,
"commission_only_first_installment": true,
"affiliates_subscription_percentage": 40.5,
"transfer_fixed_fee_to_buyer": true,
"allow_smart_installment": true,
"producer_pays_interest": true,
"subscription": {
"trial_days": 182,
"trial_days_text": true,
"first_charge_price": 49999999,
"is_extension": true,
"extension_length": 18,
"max_charges": 6,
"max_charges_attempts": 3
}
}
'import requests
url = "https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers"
payload = {
"name": "Oferta Premium",
"price": 49999999,
"allow_pix": True,
"allow_bank_slip": True,
"allow_credit_card": True,
"quantity_items": 50,
"allow_pix_recurring": True,
"pix_recurring_frequency": "monthly",
"pix_recurring_authorization_type": "monthly_auth_monthly_retry",
"allow_bank_slip_installments": True,
"bank_slip_days_due": 4,
"bank_slip_installments_limit": 6,
"credit_card_installments_options": [18],
"allow_affiliates": True,
"custom_commission": True,
"commission_only_first_installment": True,
"affiliates_subscription_percentage": 40.5,
"transfer_fixed_fee_to_buyer": True,
"allow_smart_installment": True,
"producer_pays_interest": True,
"subscription": {
"trial_days": 182,
"trial_days_text": True,
"first_charge_price": 49999999,
"is_extension": True,
"extension_length": 18,
"max_charges": 6,
"max_charges_attempts": 3
}
}
headers = {
"X-Api-Client-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Client-Token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Oferta Premium',
price: 49999999,
allow_pix: true,
allow_bank_slip: true,
allow_credit_card: true,
quantity_items: 50,
allow_pix_recurring: true,
pix_recurring_frequency: 'monthly',
pix_recurring_authorization_type: 'monthly_auth_monthly_retry',
allow_bank_slip_installments: true,
bank_slip_days_due: 4,
bank_slip_installments_limit: 6,
credit_card_installments_options: [18],
allow_affiliates: true,
custom_commission: true,
commission_only_first_installment: true,
affiliates_subscription_percentage: 40.5,
transfer_fixed_fee_to_buyer: true,
allow_smart_installment: true,
producer_pays_interest: true,
subscription: {
trial_days: 182,
trial_days_text: true,
first_charge_price: 49999999,
is_extension: true,
extension_length: 18,
max_charges: 6,
max_charges_attempts: 3
}
})
};
fetch('https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Oferta Premium',
'price' => 49999999,
'allow_pix' => true,
'allow_bank_slip' => true,
'allow_credit_card' => true,
'quantity_items' => 50,
'allow_pix_recurring' => true,
'pix_recurring_frequency' => 'monthly',
'pix_recurring_authorization_type' => 'monthly_auth_monthly_retry',
'allow_bank_slip_installments' => true,
'bank_slip_days_due' => 4,
'bank_slip_installments_limit' => 6,
'credit_card_installments_options' => [
18
],
'allow_affiliates' => true,
'custom_commission' => true,
'commission_only_first_installment' => true,
'affiliates_subscription_percentage' => 40.5,
'transfer_fixed_fee_to_buyer' => true,
'allow_smart_installment' => true,
'producer_pays_interest' => true,
'subscription' => [
'trial_days' => 182,
'trial_days_text' => true,
'first_charge_price' => 49999999,
'is_extension' => true,
'extension_length' => 18,
'max_charges' => 6,
'max_charges_attempts' => 3
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Client-Token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers"
payload := strings.NewReader("{\n \"name\": \"Oferta Premium\",\n \"price\": 49999999,\n \"allow_pix\": true,\n \"allow_bank_slip\": true,\n \"allow_credit_card\": true,\n \"quantity_items\": 50,\n \"allow_pix_recurring\": true,\n \"pix_recurring_frequency\": \"monthly\",\n \"pix_recurring_authorization_type\": \"monthly_auth_monthly_retry\",\n \"allow_bank_slip_installments\": true,\n \"bank_slip_days_due\": 4,\n \"bank_slip_installments_limit\": 6,\n \"credit_card_installments_options\": [\n 18\n ],\n \"allow_affiliates\": true,\n \"custom_commission\": true,\n \"commission_only_first_installment\": true,\n \"affiliates_subscription_percentage\": 40.5,\n \"transfer_fixed_fee_to_buyer\": true,\n \"allow_smart_installment\": true,\n \"producer_pays_interest\": true,\n \"subscription\": {\n \"trial_days\": 182,\n \"trial_days_text\": true,\n \"first_charge_price\": 49999999,\n \"is_extension\": true,\n \"extension_length\": 18,\n \"max_charges\": 6,\n \"max_charges_attempts\": 3\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Client-Token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers")
.header("X-Api-Client-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Oferta Premium\",\n \"price\": 49999999,\n \"allow_pix\": true,\n \"allow_bank_slip\": true,\n \"allow_credit_card\": true,\n \"quantity_items\": 50,\n \"allow_pix_recurring\": true,\n \"pix_recurring_frequency\": \"monthly\",\n \"pix_recurring_authorization_type\": \"monthly_auth_monthly_retry\",\n \"allow_bank_slip_installments\": true,\n \"bank_slip_days_due\": 4,\n \"bank_slip_installments_limit\": 6,\n \"credit_card_installments_options\": [\n 18\n ],\n \"allow_affiliates\": true,\n \"custom_commission\": true,\n \"commission_only_first_installment\": true,\n \"affiliates_subscription_percentage\": 40.5,\n \"transfer_fixed_fee_to_buyer\": true,\n \"allow_smart_installment\": true,\n \"producer_pays_interest\": true,\n \"subscription\": {\n \"trial_days\": 182,\n \"trial_days_text\": true,\n \"first_charge_price\": 49999999,\n \"is_extension\": true,\n \"extension_length\": 18,\n \"max_charges\": 6,\n \"max_charges_attempts\": 3\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Client-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Oferta Premium\",\n \"price\": 49999999,\n \"allow_pix\": true,\n \"allow_bank_slip\": true,\n \"allow_credit_card\": true,\n \"quantity_items\": 50,\n \"allow_pix_recurring\": true,\n \"pix_recurring_frequency\": \"monthly\",\n \"pix_recurring_authorization_type\": \"monthly_auth_monthly_retry\",\n \"allow_bank_slip_installments\": true,\n \"bank_slip_days_due\": 4,\n \"bank_slip_installments_limit\": 6,\n \"credit_card_installments_options\": [\n 18\n ],\n \"allow_affiliates\": true,\n \"custom_commission\": true,\n \"commission_only_first_installment\": true,\n \"affiliates_subscription_percentage\": 40.5,\n \"transfer_fixed_fee_to_buyer\": true,\n \"allow_smart_installment\": true,\n \"producer_pays_interest\": true,\n \"subscription\": {\n \"trial_days\": 182,\n \"trial_days_text\": true,\n \"first_charge_price\": 49999999,\n \"is_extension\": true,\n \"extension_length\": 18,\n \"max_charges\": 6,\n \"max_charges_attempts\": 3\n }\n}"
response = http.request(request)
puts response.read_body{
"code": "<string>",
"name": "<string>",
"type_of_charge": "one-time",
"price": 123,
"allow_credit_card": true,
"credit_card_installments_options": [
18
],
"allow_pix": true,
"allow_bank_slip": true,
"created_at": "2026-01-15 14:30:00",
"updated_at": "2026-01-15 14:30:00",
"fake_initial_price": 123,
"quantity_items": 50,
"allow_bank_slip_installments": true,
"bank_slip_days_due": 4,
"bank_slip_installments_limit": 6,
"allow_affiliates": true,
"affiliates_percentage": 40.5,
"affiliates_subscription_percentage": 40.5,
"commission_only_first_installment": true,
"producer_pays_interest": true,
"is_free": true,
"transfer_fixed_fee_to_buyer": true,
"subscription": {
"interval": "weekly",
"trial_days": 182,
"trial_days_text": true,
"first_charge_price": 123,
"is_extension": true,
"extension_length": 18,
"max_charges": 6,
"max_charges_attempts": 3
},
"freight": {
"type": "shipping_company",
"preparation_day": 123,
"start_day": 123,
"end_day": 123,
"fixed_price": 123,
"free_states": [
"<string>"
],
"blocked_states": [
"<string>"
],
"is_pac": true,
"pac_fallback_price": 123,
"pac_fallback_end_day": 123,
"is_sedex": true,
"sedex_fallback_price": 123,
"sedex_fallback_end_day": 123,
"zip_code": "<string>",
"weight": 123,
"length": 123,
"width": 123,
"height": 123
}
}Authorizations
ApiClientTokenbearerAuth
Token de autenticação do cliente obtido via endpoint /auth
Path Parameters
Hash do produto
Body
application/json
Nome da oferta.
Maximum string length:
191Example:
"Oferta Premium"
Preço da oferta em centavos.
Required range:
0 <= x <= 99999999Tipo de cobrança.
Available options:
one-time, recurring Se aceita pagamento via PIX avulso.
Se aceita boleto bancário.
Se aceita pagamento via cartão de crédito.
Quantidade de itens disponíveis em estoque.
- Obrigatório apenas para produtos do tipo 'physical'
- Limite: 1 a 100 unidades
- Opcional para produtos digitais (course, ebook)
Required range:
1 <= x <= 100Se aceita PIX Automático (débito recorrente). Necessário para vender a oferta com payment_method=pix_recurring no checkout. Só vale para ofertas recorrentes (type_of_charge=recurring).
Quando true, pix_recurring_frequency e pix_recurring_authorization_type passam a ser obrigatórios.
Pré-requisito: PIX Automático liberado para o produtor. A liberação é feita pela Ticto na conta do produtor dono do produto e não pode ser feita pela API. Solicite ao seu contato na Ticto (inclusive para o ambiente de sandbox).
Enquanto o produtor não estiver liberado, a oferta é salva com allow_pix_recurring = false mesmo que a requisição envie true: o POST/PUT responde com sucesso e o valor enviado é ignorado, sem erro. O checkout com payment_method=pix_recurring para essa oferta é recusado.
Se a liberação do produtor for revogada, o PIX Automático é desligado em todas as ofertas dele.
Os campos de PIX Automático não são devolvidos na resposta da oferta (ResponseOffer); depois de liberar o produtor, reenvie a configuração da oferta e valide com um checkout pix_recurring.
Frequência de cobrança do PIX Automático. Obrigatório quando allow_pix_recurring = true.
Available options:
weekly, biweekly, monthly, quarterly, biannual, annual Example:
"monthly"
Tipo de autorização do PIX Automático. Obrigatório quando allow_pix_recurring = true. Só a autorização mensal com retentativa mensal é aceita.
Available options:
monthly_auth_monthly_retry Example:
"monthly_auth_monthly_retry"
Se permite parcelamento no boleto (somente ofertas não recorrentes).
Número de dias para vencimento do boleto.
Required range:
1 <= x <= 7Limite máximo de parcelas no boleto.
Required range:
1 <= x <= 12Opções de parcelamento para cartão de crédito.
Required range:
1 <= x <= 36Se permite afiliação para esta oferta.
Se a oferta utiliza comissão personalizada (diferente do padrão do produto).
Se a comissão do afiliado é calculada apenas sobre a primeira parcela.
Aplicável apenas para ofertas recorrentes (type_of_charge=recurring).
Percentual de comissão do afiliado para cobranças recorrentes (renovações).
Aplicável apenas para ofertas recorrentes (type_of_charge=recurring).
Required range:
1 <= x <= 80Repassa a taxa fixa da transação (R$2,49) ao comprador.
true— o comprador paga a taxa fixa (valor adicionado ao total no checkout)false— o produtor absorve a taxa fixa- Quando não informado na criação, o padrão é
true
Habilita parcelamento inteligente no cartão de crédito. Quando true, ao recusar o cartão
por saldo insuficiente, a Ticto cria automaticamente um parcelamento. Sem juros, valor
dividido igualmente, máximo 12 parcelas, mínimo R$5 por parcela.
Se o produtor absorve os juros do parcelamento no cartão de crédito.
Configurações de assinatura (usar quando type_of_charge=recurring).
Show child attributes
Show child attributes
Parâmetros de frete (obrigatório para produtos físicos).
Show child attributes
Show child attributes
Response
Oferta criada com sucesso
Objeto de retorno com os dados da oferta.
Código único da oferta.
Nome da oferta.
Tipo de cobrança.
Available options:
one-time, recurring Preço da oferta em centavos.
Indica se aceita cartão de crédito.
Opções de parcelamento no cartão de crédito.
Required range:
1 <= x <= 36Indica se aceita PIX.
Indica se aceita boleto bancário.
Data de criação (formato YYYY-MM-DD HH:mm:ss)
Example:
"2026-01-15 14:30:00"
Data de atualização (formato YYYY-MM-DD HH:mm:ss)
Example:
"2026-01-15 14:30:00"
Preço "de" para exibição de desconto (em centavos).
Quantidade de itens em estoque (para produtos físicos).
Required range:
1 <= x <= 100Se permite parcelamento no boleto.
Número de dias para vencimento do boleto.
Required range:
1 <= x <= 7Limite máximo de parcelas no boleto.
Required range:
1 <= x <= 12Se permite afiliação para esta oferta.
Percentual de comissão do afiliado.
Required range:
1 <= x <= 80Percentual de comissão do afiliado para cobranças recorrentes.
Required range:
1 <= x <= 80Se a comissão é calculada apenas sobre a primeira parcela.
Se o produtor paga os juros do parcelamento.
Se a oferta é gratuita (price = 0).
Indica se a taxa fixa da transação (R$2,49) é repassada ao comprador.
true— comprador paga a taxa fixafalse— produtor absorve a taxa fixa
Configurações de assinatura (quando type_of_charge = recurring).
Show child attributes
Show child attributes
Informações de frete retornadas para produtos físicos.
Show child attributes
Show child attributes