Create boleto
curl --request POST \
--url https://api.sandbox.trio.com.br/v2/in/boletos \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'Trio-Version: <trio-version>' \
--data '
{
"amount": 402,
"bank_account_id": "0196f83d-cafa-f412-1f1d-129cdf2dda49",
"counterparty": {
"address": "Rua Exemplo, 100",
"city": "Curitiba",
"district": "Centro",
"name": "Payer Name",
"postal_code": "80000000",
"state": "PR",
"tax_number": "12345678900"
},
"description": "Pago a trio.com.br",
"due_detail": {
"discount": {
"fixed_until_due": {
"amounts": [
{
"amount": 300,
"date": "2026-12-13"
},
{
"amount": 100,
"date": "2026-12-15"
}
],
"calculation_type": "amount"
}
},
"due_date": "2026-12-16",
"fine": {
"calculation_type": "percentage",
"value": 200
},
"interest": {
"amount": 10,
"calculation_type": "daily_rate"
}
},
"expiration_date": "2026-12-30",
"external_id": "external id 123",
"invoice_type": "invoice",
"merchant": {
"name": "Merchant Name",
"tax_number": "12345678000199"
},
"options": {
"fee": 0
},
"splits": [
{
"counterparty_recipient_id": "0198aaaa-1111-2222-3333-444444444444",
"type": "percentage",
"value": 70
},
{
"counterparty_recipient_id": "0198bbbb-5555-6666-7777-888888888888",
"type": "percentage",
"value": 30
}
],
"wallet_type": "book_entry_electronic_bloquete"
}
'import requests
url = "https://api.sandbox.trio.com.br/v2/in/boletos"
payload = {
"amount": 402,
"bank_account_id": "0196f83d-cafa-f412-1f1d-129cdf2dda49",
"counterparty": {
"address": "Rua Exemplo, 100",
"city": "Curitiba",
"district": "Centro",
"name": "Payer Name",
"postal_code": "80000000",
"state": "PR",
"tax_number": "12345678900"
},
"description": "Pago a trio.com.br",
"due_detail": {
"discount": { "fixed_until_due": {
"amounts": [
{
"amount": 300,
"date": "2026-12-13"
},
{
"amount": 100,
"date": "2026-12-15"
}
],
"calculation_type": "amount"
} },
"due_date": "2026-12-16",
"fine": {
"calculation_type": "percentage",
"value": 200
},
"interest": {
"amount": 10,
"calculation_type": "daily_rate"
}
},
"expiration_date": "2026-12-30",
"external_id": "external id 123",
"invoice_type": "invoice",
"merchant": {
"name": "Merchant Name",
"tax_number": "12345678000199"
},
"options": { "fee": 0 },
"splits": [
{
"counterparty_recipient_id": "0198aaaa-1111-2222-3333-444444444444",
"type": "percentage",
"value": 70
},
{
"counterparty_recipient_id": "0198bbbb-5555-6666-7777-888888888888",
"type": "percentage",
"value": 30
}
],
"wallet_type": "book_entry_electronic_bloquete"
}
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({
amount: 402,
bank_account_id: '0196f83d-cafa-f412-1f1d-129cdf2dda49',
counterparty: {
address: 'Rua Exemplo, 100',
city: 'Curitiba',
district: 'Centro',
name: 'Payer Name',
postal_code: '80000000',
state: 'PR',
tax_number: '12345678900'
},
description: 'Pago a trio.com.br',
due_detail: {
discount: {
fixed_until_due: {
amounts: [{amount: 300, date: '2026-12-13'}, {amount: 100, date: '2026-12-15'}],
calculation_type: 'amount'
}
},
due_date: '2026-12-16',
fine: {calculation_type: 'percentage', value: 200},
interest: {amount: 10, calculation_type: 'daily_rate'}
},
expiration_date: '2026-12-30',
external_id: 'external id 123',
invoice_type: 'invoice',
merchant: {name: 'Merchant Name', tax_number: '12345678000199'},
options: {fee: 0},
splits: [
{
counterparty_recipient_id: '0198aaaa-1111-2222-3333-444444444444',
type: 'percentage',
value: 70
},
{
counterparty_recipient_id: '0198bbbb-5555-6666-7777-888888888888',
type: 'percentage',
value: 30
}
],
wallet_type: 'book_entry_electronic_bloquete'
})
};
fetch('https://api.sandbox.trio.com.br/v2/in/boletos', 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/boletos",
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([
'amount' => 402,
'bank_account_id' => '0196f83d-cafa-f412-1f1d-129cdf2dda49',
'counterparty' => [
'address' => 'Rua Exemplo, 100',
'city' => 'Curitiba',
'district' => 'Centro',
'name' => 'Payer Name',
'postal_code' => '80000000',
'state' => 'PR',
'tax_number' => '12345678900'
],
'description' => 'Pago a trio.com.br',
'due_detail' => [
'discount' => [
'fixed_until_due' => [
'amounts' => [
[
'amount' => 300,
'date' => '2026-12-13'
],
[
'amount' => 100,
'date' => '2026-12-15'
]
],
'calculation_type' => 'amount'
]
],
'due_date' => '2026-12-16',
'fine' => [
'calculation_type' => 'percentage',
'value' => 200
],
'interest' => [
'amount' => 10,
'calculation_type' => 'daily_rate'
]
],
'expiration_date' => '2026-12-30',
'external_id' => 'external id 123',
'invoice_type' => 'invoice',
'merchant' => [
'name' => 'Merchant Name',
'tax_number' => '12345678000199'
],
'options' => [
'fee' => 0
],
'splits' => [
[
'counterparty_recipient_id' => '0198aaaa-1111-2222-3333-444444444444',
'type' => 'percentage',
'value' => 70
],
[
'counterparty_recipient_id' => '0198bbbb-5555-6666-7777-888888888888',
'type' => 'percentage',
'value' => 30
]
],
'wallet_type' => 'book_entry_electronic_bloquete'
]),
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/boletos"
payload := strings.NewReader("{\n \"amount\": 402,\n \"bank_account_id\": \"0196f83d-cafa-f412-1f1d-129cdf2dda49\",\n \"counterparty\": {\n \"address\": \"Rua Exemplo, 100\",\n \"city\": \"Curitiba\",\n \"district\": \"Centro\",\n \"name\": \"Payer Name\",\n \"postal_code\": \"80000000\",\n \"state\": \"PR\",\n \"tax_number\": \"12345678900\"\n },\n \"description\": \"Pago a trio.com.br\",\n \"due_detail\": {\n \"discount\": {\n \"fixed_until_due\": {\n \"amounts\": [\n {\n \"amount\": 300,\n \"date\": \"2026-12-13\"\n },\n {\n \"amount\": 100,\n \"date\": \"2026-12-15\"\n }\n ],\n \"calculation_type\": \"amount\"\n }\n },\n \"due_date\": \"2026-12-16\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 200\n },\n \"interest\": {\n \"amount\": 10,\n \"calculation_type\": \"daily_rate\"\n }\n },\n \"expiration_date\": \"2026-12-30\",\n \"external_id\": \"external id 123\",\n \"invoice_type\": \"invoice\",\n \"merchant\": {\n \"name\": \"Merchant Name\",\n \"tax_number\": \"12345678000199\"\n },\n \"options\": {\n \"fee\": 0\n },\n \"splits\": [\n {\n \"counterparty_recipient_id\": \"0198aaaa-1111-2222-3333-444444444444\",\n \"type\": \"percentage\",\n \"value\": 70\n },\n {\n \"counterparty_recipient_id\": \"0198bbbb-5555-6666-7777-888888888888\",\n \"type\": \"percentage\",\n \"value\": 30\n }\n ],\n \"wallet_type\": \"book_entry_electronic_bloquete\"\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/boletos")
.header("Trio-Version", "<trio-version>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 402,\n \"bank_account_id\": \"0196f83d-cafa-f412-1f1d-129cdf2dda49\",\n \"counterparty\": {\n \"address\": \"Rua Exemplo, 100\",\n \"city\": \"Curitiba\",\n \"district\": \"Centro\",\n \"name\": \"Payer Name\",\n \"postal_code\": \"80000000\",\n \"state\": \"PR\",\n \"tax_number\": \"12345678900\"\n },\n \"description\": \"Pago a trio.com.br\",\n \"due_detail\": {\n \"discount\": {\n \"fixed_until_due\": {\n \"amounts\": [\n {\n \"amount\": 300,\n \"date\": \"2026-12-13\"\n },\n {\n \"amount\": 100,\n \"date\": \"2026-12-15\"\n }\n ],\n \"calculation_type\": \"amount\"\n }\n },\n \"due_date\": \"2026-12-16\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 200\n },\n \"interest\": {\n \"amount\": 10,\n \"calculation_type\": \"daily_rate\"\n }\n },\n \"expiration_date\": \"2026-12-30\",\n \"external_id\": \"external id 123\",\n \"invoice_type\": \"invoice\",\n \"merchant\": {\n \"name\": \"Merchant Name\",\n \"tax_number\": \"12345678000199\"\n },\n \"options\": {\n \"fee\": 0\n },\n \"splits\": [\n {\n \"counterparty_recipient_id\": \"0198aaaa-1111-2222-3333-444444444444\",\n \"type\": \"percentage\",\n \"value\": 70\n },\n {\n \"counterparty_recipient_id\": \"0198bbbb-5555-6666-7777-888888888888\",\n \"type\": \"percentage\",\n \"value\": 30\n }\n ],\n \"wallet_type\": \"book_entry_electronic_bloquete\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.trio.com.br/v2/in/boletos")
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 \"amount\": 402,\n \"bank_account_id\": \"0196f83d-cafa-f412-1f1d-129cdf2dda49\",\n \"counterparty\": {\n \"address\": \"Rua Exemplo, 100\",\n \"city\": \"Curitiba\",\n \"district\": \"Centro\",\n \"name\": \"Payer Name\",\n \"postal_code\": \"80000000\",\n \"state\": \"PR\",\n \"tax_number\": \"12345678900\"\n },\n \"description\": \"Pago a trio.com.br\",\n \"due_detail\": {\n \"discount\": {\n \"fixed_until_due\": {\n \"amounts\": [\n {\n \"amount\": 300,\n \"date\": \"2026-12-13\"\n },\n {\n \"amount\": 100,\n \"date\": \"2026-12-15\"\n }\n ],\n \"calculation_type\": \"amount\"\n }\n },\n \"due_date\": \"2026-12-16\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 200\n },\n \"interest\": {\n \"amount\": 10,\n \"calculation_type\": \"daily_rate\"\n }\n },\n \"expiration_date\": \"2026-12-30\",\n \"external_id\": \"external id 123\",\n \"invoice_type\": \"invoice\",\n \"merchant\": {\n \"name\": \"Merchant Name\",\n \"tax_number\": \"12345678000199\"\n },\n \"options\": {\n \"fee\": 0\n },\n \"splits\": [\n {\n \"counterparty_recipient_id\": \"0198aaaa-1111-2222-3333-444444444444\",\n \"type\": \"percentage\",\n \"value\": 70\n },\n {\n \"counterparty_recipient_id\": \"0198bbbb-5555-6666-7777-888888888888\",\n \"type\": \"percentage\",\n \"value\": 30\n }\n ],\n \"wallet_type\": \"book_entry_electronic_bloquete\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"amount": {
"amount": 10000,
"currency": "BRL"
},
"bank_account_id": "0196f83d-cafa-f412-1f1d-129cdf2dda49",
"barcode": "12341111222233334444555566667777888899990000",
"boleto_url": "https://example.com/boleto_1",
"counterparty": {
"id": "000a89cb-f0c9-07ce-79c2-fc049bc253e0"
},
"description": "description",
"digitable_line": "12341111222233334444555566667777888899990000",
"due_detail": {
"discount": {
"fixed_until_due": {
"amounts": [
{
"amount": {
"amount": 300,
"currency": "BRL"
},
"date": "2026-12-13"
},
{
"amount": {
"amount": 100,
"currency": "BRL"
},
"date": "2026-12-15"
}
],
"calculation_type": "amount"
}
},
"due_date": "2026-12-16",
"fine": {
"calculation_type": "percentage",
"value": 200
},
"interest": {
"amount": {
"amount": 10,
"currency": "BRL"
},
"calculation_type": "daily_rate"
}
},
"expiration_date": "2026-12-30",
"external_id": "0190b2a4-8a3b-d123-050e-8d659ace1e2d",
"fee": {
"amount": 0,
"currency": "BRL"
},
"id": "0196f83d-cafa-f412-1f1d-129cdf2dda49",
"inserted_at": "2026-12-01T10:00:00.000000Z",
"invoice_type": "invoice",
"issue_date": "2026-12-01",
"notes": [
"note 1",
"note 2",
"note 3"
],
"status": "confirmed",
"updated_at": "2026-12-01T10:00:00.000000Z",
"wallet_type": "book_entry_electronic_bloquete"
}
}{
"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"
}
]
}
}Boleto
Create boleto
Creates a new boleto
POST
/
v2
/
in
/
boletos
Create boleto
curl --request POST \
--url https://api.sandbox.trio.com.br/v2/in/boletos \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'Trio-Version: <trio-version>' \
--data '
{
"amount": 402,
"bank_account_id": "0196f83d-cafa-f412-1f1d-129cdf2dda49",
"counterparty": {
"address": "Rua Exemplo, 100",
"city": "Curitiba",
"district": "Centro",
"name": "Payer Name",
"postal_code": "80000000",
"state": "PR",
"tax_number": "12345678900"
},
"description": "Pago a trio.com.br",
"due_detail": {
"discount": {
"fixed_until_due": {
"amounts": [
{
"amount": 300,
"date": "2026-12-13"
},
{
"amount": 100,
"date": "2026-12-15"
}
],
"calculation_type": "amount"
}
},
"due_date": "2026-12-16",
"fine": {
"calculation_type": "percentage",
"value": 200
},
"interest": {
"amount": 10,
"calculation_type": "daily_rate"
}
},
"expiration_date": "2026-12-30",
"external_id": "external id 123",
"invoice_type": "invoice",
"merchant": {
"name": "Merchant Name",
"tax_number": "12345678000199"
},
"options": {
"fee": 0
},
"splits": [
{
"counterparty_recipient_id": "0198aaaa-1111-2222-3333-444444444444",
"type": "percentage",
"value": 70
},
{
"counterparty_recipient_id": "0198bbbb-5555-6666-7777-888888888888",
"type": "percentage",
"value": 30
}
],
"wallet_type": "book_entry_electronic_bloquete"
}
'import requests
url = "https://api.sandbox.trio.com.br/v2/in/boletos"
payload = {
"amount": 402,
"bank_account_id": "0196f83d-cafa-f412-1f1d-129cdf2dda49",
"counterparty": {
"address": "Rua Exemplo, 100",
"city": "Curitiba",
"district": "Centro",
"name": "Payer Name",
"postal_code": "80000000",
"state": "PR",
"tax_number": "12345678900"
},
"description": "Pago a trio.com.br",
"due_detail": {
"discount": { "fixed_until_due": {
"amounts": [
{
"amount": 300,
"date": "2026-12-13"
},
{
"amount": 100,
"date": "2026-12-15"
}
],
"calculation_type": "amount"
} },
"due_date": "2026-12-16",
"fine": {
"calculation_type": "percentage",
"value": 200
},
"interest": {
"amount": 10,
"calculation_type": "daily_rate"
}
},
"expiration_date": "2026-12-30",
"external_id": "external id 123",
"invoice_type": "invoice",
"merchant": {
"name": "Merchant Name",
"tax_number": "12345678000199"
},
"options": { "fee": 0 },
"splits": [
{
"counterparty_recipient_id": "0198aaaa-1111-2222-3333-444444444444",
"type": "percentage",
"value": 70
},
{
"counterparty_recipient_id": "0198bbbb-5555-6666-7777-888888888888",
"type": "percentage",
"value": 30
}
],
"wallet_type": "book_entry_electronic_bloquete"
}
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({
amount: 402,
bank_account_id: '0196f83d-cafa-f412-1f1d-129cdf2dda49',
counterparty: {
address: 'Rua Exemplo, 100',
city: 'Curitiba',
district: 'Centro',
name: 'Payer Name',
postal_code: '80000000',
state: 'PR',
tax_number: '12345678900'
},
description: 'Pago a trio.com.br',
due_detail: {
discount: {
fixed_until_due: {
amounts: [{amount: 300, date: '2026-12-13'}, {amount: 100, date: '2026-12-15'}],
calculation_type: 'amount'
}
},
due_date: '2026-12-16',
fine: {calculation_type: 'percentage', value: 200},
interest: {amount: 10, calculation_type: 'daily_rate'}
},
expiration_date: '2026-12-30',
external_id: 'external id 123',
invoice_type: 'invoice',
merchant: {name: 'Merchant Name', tax_number: '12345678000199'},
options: {fee: 0},
splits: [
{
counterparty_recipient_id: '0198aaaa-1111-2222-3333-444444444444',
type: 'percentage',
value: 70
},
{
counterparty_recipient_id: '0198bbbb-5555-6666-7777-888888888888',
type: 'percentage',
value: 30
}
],
wallet_type: 'book_entry_electronic_bloquete'
})
};
fetch('https://api.sandbox.trio.com.br/v2/in/boletos', 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/boletos",
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([
'amount' => 402,
'bank_account_id' => '0196f83d-cafa-f412-1f1d-129cdf2dda49',
'counterparty' => [
'address' => 'Rua Exemplo, 100',
'city' => 'Curitiba',
'district' => 'Centro',
'name' => 'Payer Name',
'postal_code' => '80000000',
'state' => 'PR',
'tax_number' => '12345678900'
],
'description' => 'Pago a trio.com.br',
'due_detail' => [
'discount' => [
'fixed_until_due' => [
'amounts' => [
[
'amount' => 300,
'date' => '2026-12-13'
],
[
'amount' => 100,
'date' => '2026-12-15'
]
],
'calculation_type' => 'amount'
]
],
'due_date' => '2026-12-16',
'fine' => [
'calculation_type' => 'percentage',
'value' => 200
],
'interest' => [
'amount' => 10,
'calculation_type' => 'daily_rate'
]
],
'expiration_date' => '2026-12-30',
'external_id' => 'external id 123',
'invoice_type' => 'invoice',
'merchant' => [
'name' => 'Merchant Name',
'tax_number' => '12345678000199'
],
'options' => [
'fee' => 0
],
'splits' => [
[
'counterparty_recipient_id' => '0198aaaa-1111-2222-3333-444444444444',
'type' => 'percentage',
'value' => 70
],
[
'counterparty_recipient_id' => '0198bbbb-5555-6666-7777-888888888888',
'type' => 'percentage',
'value' => 30
]
],
'wallet_type' => 'book_entry_electronic_bloquete'
]),
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/boletos"
payload := strings.NewReader("{\n \"amount\": 402,\n \"bank_account_id\": \"0196f83d-cafa-f412-1f1d-129cdf2dda49\",\n \"counterparty\": {\n \"address\": \"Rua Exemplo, 100\",\n \"city\": \"Curitiba\",\n \"district\": \"Centro\",\n \"name\": \"Payer Name\",\n \"postal_code\": \"80000000\",\n \"state\": \"PR\",\n \"tax_number\": \"12345678900\"\n },\n \"description\": \"Pago a trio.com.br\",\n \"due_detail\": {\n \"discount\": {\n \"fixed_until_due\": {\n \"amounts\": [\n {\n \"amount\": 300,\n \"date\": \"2026-12-13\"\n },\n {\n \"amount\": 100,\n \"date\": \"2026-12-15\"\n }\n ],\n \"calculation_type\": \"amount\"\n }\n },\n \"due_date\": \"2026-12-16\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 200\n },\n \"interest\": {\n \"amount\": 10,\n \"calculation_type\": \"daily_rate\"\n }\n },\n \"expiration_date\": \"2026-12-30\",\n \"external_id\": \"external id 123\",\n \"invoice_type\": \"invoice\",\n \"merchant\": {\n \"name\": \"Merchant Name\",\n \"tax_number\": \"12345678000199\"\n },\n \"options\": {\n \"fee\": 0\n },\n \"splits\": [\n {\n \"counterparty_recipient_id\": \"0198aaaa-1111-2222-3333-444444444444\",\n \"type\": \"percentage\",\n \"value\": 70\n },\n {\n \"counterparty_recipient_id\": \"0198bbbb-5555-6666-7777-888888888888\",\n \"type\": \"percentage\",\n \"value\": 30\n }\n ],\n \"wallet_type\": \"book_entry_electronic_bloquete\"\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/boletos")
.header("Trio-Version", "<trio-version>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 402,\n \"bank_account_id\": \"0196f83d-cafa-f412-1f1d-129cdf2dda49\",\n \"counterparty\": {\n \"address\": \"Rua Exemplo, 100\",\n \"city\": \"Curitiba\",\n \"district\": \"Centro\",\n \"name\": \"Payer Name\",\n \"postal_code\": \"80000000\",\n \"state\": \"PR\",\n \"tax_number\": \"12345678900\"\n },\n \"description\": \"Pago a trio.com.br\",\n \"due_detail\": {\n \"discount\": {\n \"fixed_until_due\": {\n \"amounts\": [\n {\n \"amount\": 300,\n \"date\": \"2026-12-13\"\n },\n {\n \"amount\": 100,\n \"date\": \"2026-12-15\"\n }\n ],\n \"calculation_type\": \"amount\"\n }\n },\n \"due_date\": \"2026-12-16\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 200\n },\n \"interest\": {\n \"amount\": 10,\n \"calculation_type\": \"daily_rate\"\n }\n },\n \"expiration_date\": \"2026-12-30\",\n \"external_id\": \"external id 123\",\n \"invoice_type\": \"invoice\",\n \"merchant\": {\n \"name\": \"Merchant Name\",\n \"tax_number\": \"12345678000199\"\n },\n \"options\": {\n \"fee\": 0\n },\n \"splits\": [\n {\n \"counterparty_recipient_id\": \"0198aaaa-1111-2222-3333-444444444444\",\n \"type\": \"percentage\",\n \"value\": 70\n },\n {\n \"counterparty_recipient_id\": \"0198bbbb-5555-6666-7777-888888888888\",\n \"type\": \"percentage\",\n \"value\": 30\n }\n ],\n \"wallet_type\": \"book_entry_electronic_bloquete\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.trio.com.br/v2/in/boletos")
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 \"amount\": 402,\n \"bank_account_id\": \"0196f83d-cafa-f412-1f1d-129cdf2dda49\",\n \"counterparty\": {\n \"address\": \"Rua Exemplo, 100\",\n \"city\": \"Curitiba\",\n \"district\": \"Centro\",\n \"name\": \"Payer Name\",\n \"postal_code\": \"80000000\",\n \"state\": \"PR\",\n \"tax_number\": \"12345678900\"\n },\n \"description\": \"Pago a trio.com.br\",\n \"due_detail\": {\n \"discount\": {\n \"fixed_until_due\": {\n \"amounts\": [\n {\n \"amount\": 300,\n \"date\": \"2026-12-13\"\n },\n {\n \"amount\": 100,\n \"date\": \"2026-12-15\"\n }\n ],\n \"calculation_type\": \"amount\"\n }\n },\n \"due_date\": \"2026-12-16\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 200\n },\n \"interest\": {\n \"amount\": 10,\n \"calculation_type\": \"daily_rate\"\n }\n },\n \"expiration_date\": \"2026-12-30\",\n \"external_id\": \"external id 123\",\n \"invoice_type\": \"invoice\",\n \"merchant\": {\n \"name\": \"Merchant Name\",\n \"tax_number\": \"12345678000199\"\n },\n \"options\": {\n \"fee\": 0\n },\n \"splits\": [\n {\n \"counterparty_recipient_id\": \"0198aaaa-1111-2222-3333-444444444444\",\n \"type\": \"percentage\",\n \"value\": 70\n },\n {\n \"counterparty_recipient_id\": \"0198bbbb-5555-6666-7777-888888888888\",\n \"type\": \"percentage\",\n \"value\": 30\n }\n ],\n \"wallet_type\": \"book_entry_electronic_bloquete\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"amount": {
"amount": 10000,
"currency": "BRL"
},
"bank_account_id": "0196f83d-cafa-f412-1f1d-129cdf2dda49",
"barcode": "12341111222233334444555566667777888899990000",
"boleto_url": "https://example.com/boleto_1",
"counterparty": {
"id": "000a89cb-f0c9-07ce-79c2-fc049bc253e0"
},
"description": "description",
"digitable_line": "12341111222233334444555566667777888899990000",
"due_detail": {
"discount": {
"fixed_until_due": {
"amounts": [
{
"amount": {
"amount": 300,
"currency": "BRL"
},
"date": "2026-12-13"
},
{
"amount": {
"amount": 100,
"currency": "BRL"
},
"date": "2026-12-15"
}
],
"calculation_type": "amount"
}
},
"due_date": "2026-12-16",
"fine": {
"calculation_type": "percentage",
"value": 200
},
"interest": {
"amount": {
"amount": 10,
"currency": "BRL"
},
"calculation_type": "daily_rate"
}
},
"expiration_date": "2026-12-30",
"external_id": "0190b2a4-8a3b-d123-050e-8d659ace1e2d",
"fee": {
"amount": 0,
"currency": "BRL"
},
"id": "0196f83d-cafa-f412-1f1d-129cdf2dda49",
"inserted_at": "2026-12-01T10:00:00.000000Z",
"invoice_type": "invoice",
"issue_date": "2026-12-01",
"notes": [
"note 1",
"note 2",
"note 3"
],
"status": "confirmed",
"updated_at": "2026-12-01T10:00:00.000000Z",
"wallet_type": "book_entry_electronic_bloquete"
}
}{
"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
Boleto payload
Body params to create a boleto
Amount of the boleto in cents
Required range:
x >= 1Unique identifier
Show child attributes
Show child attributes
Due detail of a boleto. Each rule takes amount (cents) for an amount calculation type and value (basis points, 100 = 1%) for a percentage one.
Show child attributes
Show child attributes
Example:
{ "discount": { "fixed_until_due": { "amounts": [ { "amount": 300, "date": "2026-12-13" }, { "amount": 100, "date": "2026-12-15" } ], "calculation_type": "amount" } }, "due_date": "2026-12-16", "fine": { "calculation_type": "percentage", "value": 200 }, "interest": { "amount": 10, "calculation_type": "daily_rate" } }
Last day on which the boleto can be paid
Boleto invoice type
Available options:
commercial_duplicate, indicated_commercial_duplicate, service_duplicate, indicated_service_duplicate, rural_duplicate, bill_of_exchange, commercial_credit_note, export_credit_note, industrial_credit_note, rural_credit_note, promissory_note, rural_promissory_note, triplicate_commercial, triplicate_service, insurance_note, receipt, invoice, debit_note, insurance_policy, school_fee, consortium_installment, invoice_note, debt_document, rural_product_certificate, warrant, state_active_debt, municipal_active_debt, federal_active_debt, condominium_fee, credit_card, others Boleto wallet type
Available options:
direct_electronic_partial_emission_booklet, book_entry_electronic_booklet, direct_electronic_with_emission_booklet, direct_electronic_no_emission_block_client, direct_electronic_no_emission_block_us, book_entry_electronic_bloquete, direct_electronic_no_emission_block_client2, direct_electronic_partial_emission_bloquete, direct_electronic_with_emission_bloquete, direct_electronic_no_emission_us_emission, direct_electronic_our_number_emission_banks_bloquete, direct_electronic_our_number_emission_banks_booklet Maximum string length:
25External ID
Maximum string length:
40Merchant to register as the split org merchant. When sent, it is saved.
Show child attributes
Show child attributes
Maximum array length:
3Optional boleto settings
Show child attributes
Show child attributes
Cashin split configurations
Show child attributes
Show child attributes
Response
Created
Response for boleto
A boleto
Show child attributes
Show child attributes
Example:
{ "amount": { "amount": 10000, "currency": "BRL" }, "bank_account_id": "0196f83d-cafa-f412-1f1d-129cdf2dda49", "barcode": "12341111222233334444555566667777888899990000", "boleto_url": "https://example.com/boleto_1", "counterparty": { "id": "000a89cb-f0c9-07ce-79c2-fc049bc253e0" }, "description": "description", "digitable_line": "12341111222233334444555566667777888899990000", "due_detail": { "discount": { "fixed_until_due": { "amounts": [ { "amount": { "amount": 300, "currency": "BRL" }, "date": "2026-12-13" }, { "amount": { "amount": 100, "currency": "BRL" }, "date": "2026-12-15" } ], "calculation_type": "amount" } }, "due_date": "2026-12-16", "fine": { "calculation_type": "percentage", "value": 200 }, "interest": { "amount": { "amount": 10, "currency": "BRL" }, "calculation_type": "daily_rate" } }, "expiration_date": "2026-12-30", "external_id": "0190b2a4-8a3b-d123-050e-8d659ace1e2d", "fee": { "amount": 0, "currency": "BRL" }, "id": "0196f83d-cafa-f412-1f1d-129cdf2dda49", "inserted_at": "2026-12-01T10:00:00.000000Z", "invoice_type": "invoice", "issue_date": "2026-12-01", "notes": ["note 1", "note 2", "note 3"], "status": "confirmed", "updated_at": "2026-12-01T10:00:00.000000Z", "wallet_type": "book_entry_electronic_bloquete" }