Solicitar nova tentativa de cobrança
curl --request POST \
--url https://nexus.ticto.com.br/api/v1/financial/pix-recurring/{subscription_code}/retry \
--header 'Authorization: Bearer <token>' \
--header 'X-Api-Client-Token: <api-key>'import requests
url = "https://nexus.ticto.com.br/api/v1/financial/pix-recurring/{subscription_code}/retry"
headers = {
"X-Api-Client-Token": "<api-key>",
"Authorization": "Bearer <token>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Client-Token': '<api-key>', Authorization: 'Bearer <token>'}
};
fetch('https://nexus.ticto.com.br/api/v1/financial/pix-recurring/{subscription_code}/retry', 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/financial/pix-recurring/{subscription_code}/retry",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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"
"net/http"
"io"
)
func main() {
url := "https://nexus.ticto.com.br/api/v1/financial/pix-recurring/{subscription_code}/retry"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("X-Api-Client-Token", "<api-key>")
req.Header.Add("Authorization", "Bearer <token>")
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/financial/pix-recurring/{subscription_code}/retry")
.header("X-Api-Client-Token", "<api-key>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://nexus.ticto.com.br/api/v1/financial/pix-recurring/{subscription_code}/retry")
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["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "Retry de PIX Automático solicitado com sucesso.",
"data": {
"subscription_code": "TS7QK4M2XJ9BVN5RLD3W",
"subscription_canceled_at": null,
"status": "failed",
"frequency": "monthly",
"authorization_type": "monthly_auth_monthly_retry",
"authorization_date": "2026-08-01T12:00:00.000000Z",
"expires_at": null,
"cancelled_at": null,
"retry_attempts": 0,
"max_retry_attempts": 7,
"last_retry_at": "2026-09-29T14:10:00.000000Z",
"failed_charges": 1,
"variable_amount": false,
"min_amount": null,
"max_amount": null,
"created_at": "01/08/2026 11:58:40"
}
}{
"status": "error",
"message": "Recurso não encontrado."
}{
"status": "error",
"message": "Recurso não encontrado."
}{
"status": "error",
"message": "Recurso não encontrado."
}{
"status": "error",
"message": "PIX Automático não pode ser reprocessado neste status."
}{
"status": "error",
"message": "Erro ao fazer retry do PIX Automático."
}PIX Automático
Solicitar nova tentativa de cobrança
Pede uma nova tentativa de cobrança de um PIX Automático que falhou. Vale só para mandatos em failed ou denied de assinaturas que não foram canceladas.
O pedido não cobra na hora. Ele zera retry_attempts, grava last_retry_at e registra a solicitação. Assim o mandato volta ao ciclo normal de retentativas da cobrança recorrente. O status do mandato não muda com esta chamada.
O token Authorization: Bearer deve ser do produtor do pedido que originou a assinatura. Não há corpo na requisição.
POST
/
financial
/
pix-recurring
/
{subscription_code}
/
retry
Solicitar nova tentativa de cobrança
curl --request POST \
--url https://nexus.ticto.com.br/api/v1/financial/pix-recurring/{subscription_code}/retry \
--header 'Authorization: Bearer <token>' \
--header 'X-Api-Client-Token: <api-key>'import requests
url = "https://nexus.ticto.com.br/api/v1/financial/pix-recurring/{subscription_code}/retry"
headers = {
"X-Api-Client-Token": "<api-key>",
"Authorization": "Bearer <token>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Client-Token': '<api-key>', Authorization: 'Bearer <token>'}
};
fetch('https://nexus.ticto.com.br/api/v1/financial/pix-recurring/{subscription_code}/retry', 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/financial/pix-recurring/{subscription_code}/retry",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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"
"net/http"
"io"
)
func main() {
url := "https://nexus.ticto.com.br/api/v1/financial/pix-recurring/{subscription_code}/retry"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("X-Api-Client-Token", "<api-key>")
req.Header.Add("Authorization", "Bearer <token>")
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/financial/pix-recurring/{subscription_code}/retry")
.header("X-Api-Client-Token", "<api-key>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://nexus.ticto.com.br/api/v1/financial/pix-recurring/{subscription_code}/retry")
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["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "Retry de PIX Automático solicitado com sucesso.",
"data": {
"subscription_code": "TS7QK4M2XJ9BVN5RLD3W",
"subscription_canceled_at": null,
"status": "failed",
"frequency": "monthly",
"authorization_type": "monthly_auth_monthly_retry",
"authorization_date": "2026-08-01T12:00:00.000000Z",
"expires_at": null,
"cancelled_at": null,
"retry_attempts": 0,
"max_retry_attempts": 7,
"last_retry_at": "2026-09-29T14:10:00.000000Z",
"failed_charges": 1,
"variable_amount": false,
"min_amount": null,
"max_amount": null,
"created_at": "01/08/2026 11:58:40"
}
}{
"status": "error",
"message": "Recurso não encontrado."
}{
"status": "error",
"message": "Recurso não encontrado."
}{
"status": "error",
"message": "Recurso não encontrado."
}{
"status": "error",
"message": "PIX Automático não pode ser reprocessado neste status."
}{
"status": "error",
"message": "Erro ao fazer retry do PIX Automático."
}Authorizations
Token de autenticação do cliente obtido via endpoint /auth
Token de autenticação do usuário (public_token) obtido na criação do usuário
Path Parameters
Código da assinatura com PIX Automático
Example:
"TS7QK4M2XJ9BVN5RLD3W"
Response
Nova tentativa registrada. data traz o mandato já atualizado.