Create a new dynamic Pix QRCode
curl --request POST \
--url https://api.sandbox.trio.com.br/banking/cashin/pix/qrcodes \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": 10,
"counterparty": {
"bank_accounts": [
{
"branch": "1",
"digit": "1",
"ispb": "00000001",
"number": "80808080",
"type": "checking"
}
],
"name": "counterparty_name",
"tax_number": "05964110000197"
},
"description": "description",
"expiration_datetime": "2026-07-02T19:00:14.934158Z",
"external_id": "external_id",
"options": {
"allow_change_the_amount_on_payment": true,
"show_qrcode_image": true
},
"splits": [
{
"amount": 100,
"amount_type": "fixed",
"counterparty_split_recipient_id": "0196f83d-cafa-f412-1f1d-129cdf2dda49"
}
],
"virtual_account_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2"
}
'import requests
url = "https://api.sandbox.trio.com.br/banking/cashin/pix/qrcodes"
payload = {
"amount": 10,
"counterparty": {
"bank_accounts": [
{
"branch": "1",
"digit": "1",
"ispb": "00000001",
"number": "80808080",
"type": "checking"
}
],
"name": "counterparty_name",
"tax_number": "05964110000197"
},
"description": "description",
"expiration_datetime": "2026-07-02T19:00:14.934158Z",
"external_id": "external_id",
"options": {
"allow_change_the_amount_on_payment": True,
"show_qrcode_image": True
},
"splits": [
{
"amount": 100,
"amount_type": "fixed",
"counterparty_split_recipient_id": "0196f83d-cafa-f412-1f1d-129cdf2dda49"
}
],
"virtual_account_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 10,
counterparty: {
bank_accounts: [
{
branch: '1',
digit: '1',
ispb: '00000001',
number: '80808080',
type: 'checking'
}
],
name: 'counterparty_name',
tax_number: '05964110000197'
},
description: 'description',
expiration_datetime: '2026-07-02T19:00:14.934158Z',
external_id: 'external_id',
options: {allow_change_the_amount_on_payment: true, show_qrcode_image: true},
splits: [
{
amount: 100,
amount_type: 'fixed',
counterparty_split_recipient_id: '0196f83d-cafa-f412-1f1d-129cdf2dda49'
}
],
virtual_account_id: '41234d60-f6a9-4c9c-8cc3-5769ce9bbea2'
})
};
fetch('https://api.sandbox.trio.com.br/banking/cashin/pix/qrcodes', 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/banking/cashin/pix/qrcodes",
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' => 10,
'counterparty' => [
'bank_accounts' => [
[
'branch' => '1',
'digit' => '1',
'ispb' => '00000001',
'number' => '80808080',
'type' => 'checking'
]
],
'name' => 'counterparty_name',
'tax_number' => '05964110000197'
],
'description' => 'description',
'expiration_datetime' => '2026-07-02T19:00:14.934158Z',
'external_id' => 'external_id',
'options' => [
'allow_change_the_amount_on_payment' => true,
'show_qrcode_image' => true
],
'splits' => [
[
'amount' => 100,
'amount_type' => 'fixed',
'counterparty_split_recipient_id' => '0196f83d-cafa-f412-1f1d-129cdf2dda49'
]
],
'virtual_account_id' => '41234d60-f6a9-4c9c-8cc3-5769ce9bbea2'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$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/banking/cashin/pix/qrcodes"
payload := strings.NewReader("{\n \"amount\": 10,\n \"counterparty\": {\n \"bank_accounts\": [\n {\n \"branch\": \"1\",\n \"digit\": \"1\",\n \"ispb\": \"00000001\",\n \"number\": \"80808080\",\n \"type\": \"checking\"\n }\n ],\n \"name\": \"counterparty_name\",\n \"tax_number\": \"05964110000197\"\n },\n \"description\": \"description\",\n \"expiration_datetime\": \"2026-07-02T19:00:14.934158Z\",\n \"external_id\": \"external_id\",\n \"options\": {\n \"allow_change_the_amount_on_payment\": true,\n \"show_qrcode_image\": true\n },\n \"splits\": [\n {\n \"amount\": 100,\n \"amount_type\": \"fixed\",\n \"counterparty_split_recipient_id\": \"0196f83d-cafa-f412-1f1d-129cdf2dda49\"\n }\n ],\n \"virtual_account_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\"\n}")
req, _ := http.NewRequest("POST", url, payload)
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/banking/cashin/pix/qrcodes")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 10,\n \"counterparty\": {\n \"bank_accounts\": [\n {\n \"branch\": \"1\",\n \"digit\": \"1\",\n \"ispb\": \"00000001\",\n \"number\": \"80808080\",\n \"type\": \"checking\"\n }\n ],\n \"name\": \"counterparty_name\",\n \"tax_number\": \"05964110000197\"\n },\n \"description\": \"description\",\n \"expiration_datetime\": \"2026-07-02T19:00:14.934158Z\",\n \"external_id\": \"external_id\",\n \"options\": {\n \"allow_change_the_amount_on_payment\": true,\n \"show_qrcode_image\": true\n },\n \"splits\": [\n {\n \"amount\": 100,\n \"amount_type\": \"fixed\",\n \"counterparty_split_recipient_id\": \"0196f83d-cafa-f412-1f1d-129cdf2dda49\"\n }\n ],\n \"virtual_account_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.trio.com.br/banking/cashin/pix/qrcodes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amount\": 10,\n \"counterparty\": {\n \"bank_accounts\": [\n {\n \"branch\": \"1\",\n \"digit\": \"1\",\n \"ispb\": \"00000001\",\n \"number\": \"80808080\",\n \"type\": \"checking\"\n }\n ],\n \"name\": \"counterparty_name\",\n \"tax_number\": \"05964110000197\"\n },\n \"description\": \"description\",\n \"expiration_datetime\": \"2026-07-02T19:00:14.934158Z\",\n \"external_id\": \"external_id\",\n \"options\": {\n \"allow_change_the_amount_on_payment\": true,\n \"show_qrcode_image\": true\n },\n \"splits\": [\n {\n \"amount\": 100,\n \"amount_type\": \"fixed\",\n \"counterparty_split_recipient_id\": \"0196f83d-cafa-f412-1f1d-129cdf2dda49\"\n }\n ],\n \"virtual_account_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"allow_change_the_amount_on_payment": true,
"amount": {
"amount": 10,
"currency": "BRL"
},
"counterparty_bank_accounts": [
{
"branch": "0001",
"digit": "12345",
"ispb": "00000001",
"number": "12345",
"type": "checking"
}
],
"counterparty_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"description": "QRCode 1",
"expiration_datetime": "2026-07-02T19:00:14.719681Z",
"external_id": "external_id",
"hash": "123",
"id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"image": "12389HV8AHRIKVHQ374HFULAGLE8FAH0H4F890QHO2HEFOA7EUG8FU",
"origin_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"origin_type": "none",
"stages": [
{
"id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"status": "created",
"timestamp": "2026-07-02T19:00:14.719682Z"
}
],
"status": "created",
"timestamp": "2026-07-02T19:00:14.719672Z",
"virtual_account_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2"
}
}{
"error": {
"error_code": "UNAUTHORIZED",
"error_message": "Invalid credentials"
}
}{
"error": {
"error_code": "INTEGRATION_ERROR",
"error_message": "An unexpected issue occurred"
}
}Dynamic QR Code (Pix)
Create dynamic QR code
Creates a dynamic QR code
POST
/
banking
/
cashin
/
pix
/
qrcodes
Create a new dynamic Pix QRCode
curl --request POST \
--url https://api.sandbox.trio.com.br/banking/cashin/pix/qrcodes \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": 10,
"counterparty": {
"bank_accounts": [
{
"branch": "1",
"digit": "1",
"ispb": "00000001",
"number": "80808080",
"type": "checking"
}
],
"name": "counterparty_name",
"tax_number": "05964110000197"
},
"description": "description",
"expiration_datetime": "2026-07-02T19:00:14.934158Z",
"external_id": "external_id",
"options": {
"allow_change_the_amount_on_payment": true,
"show_qrcode_image": true
},
"splits": [
{
"amount": 100,
"amount_type": "fixed",
"counterparty_split_recipient_id": "0196f83d-cafa-f412-1f1d-129cdf2dda49"
}
],
"virtual_account_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2"
}
'import requests
url = "https://api.sandbox.trio.com.br/banking/cashin/pix/qrcodes"
payload = {
"amount": 10,
"counterparty": {
"bank_accounts": [
{
"branch": "1",
"digit": "1",
"ispb": "00000001",
"number": "80808080",
"type": "checking"
}
],
"name": "counterparty_name",
"tax_number": "05964110000197"
},
"description": "description",
"expiration_datetime": "2026-07-02T19:00:14.934158Z",
"external_id": "external_id",
"options": {
"allow_change_the_amount_on_payment": True,
"show_qrcode_image": True
},
"splits": [
{
"amount": 100,
"amount_type": "fixed",
"counterparty_split_recipient_id": "0196f83d-cafa-f412-1f1d-129cdf2dda49"
}
],
"virtual_account_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 10,
counterparty: {
bank_accounts: [
{
branch: '1',
digit: '1',
ispb: '00000001',
number: '80808080',
type: 'checking'
}
],
name: 'counterparty_name',
tax_number: '05964110000197'
},
description: 'description',
expiration_datetime: '2026-07-02T19:00:14.934158Z',
external_id: 'external_id',
options: {allow_change_the_amount_on_payment: true, show_qrcode_image: true},
splits: [
{
amount: 100,
amount_type: 'fixed',
counterparty_split_recipient_id: '0196f83d-cafa-f412-1f1d-129cdf2dda49'
}
],
virtual_account_id: '41234d60-f6a9-4c9c-8cc3-5769ce9bbea2'
})
};
fetch('https://api.sandbox.trio.com.br/banking/cashin/pix/qrcodes', 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/banking/cashin/pix/qrcodes",
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' => 10,
'counterparty' => [
'bank_accounts' => [
[
'branch' => '1',
'digit' => '1',
'ispb' => '00000001',
'number' => '80808080',
'type' => 'checking'
]
],
'name' => 'counterparty_name',
'tax_number' => '05964110000197'
],
'description' => 'description',
'expiration_datetime' => '2026-07-02T19:00:14.934158Z',
'external_id' => 'external_id',
'options' => [
'allow_change_the_amount_on_payment' => true,
'show_qrcode_image' => true
],
'splits' => [
[
'amount' => 100,
'amount_type' => 'fixed',
'counterparty_split_recipient_id' => '0196f83d-cafa-f412-1f1d-129cdf2dda49'
]
],
'virtual_account_id' => '41234d60-f6a9-4c9c-8cc3-5769ce9bbea2'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$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/banking/cashin/pix/qrcodes"
payload := strings.NewReader("{\n \"amount\": 10,\n \"counterparty\": {\n \"bank_accounts\": [\n {\n \"branch\": \"1\",\n \"digit\": \"1\",\n \"ispb\": \"00000001\",\n \"number\": \"80808080\",\n \"type\": \"checking\"\n }\n ],\n \"name\": \"counterparty_name\",\n \"tax_number\": \"05964110000197\"\n },\n \"description\": \"description\",\n \"expiration_datetime\": \"2026-07-02T19:00:14.934158Z\",\n \"external_id\": \"external_id\",\n \"options\": {\n \"allow_change_the_amount_on_payment\": true,\n \"show_qrcode_image\": true\n },\n \"splits\": [\n {\n \"amount\": 100,\n \"amount_type\": \"fixed\",\n \"counterparty_split_recipient_id\": \"0196f83d-cafa-f412-1f1d-129cdf2dda49\"\n }\n ],\n \"virtual_account_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\"\n}")
req, _ := http.NewRequest("POST", url, payload)
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/banking/cashin/pix/qrcodes")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 10,\n \"counterparty\": {\n \"bank_accounts\": [\n {\n \"branch\": \"1\",\n \"digit\": \"1\",\n \"ispb\": \"00000001\",\n \"number\": \"80808080\",\n \"type\": \"checking\"\n }\n ],\n \"name\": \"counterparty_name\",\n \"tax_number\": \"05964110000197\"\n },\n \"description\": \"description\",\n \"expiration_datetime\": \"2026-07-02T19:00:14.934158Z\",\n \"external_id\": \"external_id\",\n \"options\": {\n \"allow_change_the_amount_on_payment\": true,\n \"show_qrcode_image\": true\n },\n \"splits\": [\n {\n \"amount\": 100,\n \"amount_type\": \"fixed\",\n \"counterparty_split_recipient_id\": \"0196f83d-cafa-f412-1f1d-129cdf2dda49\"\n }\n ],\n \"virtual_account_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.trio.com.br/banking/cashin/pix/qrcodes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amount\": 10,\n \"counterparty\": {\n \"bank_accounts\": [\n {\n \"branch\": \"1\",\n \"digit\": \"1\",\n \"ispb\": \"00000001\",\n \"number\": \"80808080\",\n \"type\": \"checking\"\n }\n ],\n \"name\": \"counterparty_name\",\n \"tax_number\": \"05964110000197\"\n },\n \"description\": \"description\",\n \"expiration_datetime\": \"2026-07-02T19:00:14.934158Z\",\n \"external_id\": \"external_id\",\n \"options\": {\n \"allow_change_the_amount_on_payment\": true,\n \"show_qrcode_image\": true\n },\n \"splits\": [\n {\n \"amount\": 100,\n \"amount_type\": \"fixed\",\n \"counterparty_split_recipient_id\": \"0196f83d-cafa-f412-1f1d-129cdf2dda49\"\n }\n ],\n \"virtual_account_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"allow_change_the_amount_on_payment": true,
"amount": {
"amount": 10,
"currency": "BRL"
},
"counterparty_bank_accounts": [
{
"branch": "0001",
"digit": "12345",
"ispb": "00000001",
"number": "12345",
"type": "checking"
}
],
"counterparty_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"description": "QRCode 1",
"expiration_datetime": "2026-07-02T19:00:14.719681Z",
"external_id": "external_id",
"hash": "123",
"id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"image": "12389HV8AHRIKVHQ374HFULAGLE8FAH0H4F890QHO2HEFOA7EUG8FU",
"origin_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"origin_type": "none",
"stages": [
{
"id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"status": "created",
"timestamp": "2026-07-02T19:00:14.719682Z"
}
],
"status": "created",
"timestamp": "2026-07-02T19:00:14.719672Z",
"virtual_account_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2"
}
}{
"error": {
"error_code": "UNAUTHORIZED",
"error_message": "Invalid credentials"
}
}{
"error": {
"error_code": "INTEGRATION_ERROR",
"error_message": "An unexpected issue occurred"
}
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Body
application/json
Pix QRCode payload
Body params to create a dynamic QRCode
Amount value of the dynamic QRCode
QRCode creation options
Show child attributes
Show child attributes
Virtual Account ID
Counterparty information
Show child attributes
Show child attributes
Description of the dynamic QRCode
Expiration datetime
External ID of the dynamic QRCode
Platform ID of the dynamic QRCode
splits
(SplitPaymentFixedCreateParams · object | SplitPaymentPercentageCreateParams · object)[] | null
Split payment allocations to apply after the Pix QRCode transaction is received and settled. Use fixed for amounts in cents or percentage for a percentage of the received amount. Percentage allocations cannot total more than 100. Fixed allocations cannot total more than the paid amount. Any remaining value stays with the original receiver.
Fixed split payment information used to transfer part of the received transaction after settlement. The total fixed split amount cannot exceed the paid amount. Any remaining value stays with the original receiver.
- SplitPaymentFixedCreateParams
- SplitPaymentPercentageCreateParams
Show child attributes
Show child attributes
Example:
{
"amount": 100,
"amount_type": "fixed",
"counterparty_split_recipient_id": "0196f83d-cafa-f412-1f1d-129cdf2dda49"
}
Response
Pix QRCode
Response schema for a single dynamic QRCode
Response schema for a single dynamic QRCode
Show child attributes
Show child attributes
Example:
{
"allow_change_the_amount_on_payment": true,
"amount": { "amount": 10, "currency": "BRL" },
"counterparty_bank_accounts": [
{
"branch": "0001",
"digit": "12345",
"ispb": "00000001",
"number": "12345",
"type": "checking"
}
],
"counterparty_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"description": "QRCode 1",
"expiration_datetime": "2026-07-02T19:00:14.719681Z",
"external_id": "external_id",
"hash": "123",
"id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"image": "12389HV8AHRIKVHQ374HFULAGLE8FAH0H4F890QHO2HEFOA7EUG8FU",
"origin_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"origin_type": "none",
"stages": [
{
"id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"status": "created",
"timestamp": "2026-07-02T19:00:14.719682Z"
}
],
"status": "created",
"timestamp": "2026-07-02T19:00:14.719672Z",
"virtual_account_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2"
}
⌘I