Atualizar oferta
curl --request PUT \
--url https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers/{offer_code} \
--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/{offer_code}"
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.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
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/{offer_code}', 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/{offer_code}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
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/{offer_code}"
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("PUT", 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.put("https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers/{offer_code}")
.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/{offer_code}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.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
Atualizar oferta
Atualiza os dados de uma oferta existente.
Campos atualizáveis:
price- Preço da ofertafake_initial_price- Preço inicial promocionalallow_credit_card- Se aceita cartão de créditocredit_card_installments_options- Opções de parcelamentoallow_pix- Se aceita PIXallow_bank_slip- Se aceita boletobank_slip_days_due- Dias para vencimento do boletosubscription- Configurações de assinaturafreight- Parâmetros de frete para produtos físicos
PUT
/
products
/
{product_hash}
/
offers
/
{offer_code}
Atualizar oferta
curl --request PUT \
--url https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers/{offer_code} \
--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/{offer_code}"
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.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
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/{offer_code}', 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/{offer_code}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
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/{offer_code}"
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("PUT", 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.put("https://nexus.ticto.com.br/api/v1/products/{product_hash}/offers/{offer_code}")
.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/{offer_code}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.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
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 atualizada 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