Generate a recurrence
curl --request POST \
--url https://api.sandbox.trio.com.br/v2/in/pix/recurrences \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'Trio-Version: <trio-version>' \
--data '
{
"amounts": {
"minimum": 100
},
"bank_account_id": "019f4198-8913-1ec9-52c6-706c618a1c5d",
"contract_number": "123456789",
"counterparty": {
"bank_account": {
"branch": "1234",
"digit": "1",
"ispb": "12345678",
"number": "123456"
},
"name": "Payer Name",
"tax_number": "12345678000100"
},
"description": "Monthly payment for services",
"external_id": "external_id_123",
"first_payment": {
"amount": 100,
"dict_key": "pixkey@mail.com",
"due_detail": {
"discount": {
"per_day_antecipated": {
"amount": 2,
"calculation_days": "working",
"calculation_type": "amount"
}
},
"due_date": "2026-10-30",
"fine": {
"calculation_type": "percentage",
"value": 10
},
"interest": {
"amount": 20,
"calculation_days": "calendar",
"calculation_period": "month",
"calculation_type": "amount"
},
"rebate": {
"calculation_type": "percentage",
"value": 50
}
}
},
"options": {
"authorization_type": "app",
"automated_attempt_retry": false,
"automatic_schedule": false,
"next_working_day": true,
"qrcode_expiration_seconds": 86400,
"retry_policy": "3r_7d"
},
"periodicity": "mnth",
"start_date": "2026-10-25"
}
'import requests
url = "https://api.sandbox.trio.com.br/v2/in/pix/recurrences"
payload = {
"amounts": { "minimum": 100 },
"bank_account_id": "019f4198-8913-1ec9-52c6-706c618a1c5d",
"contract_number": "123456789",
"counterparty": {
"bank_account": {
"branch": "1234",
"digit": "1",
"ispb": "12345678",
"number": "123456"
},
"name": "Payer Name",
"tax_number": "12345678000100"
},
"description": "Monthly payment for services",
"external_id": "external_id_123",
"first_payment": {
"amount": 100,
"dict_key": "pixkey@mail.com",
"due_detail": {
"discount": { "per_day_antecipated": {
"amount": 2,
"calculation_days": "working",
"calculation_type": "amount"
} },
"due_date": "2026-10-30",
"fine": {
"calculation_type": "percentage",
"value": 10
},
"interest": {
"amount": 20,
"calculation_days": "calendar",
"calculation_period": "month",
"calculation_type": "amount"
},
"rebate": {
"calculation_type": "percentage",
"value": 50
}
}
},
"options": {
"authorization_type": "app",
"automated_attempt_retry": False,
"automatic_schedule": False,
"next_working_day": True,
"qrcode_expiration_seconds": 86400,
"retry_policy": "3r_7d"
},
"periodicity": "mnth",
"start_date": "2026-10-25"
}
headers = {
"Trio-Version": "<trio-version>",
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Trio-Version': '<trio-version>',
Authorization: 'Basic <encoded-value>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
amounts: {minimum: 100},
bank_account_id: '019f4198-8913-1ec9-52c6-706c618a1c5d',
contract_number: '123456789',
counterparty: {
bank_account: {branch: '1234', digit: '1', ispb: '12345678', number: '123456'},
name: 'Payer Name',
tax_number: '12345678000100'
},
description: 'Monthly payment for services',
external_id: 'external_id_123',
first_payment: {
amount: 100,
dict_key: 'pixkey@mail.com',
due_detail: {
discount: {
per_day_antecipated: {amount: 2, calculation_days: 'working', calculation_type: 'amount'}
},
due_date: '2026-10-30',
fine: {calculation_type: 'percentage', value: 10},
interest: {
amount: 20,
calculation_days: 'calendar',
calculation_period: 'month',
calculation_type: 'amount'
},
rebate: {calculation_type: 'percentage', value: 50}
}
},
options: {
authorization_type: 'app',
automated_attempt_retry: false,
automatic_schedule: false,
next_working_day: true,
qrcode_expiration_seconds: 86400,
retry_policy: '3r_7d'
},
periodicity: 'mnth',
start_date: '2026-10-25'
})
};
fetch('https://api.sandbox.trio.com.br/v2/in/pix/recurrences', 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://api.sandbox.trio.com.br/v2/in/pix/recurrences",
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([
'amounts' => [
'minimum' => 100
],
'bank_account_id' => '019f4198-8913-1ec9-52c6-706c618a1c5d',
'contract_number' => '123456789',
'counterparty' => [
'bank_account' => [
'branch' => '1234',
'digit' => '1',
'ispb' => '12345678',
'number' => '123456'
],
'name' => 'Payer Name',
'tax_number' => '12345678000100'
],
'description' => 'Monthly payment for services',
'external_id' => 'external_id_123',
'first_payment' => [
'amount' => 100,
'dict_key' => 'pixkey@mail.com',
'due_detail' => [
'discount' => [
'per_day_antecipated' => [
'amount' => 2,
'calculation_days' => 'working',
'calculation_type' => 'amount'
]
],
'due_date' => '2026-10-30',
'fine' => [
'calculation_type' => 'percentage',
'value' => 10
],
'interest' => [
'amount' => 20,
'calculation_days' => 'calendar',
'calculation_period' => 'month',
'calculation_type' => 'amount'
],
'rebate' => [
'calculation_type' => 'percentage',
'value' => 50
]
]
],
'options' => [
'authorization_type' => 'app',
'automated_attempt_retry' => false,
'automatic_schedule' => false,
'next_working_day' => true,
'qrcode_expiration_seconds' => 86400,
'retry_policy' => '3r_7d'
],
'periodicity' => 'mnth',
'start_date' => '2026-10-25'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json",
"Trio-Version: <trio-version>"
],
]);
$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://api.sandbox.trio.com.br/v2/in/pix/recurrences"
payload := strings.NewReader("{\n \"amounts\": {\n \"minimum\": 100\n },\n \"bank_account_id\": \"019f4198-8913-1ec9-52c6-706c618a1c5d\",\n \"contract_number\": \"123456789\",\n \"counterparty\": {\n \"bank_account\": {\n \"branch\": \"1234\",\n \"digit\": \"1\",\n \"ispb\": \"12345678\",\n \"number\": \"123456\"\n },\n \"name\": \"Payer Name\",\n \"tax_number\": \"12345678000100\"\n },\n \"description\": \"Monthly payment for services\",\n \"external_id\": \"external_id_123\",\n \"first_payment\": {\n \"amount\": 100,\n \"dict_key\": \"pixkey@mail.com\",\n \"due_detail\": {\n \"discount\": {\n \"per_day_antecipated\": {\n \"amount\": 2,\n \"calculation_days\": \"working\",\n \"calculation_type\": \"amount\"\n }\n },\n \"due_date\": \"2026-10-30\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 10\n },\n \"interest\": {\n \"amount\": 20,\n \"calculation_days\": \"calendar\",\n \"calculation_period\": \"month\",\n \"calculation_type\": \"amount\"\n },\n \"rebate\": {\n \"calculation_type\": \"percentage\",\n \"value\": 50\n }\n }\n },\n \"options\": {\n \"authorization_type\": \"app\",\n \"automated_attempt_retry\": false,\n \"automatic_schedule\": false,\n \"next_working_day\": true,\n \"qrcode_expiration_seconds\": 86400,\n \"retry_policy\": \"3r_7d\"\n },\n \"periodicity\": \"mnth\",\n \"start_date\": \"2026-10-25\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Trio-Version", "<trio-version>")
req.Header.Add("Authorization", "Basic <encoded-value>")
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://api.sandbox.trio.com.br/v2/in/pix/recurrences")
.header("Trio-Version", "<trio-version>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"amounts\": {\n \"minimum\": 100\n },\n \"bank_account_id\": \"019f4198-8913-1ec9-52c6-706c618a1c5d\",\n \"contract_number\": \"123456789\",\n \"counterparty\": {\n \"bank_account\": {\n \"branch\": \"1234\",\n \"digit\": \"1\",\n \"ispb\": \"12345678\",\n \"number\": \"123456\"\n },\n \"name\": \"Payer Name\",\n \"tax_number\": \"12345678000100\"\n },\n \"description\": \"Monthly payment for services\",\n \"external_id\": \"external_id_123\",\n \"first_payment\": {\n \"amount\": 100,\n \"dict_key\": \"pixkey@mail.com\",\n \"due_detail\": {\n \"discount\": {\n \"per_day_antecipated\": {\n \"amount\": 2,\n \"calculation_days\": \"working\",\n \"calculation_type\": \"amount\"\n }\n },\n \"due_date\": \"2026-10-30\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 10\n },\n \"interest\": {\n \"amount\": 20,\n \"calculation_days\": \"calendar\",\n \"calculation_period\": \"month\",\n \"calculation_type\": \"amount\"\n },\n \"rebate\": {\n \"calculation_type\": \"percentage\",\n \"value\": 50\n }\n }\n },\n \"options\": {\n \"authorization_type\": \"app\",\n \"automated_attempt_retry\": false,\n \"automatic_schedule\": false,\n \"next_working_day\": true,\n \"qrcode_expiration_seconds\": 86400,\n \"retry_policy\": \"3r_7d\"\n },\n \"periodicity\": \"mnth\",\n \"start_date\": \"2026-10-25\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.trio.com.br/v2/in/pix/recurrences")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Trio-Version"] = '<trio-version>'
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amounts\": {\n \"minimum\": 100\n },\n \"bank_account_id\": \"019f4198-8913-1ec9-52c6-706c618a1c5d\",\n \"contract_number\": \"123456789\",\n \"counterparty\": {\n \"bank_account\": {\n \"branch\": \"1234\",\n \"digit\": \"1\",\n \"ispb\": \"12345678\",\n \"number\": \"123456\"\n },\n \"name\": \"Payer Name\",\n \"tax_number\": \"12345678000100\"\n },\n \"description\": \"Monthly payment for services\",\n \"external_id\": \"external_id_123\",\n \"first_payment\": {\n \"amount\": 100,\n \"dict_key\": \"pixkey@mail.com\",\n \"due_detail\": {\n \"discount\": {\n \"per_day_antecipated\": {\n \"amount\": 2,\n \"calculation_days\": \"working\",\n \"calculation_type\": \"amount\"\n }\n },\n \"due_date\": \"2026-10-30\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 10\n },\n \"interest\": {\n \"amount\": 20,\n \"calculation_days\": \"calendar\",\n \"calculation_period\": \"month\",\n \"calculation_type\": \"amount\"\n },\n \"rebate\": {\n \"calculation_type\": \"percentage\",\n \"value\": 50\n }\n }\n },\n \"options\": {\n \"authorization_type\": \"app\",\n \"automated_attempt_retry\": false,\n \"automatic_schedule\": false,\n \"next_working_day\": true,\n \"qrcode_expiration_seconds\": 86400,\n \"retry_policy\": \"3r_7d\"\n },\n \"periodicity\": \"mnth\",\n \"start_date\": \"2026-10-25\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"amounts": {
"fixed": {
"amount": 10000,
"currency": "BRL"
},
"maximum": null,
"minimum": null
},
"authorized_at": null,
"bank_account_id": "019f4198-8913-1ec9-52c6-706c618a1c5d",
"contract_number": "0001",
"counterparty": {
"bank_account": {
"id": "49521ece-9203-07f7-7767-e32734e5b636"
},
"id": "49521ece-9203-186b-cfc7-281c207f7f52"
},
"description": "Test Recurrence",
"end_date": null,
"external_id": null,
"first_payment": {
"amount": null,
"date": "2026-07-10"
},
"id": "019f4198-9f53-8f20-a167-5242b634311d",
"inserted_at": "2026-07-08T11:59:09.140530Z",
"number_of_collections": null,
"options": {
"automatic_schedule": true,
"next_working_day": true,
"retry_policy": "none"
},
"origin": {
"id": "019f4198-9de7-4ba7-d718-5e9fce7cbccb",
"type": "api_client"
},
"periodicity": "week",
"qrcode": {
"hash": "00020101021226630014br.gov.bcb.pix...6304B527",
"id": "019f4198-9f53-0000-0000-000000000001",
"type": "dynamic"
},
"reference": {
"id": null,
"type": "qrdn"
},
"start_date": "2026-07-08",
"status": "created",
"type": "in",
"updated_at": "2026-07-08T11:59:09.140530Z"
}
}{
"error": {
"error_code": "INVALID_PARAMETER",
"error_message": "Invalid parameters: /amount: Invalid integer. Got: string",
"errors": [
{
"field": "/amount",
"message": "Invalid integer. Got: string"
}
]
}
}{
"error": {
"error_code": "INVALID_PARAMETER",
"error_message": "Invalid parameters: /amount: Invalid integer. Got: string",
"errors": [
{
"field": "/amount",
"message": "Invalid integer. Got: string"
}
]
}
}{
"error": {
"error_code": "INVALID_PARAMETER",
"error_message": "Invalid parameters: /amount: Invalid integer. Got: string",
"errors": [
{
"field": "/amount",
"message": "Invalid integer. Got: string"
}
]
}
}{
"error": {
"error_code": "INVALID_PARAMETER",
"error_message": "Invalid parameters: /amount: Invalid integer. Got: string",
"errors": [
{
"field": "/amount",
"message": "Invalid integer. Got: string"
}
]
}
}{
"error": {
"error_code": "INVALID_PARAMETER",
"error_message": "Invalid parameters: /amount: Invalid integer. Got: string",
"errors": [
{
"field": "/amount",
"message": "Invalid integer. Got: string"
}
]
}
}Recurrences
Generate a Recurrence
Generate a recurrence
POST
/
v2
/
in
/
pix
/
recurrences
Generate a recurrence
curl --request POST \
--url https://api.sandbox.trio.com.br/v2/in/pix/recurrences \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'Trio-Version: <trio-version>' \
--data '
{
"amounts": {
"minimum": 100
},
"bank_account_id": "019f4198-8913-1ec9-52c6-706c618a1c5d",
"contract_number": "123456789",
"counterparty": {
"bank_account": {
"branch": "1234",
"digit": "1",
"ispb": "12345678",
"number": "123456"
},
"name": "Payer Name",
"tax_number": "12345678000100"
},
"description": "Monthly payment for services",
"external_id": "external_id_123",
"first_payment": {
"amount": 100,
"dict_key": "pixkey@mail.com",
"due_detail": {
"discount": {
"per_day_antecipated": {
"amount": 2,
"calculation_days": "working",
"calculation_type": "amount"
}
},
"due_date": "2026-10-30",
"fine": {
"calculation_type": "percentage",
"value": 10
},
"interest": {
"amount": 20,
"calculation_days": "calendar",
"calculation_period": "month",
"calculation_type": "amount"
},
"rebate": {
"calculation_type": "percentage",
"value": 50
}
}
},
"options": {
"authorization_type": "app",
"automated_attempt_retry": false,
"automatic_schedule": false,
"next_working_day": true,
"qrcode_expiration_seconds": 86400,
"retry_policy": "3r_7d"
},
"periodicity": "mnth",
"start_date": "2026-10-25"
}
'import requests
url = "https://api.sandbox.trio.com.br/v2/in/pix/recurrences"
payload = {
"amounts": { "minimum": 100 },
"bank_account_id": "019f4198-8913-1ec9-52c6-706c618a1c5d",
"contract_number": "123456789",
"counterparty": {
"bank_account": {
"branch": "1234",
"digit": "1",
"ispb": "12345678",
"number": "123456"
},
"name": "Payer Name",
"tax_number": "12345678000100"
},
"description": "Monthly payment for services",
"external_id": "external_id_123",
"first_payment": {
"amount": 100,
"dict_key": "pixkey@mail.com",
"due_detail": {
"discount": { "per_day_antecipated": {
"amount": 2,
"calculation_days": "working",
"calculation_type": "amount"
} },
"due_date": "2026-10-30",
"fine": {
"calculation_type": "percentage",
"value": 10
},
"interest": {
"amount": 20,
"calculation_days": "calendar",
"calculation_period": "month",
"calculation_type": "amount"
},
"rebate": {
"calculation_type": "percentage",
"value": 50
}
}
},
"options": {
"authorization_type": "app",
"automated_attempt_retry": False,
"automatic_schedule": False,
"next_working_day": True,
"qrcode_expiration_seconds": 86400,
"retry_policy": "3r_7d"
},
"periodicity": "mnth",
"start_date": "2026-10-25"
}
headers = {
"Trio-Version": "<trio-version>",
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Trio-Version': '<trio-version>',
Authorization: 'Basic <encoded-value>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
amounts: {minimum: 100},
bank_account_id: '019f4198-8913-1ec9-52c6-706c618a1c5d',
contract_number: '123456789',
counterparty: {
bank_account: {branch: '1234', digit: '1', ispb: '12345678', number: '123456'},
name: 'Payer Name',
tax_number: '12345678000100'
},
description: 'Monthly payment for services',
external_id: 'external_id_123',
first_payment: {
amount: 100,
dict_key: 'pixkey@mail.com',
due_detail: {
discount: {
per_day_antecipated: {amount: 2, calculation_days: 'working', calculation_type: 'amount'}
},
due_date: '2026-10-30',
fine: {calculation_type: 'percentage', value: 10},
interest: {
amount: 20,
calculation_days: 'calendar',
calculation_period: 'month',
calculation_type: 'amount'
},
rebate: {calculation_type: 'percentage', value: 50}
}
},
options: {
authorization_type: 'app',
automated_attempt_retry: false,
automatic_schedule: false,
next_working_day: true,
qrcode_expiration_seconds: 86400,
retry_policy: '3r_7d'
},
periodicity: 'mnth',
start_date: '2026-10-25'
})
};
fetch('https://api.sandbox.trio.com.br/v2/in/pix/recurrences', 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://api.sandbox.trio.com.br/v2/in/pix/recurrences",
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([
'amounts' => [
'minimum' => 100
],
'bank_account_id' => '019f4198-8913-1ec9-52c6-706c618a1c5d',
'contract_number' => '123456789',
'counterparty' => [
'bank_account' => [
'branch' => '1234',
'digit' => '1',
'ispb' => '12345678',
'number' => '123456'
],
'name' => 'Payer Name',
'tax_number' => '12345678000100'
],
'description' => 'Monthly payment for services',
'external_id' => 'external_id_123',
'first_payment' => [
'amount' => 100,
'dict_key' => 'pixkey@mail.com',
'due_detail' => [
'discount' => [
'per_day_antecipated' => [
'amount' => 2,
'calculation_days' => 'working',
'calculation_type' => 'amount'
]
],
'due_date' => '2026-10-30',
'fine' => [
'calculation_type' => 'percentage',
'value' => 10
],
'interest' => [
'amount' => 20,
'calculation_days' => 'calendar',
'calculation_period' => 'month',
'calculation_type' => 'amount'
],
'rebate' => [
'calculation_type' => 'percentage',
'value' => 50
]
]
],
'options' => [
'authorization_type' => 'app',
'automated_attempt_retry' => false,
'automatic_schedule' => false,
'next_working_day' => true,
'qrcode_expiration_seconds' => 86400,
'retry_policy' => '3r_7d'
],
'periodicity' => 'mnth',
'start_date' => '2026-10-25'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json",
"Trio-Version: <trio-version>"
],
]);
$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://api.sandbox.trio.com.br/v2/in/pix/recurrences"
payload := strings.NewReader("{\n \"amounts\": {\n \"minimum\": 100\n },\n \"bank_account_id\": \"019f4198-8913-1ec9-52c6-706c618a1c5d\",\n \"contract_number\": \"123456789\",\n \"counterparty\": {\n \"bank_account\": {\n \"branch\": \"1234\",\n \"digit\": \"1\",\n \"ispb\": \"12345678\",\n \"number\": \"123456\"\n },\n \"name\": \"Payer Name\",\n \"tax_number\": \"12345678000100\"\n },\n \"description\": \"Monthly payment for services\",\n \"external_id\": \"external_id_123\",\n \"first_payment\": {\n \"amount\": 100,\n \"dict_key\": \"pixkey@mail.com\",\n \"due_detail\": {\n \"discount\": {\n \"per_day_antecipated\": {\n \"amount\": 2,\n \"calculation_days\": \"working\",\n \"calculation_type\": \"amount\"\n }\n },\n \"due_date\": \"2026-10-30\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 10\n },\n \"interest\": {\n \"amount\": 20,\n \"calculation_days\": \"calendar\",\n \"calculation_period\": \"month\",\n \"calculation_type\": \"amount\"\n },\n \"rebate\": {\n \"calculation_type\": \"percentage\",\n \"value\": 50\n }\n }\n },\n \"options\": {\n \"authorization_type\": \"app\",\n \"automated_attempt_retry\": false,\n \"automatic_schedule\": false,\n \"next_working_day\": true,\n \"qrcode_expiration_seconds\": 86400,\n \"retry_policy\": \"3r_7d\"\n },\n \"periodicity\": \"mnth\",\n \"start_date\": \"2026-10-25\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Trio-Version", "<trio-version>")
req.Header.Add("Authorization", "Basic <encoded-value>")
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://api.sandbox.trio.com.br/v2/in/pix/recurrences")
.header("Trio-Version", "<trio-version>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"amounts\": {\n \"minimum\": 100\n },\n \"bank_account_id\": \"019f4198-8913-1ec9-52c6-706c618a1c5d\",\n \"contract_number\": \"123456789\",\n \"counterparty\": {\n \"bank_account\": {\n \"branch\": \"1234\",\n \"digit\": \"1\",\n \"ispb\": \"12345678\",\n \"number\": \"123456\"\n },\n \"name\": \"Payer Name\",\n \"tax_number\": \"12345678000100\"\n },\n \"description\": \"Monthly payment for services\",\n \"external_id\": \"external_id_123\",\n \"first_payment\": {\n \"amount\": 100,\n \"dict_key\": \"pixkey@mail.com\",\n \"due_detail\": {\n \"discount\": {\n \"per_day_antecipated\": {\n \"amount\": 2,\n \"calculation_days\": \"working\",\n \"calculation_type\": \"amount\"\n }\n },\n \"due_date\": \"2026-10-30\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 10\n },\n \"interest\": {\n \"amount\": 20,\n \"calculation_days\": \"calendar\",\n \"calculation_period\": \"month\",\n \"calculation_type\": \"amount\"\n },\n \"rebate\": {\n \"calculation_type\": \"percentage\",\n \"value\": 50\n }\n }\n },\n \"options\": {\n \"authorization_type\": \"app\",\n \"automated_attempt_retry\": false,\n \"automatic_schedule\": false,\n \"next_working_day\": true,\n \"qrcode_expiration_seconds\": 86400,\n \"retry_policy\": \"3r_7d\"\n },\n \"periodicity\": \"mnth\",\n \"start_date\": \"2026-10-25\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.trio.com.br/v2/in/pix/recurrences")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Trio-Version"] = '<trio-version>'
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amounts\": {\n \"minimum\": 100\n },\n \"bank_account_id\": \"019f4198-8913-1ec9-52c6-706c618a1c5d\",\n \"contract_number\": \"123456789\",\n \"counterparty\": {\n \"bank_account\": {\n \"branch\": \"1234\",\n \"digit\": \"1\",\n \"ispb\": \"12345678\",\n \"number\": \"123456\"\n },\n \"name\": \"Payer Name\",\n \"tax_number\": \"12345678000100\"\n },\n \"description\": \"Monthly payment for services\",\n \"external_id\": \"external_id_123\",\n \"first_payment\": {\n \"amount\": 100,\n \"dict_key\": \"pixkey@mail.com\",\n \"due_detail\": {\n \"discount\": {\n \"per_day_antecipated\": {\n \"amount\": 2,\n \"calculation_days\": \"working\",\n \"calculation_type\": \"amount\"\n }\n },\n \"due_date\": \"2026-10-30\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 10\n },\n \"interest\": {\n \"amount\": 20,\n \"calculation_days\": \"calendar\",\n \"calculation_period\": \"month\",\n \"calculation_type\": \"amount\"\n },\n \"rebate\": {\n \"calculation_type\": \"percentage\",\n \"value\": 50\n }\n }\n },\n \"options\": {\n \"authorization_type\": \"app\",\n \"automated_attempt_retry\": false,\n \"automatic_schedule\": false,\n \"next_working_day\": true,\n \"qrcode_expiration_seconds\": 86400,\n \"retry_policy\": \"3r_7d\"\n },\n \"periodicity\": \"mnth\",\n \"start_date\": \"2026-10-25\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"amounts": {
"fixed": {
"amount": 10000,
"currency": "BRL"
},
"maximum": null,
"minimum": null
},
"authorized_at": null,
"bank_account_id": "019f4198-8913-1ec9-52c6-706c618a1c5d",
"contract_number": "0001",
"counterparty": {
"bank_account": {
"id": "49521ece-9203-07f7-7767-e32734e5b636"
},
"id": "49521ece-9203-186b-cfc7-281c207f7f52"
},
"description": "Test Recurrence",
"end_date": null,
"external_id": null,
"first_payment": {
"amount": null,
"date": "2026-07-10"
},
"id": "019f4198-9f53-8f20-a167-5242b634311d",
"inserted_at": "2026-07-08T11:59:09.140530Z",
"number_of_collections": null,
"options": {
"automatic_schedule": true,
"next_working_day": true,
"retry_policy": "none"
},
"origin": {
"id": "019f4198-9de7-4ba7-d718-5e9fce7cbccb",
"type": "api_client"
},
"periodicity": "week",
"qrcode": {
"hash": "00020101021226630014br.gov.bcb.pix...6304B527",
"id": "019f4198-9f53-0000-0000-000000000001",
"type": "dynamic"
},
"reference": {
"id": null,
"type": "qrdn"
},
"start_date": "2026-07-08",
"status": "created",
"type": "in",
"updated_at": "2026-07-08T11:59:09.140530Z"
}
}{
"error": {
"error_code": "INVALID_PARAMETER",
"error_message": "Invalid parameters: /amount: Invalid integer. Got: string",
"errors": [
{
"field": "/amount",
"message": "Invalid integer. Got: string"
}
]
}
}{
"error": {
"error_code": "INVALID_PARAMETER",
"error_message": "Invalid parameters: /amount: Invalid integer. Got: string",
"errors": [
{
"field": "/amount",
"message": "Invalid integer. Got: string"
}
]
}
}{
"error": {
"error_code": "INVALID_PARAMETER",
"error_message": "Invalid parameters: /amount: Invalid integer. Got: string",
"errors": [
{
"field": "/amount",
"message": "Invalid integer. Got: string"
}
]
}
}{
"error": {
"error_code": "INVALID_PARAMETER",
"error_message": "Invalid parameters: /amount: Invalid integer. Got: string",
"errors": [
{
"field": "/amount",
"message": "Invalid integer. Got: string"
}
]
}
}{
"error": {
"error_code": "INVALID_PARAMETER",
"error_message": "Invalid parameters: /amount: Invalid integer. Got: string",
"errors": [
{
"field": "/amount",
"message": "Invalid integer. Got: string"
}
]
}
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Headers
Version of the v2 contract the client is written against. Each breaking change publishes a new version.
Available options:
2026-10-19.v2 ID of another org to act on instead of the API key's own org. The key's org must have been granted access to it, and the request is refused with 403 FORBIDDEN otherwise. When that access or the API key is read-only, only GET and HEAD requests may carry it. When the target org requires mTLS, so does the request. Leave it out to act on the key's own org.
Body
application/json
The recurrence generate attributes
GenerateRecurrenceParameters
Bank Account ID
Contract Number
Maximum string length:
35Counterparty
Show child attributes
Show child attributes
Description
Maximum string length:
35'week': every week, 'mnth': every month, 'qurt': every 3 months, 'mian': every 6 months, 'year': every year
Available options:
week, mnth, qurt, mian, year First day of the recurrence
Recurrence Amount, use fixed for fixed amount recurences. For variable amount recurrences, a minimum can be defined. If defined, the counterparty cannot define a limit lower than the minimum. Variable amount recurrences need to be updated with the amount before each collecting date. If left blank, a variable amount recurrence will be created with no minimum
Show child attributes
Show child attributes
Last day of the recurrence
Recurrence External ID
Schema for the first payment with due detail
Show child attributes
Show child attributes
Recurrence options
Show child attributes
Show child attributes
Response
Generate Recurrence Response
The created recurrence, plus the QRCode the payer authorizes it through (null when the journey has none)
Show child attributes
Show child attributes