Create a new dynamic pix QRCode with due date
curl --request POST \
--url https://api.sandbox.trio.com.br/v2/in/pix/qrcodes/with_due \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'Trio-Version: <trio-version>' \
--data '
{
"amount": 1000,
"bank_account_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"counterparty": {
"info": {
"address": "Rua Exemplo, 123",
"city": "Curitiba",
"email": "counterparty@mail.com",
"postal_code": "80000000",
"state": "PR"
},
"name": "counterparty_name",
"tax_number": "12345678900"
},
"description": "description",
"due_detail": {
"due_date": "2026-10-27",
"fine": {
"calculation_type": "percentage",
"value": 200
},
"interest": {
"calculation_days": "calendar",
"calculation_period": "month",
"calculation_type": "percentage",
"value": 100
}
},
"expiration_days": 30,
"external_id": "external_id",
"options": {
"allow_change_the_amount_on_payment": false,
"show_qrcode_image": true
}
}
'import requests
url = "https://api.sandbox.trio.com.br/v2/in/pix/qrcodes/with_due"
payload = {
"amount": 1000,
"bank_account_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"counterparty": {
"info": {
"address": "Rua Exemplo, 123",
"city": "Curitiba",
"email": "counterparty@mail.com",
"postal_code": "80000000",
"state": "PR"
},
"name": "counterparty_name",
"tax_number": "12345678900"
},
"description": "description",
"due_detail": {
"due_date": "2026-10-27",
"fine": {
"calculation_type": "percentage",
"value": 200
},
"interest": {
"calculation_days": "calendar",
"calculation_period": "month",
"calculation_type": "percentage",
"value": 100
}
},
"expiration_days": 30,
"external_id": "external_id",
"options": {
"allow_change_the_amount_on_payment": False,
"show_qrcode_image": True
}
}
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: 1000,
bank_account_id: '41234d60-f6a9-4c9c-8cc3-5769ce9bbea2',
counterparty: {
info: {
address: 'Rua Exemplo, 123',
city: 'Curitiba',
email: 'counterparty@mail.com',
postal_code: '80000000',
state: 'PR'
},
name: 'counterparty_name',
tax_number: '12345678900'
},
description: 'description',
due_detail: {
due_date: '2026-10-27',
fine: {calculation_type: 'percentage', value: 200},
interest: {
calculation_days: 'calendar',
calculation_period: 'month',
calculation_type: 'percentage',
value: 100
}
},
expiration_days: 30,
external_id: 'external_id',
options: {allow_change_the_amount_on_payment: false, show_qrcode_image: true}
})
};
fetch('https://api.sandbox.trio.com.br/v2/in/pix/qrcodes/with_due', 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/qrcodes/with_due",
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' => 1000,
'bank_account_id' => '41234d60-f6a9-4c9c-8cc3-5769ce9bbea2',
'counterparty' => [
'info' => [
'address' => 'Rua Exemplo, 123',
'city' => 'Curitiba',
'email' => 'counterparty@mail.com',
'postal_code' => '80000000',
'state' => 'PR'
],
'name' => 'counterparty_name',
'tax_number' => '12345678900'
],
'description' => 'description',
'due_detail' => [
'due_date' => '2026-10-27',
'fine' => [
'calculation_type' => 'percentage',
'value' => 200
],
'interest' => [
'calculation_days' => 'calendar',
'calculation_period' => 'month',
'calculation_type' => 'percentage',
'value' => 100
]
],
'expiration_days' => 30,
'external_id' => 'external_id',
'options' => [
'allow_change_the_amount_on_payment' => false,
'show_qrcode_image' => true
]
]),
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/qrcodes/with_due"
payload := strings.NewReader("{\n \"amount\": 1000,\n \"bank_account_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\",\n \"counterparty\": {\n \"info\": {\n \"address\": \"Rua Exemplo, 123\",\n \"city\": \"Curitiba\",\n \"email\": \"counterparty@mail.com\",\n \"postal_code\": \"80000000\",\n \"state\": \"PR\"\n },\n \"name\": \"counterparty_name\",\n \"tax_number\": \"12345678900\"\n },\n \"description\": \"description\",\n \"due_detail\": {\n \"due_date\": \"2026-10-27\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 200\n },\n \"interest\": {\n \"calculation_days\": \"calendar\",\n \"calculation_period\": \"month\",\n \"calculation_type\": \"percentage\",\n \"value\": 100\n }\n },\n \"expiration_days\": 30,\n \"external_id\": \"external_id\",\n \"options\": {\n \"allow_change_the_amount_on_payment\": false,\n \"show_qrcode_image\": true\n }\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/qrcodes/with_due")
.header("Trio-Version", "<trio-version>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 1000,\n \"bank_account_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\",\n \"counterparty\": {\n \"info\": {\n \"address\": \"Rua Exemplo, 123\",\n \"city\": \"Curitiba\",\n \"email\": \"counterparty@mail.com\",\n \"postal_code\": \"80000000\",\n \"state\": \"PR\"\n },\n \"name\": \"counterparty_name\",\n \"tax_number\": \"12345678900\"\n },\n \"description\": \"description\",\n \"due_detail\": {\n \"due_date\": \"2026-10-27\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 200\n },\n \"interest\": {\n \"calculation_days\": \"calendar\",\n \"calculation_period\": \"month\",\n \"calculation_type\": \"percentage\",\n \"value\": 100\n }\n },\n \"expiration_days\": 30,\n \"external_id\": \"external_id\",\n \"options\": {\n \"allow_change_the_amount_on_payment\": false,\n \"show_qrcode_image\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.trio.com.br/v2/in/pix/qrcodes/with_due")
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\": 1000,\n \"bank_account_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\",\n \"counterparty\": {\n \"info\": {\n \"address\": \"Rua Exemplo, 123\",\n \"city\": \"Curitiba\",\n \"email\": \"counterparty@mail.com\",\n \"postal_code\": \"80000000\",\n \"state\": \"PR\"\n },\n \"name\": \"counterparty_name\",\n \"tax_number\": \"12345678900\"\n },\n \"description\": \"description\",\n \"due_detail\": {\n \"due_date\": \"2026-10-27\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 200\n },\n \"interest\": {\n \"calculation_days\": \"calendar\",\n \"calculation_period\": \"month\",\n \"calculation_type\": \"percentage\",\n \"value\": 100\n }\n },\n \"expiration_days\": 30,\n \"external_id\": \"external_id\",\n \"options\": {\n \"allow_change_the_amount_on_payment\": false,\n \"show_qrcode_image\": true\n }\n}"
response = http.request(request)
puts response.read_body{
"data": {
"amount": {
"amount": 1000,
"currency": "BRL"
},
"bank_account_id": "01a0d98d-7547-22cf-f4f6-e8a63cd72cf5",
"counterparty": {
"id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2"
},
"description": "description",
"due_detail": {
"due_date": "2026-09-30",
"fine": {
"calculation_type": "percentage",
"value": 200
}
},
"expiration_datetime": "2026-10-06T02:59:59.999999Z",
"external_id": "external_id",
"fee": {
"amount": 0,
"currency": "BRL"
},
"hash": "00020101021226640014br.gov.bcb.pix2542qrcode.trio.com.br/cobv/01M3CRTXYFDDFTA8MF4XH2183B5204000053039865802BR5909NAME TEST6009NAME TEST62070503***63042C42",
"id": "01a0d98d-77cf-6b5f-a522-8f276220a06b",
"inserted_at": "2026-09-25T17:12:02.255000Z",
"options": {
"allow_change_the_amount_on_payment": true
},
"origin": {
"id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"type": "none"
},
"status": "created",
"updated_at": "2026-09-25T17:12:02.255000Z"
}
}{
"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"
}
]
}
}Dynamic QR Code with Due Date
Create dynamic QR code with due date
Creates a new dynamic pix QRCode with due date, allowing fine, interest, rebate and discount rules
POST
/
v2
/
in
/
pix
/
qrcodes
/
with_due
Create a new dynamic pix QRCode with due date
curl --request POST \
--url https://api.sandbox.trio.com.br/v2/in/pix/qrcodes/with_due \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'Trio-Version: <trio-version>' \
--data '
{
"amount": 1000,
"bank_account_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"counterparty": {
"info": {
"address": "Rua Exemplo, 123",
"city": "Curitiba",
"email": "counterparty@mail.com",
"postal_code": "80000000",
"state": "PR"
},
"name": "counterparty_name",
"tax_number": "12345678900"
},
"description": "description",
"due_detail": {
"due_date": "2026-10-27",
"fine": {
"calculation_type": "percentage",
"value": 200
},
"interest": {
"calculation_days": "calendar",
"calculation_period": "month",
"calculation_type": "percentage",
"value": 100
}
},
"expiration_days": 30,
"external_id": "external_id",
"options": {
"allow_change_the_amount_on_payment": false,
"show_qrcode_image": true
}
}
'import requests
url = "https://api.sandbox.trio.com.br/v2/in/pix/qrcodes/with_due"
payload = {
"amount": 1000,
"bank_account_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"counterparty": {
"info": {
"address": "Rua Exemplo, 123",
"city": "Curitiba",
"email": "counterparty@mail.com",
"postal_code": "80000000",
"state": "PR"
},
"name": "counterparty_name",
"tax_number": "12345678900"
},
"description": "description",
"due_detail": {
"due_date": "2026-10-27",
"fine": {
"calculation_type": "percentage",
"value": 200
},
"interest": {
"calculation_days": "calendar",
"calculation_period": "month",
"calculation_type": "percentage",
"value": 100
}
},
"expiration_days": 30,
"external_id": "external_id",
"options": {
"allow_change_the_amount_on_payment": False,
"show_qrcode_image": True
}
}
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: 1000,
bank_account_id: '41234d60-f6a9-4c9c-8cc3-5769ce9bbea2',
counterparty: {
info: {
address: 'Rua Exemplo, 123',
city: 'Curitiba',
email: 'counterparty@mail.com',
postal_code: '80000000',
state: 'PR'
},
name: 'counterparty_name',
tax_number: '12345678900'
},
description: 'description',
due_detail: {
due_date: '2026-10-27',
fine: {calculation_type: 'percentage', value: 200},
interest: {
calculation_days: 'calendar',
calculation_period: 'month',
calculation_type: 'percentage',
value: 100
}
},
expiration_days: 30,
external_id: 'external_id',
options: {allow_change_the_amount_on_payment: false, show_qrcode_image: true}
})
};
fetch('https://api.sandbox.trio.com.br/v2/in/pix/qrcodes/with_due', 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/qrcodes/with_due",
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' => 1000,
'bank_account_id' => '41234d60-f6a9-4c9c-8cc3-5769ce9bbea2',
'counterparty' => [
'info' => [
'address' => 'Rua Exemplo, 123',
'city' => 'Curitiba',
'email' => 'counterparty@mail.com',
'postal_code' => '80000000',
'state' => 'PR'
],
'name' => 'counterparty_name',
'tax_number' => '12345678900'
],
'description' => 'description',
'due_detail' => [
'due_date' => '2026-10-27',
'fine' => [
'calculation_type' => 'percentage',
'value' => 200
],
'interest' => [
'calculation_days' => 'calendar',
'calculation_period' => 'month',
'calculation_type' => 'percentage',
'value' => 100
]
],
'expiration_days' => 30,
'external_id' => 'external_id',
'options' => [
'allow_change_the_amount_on_payment' => false,
'show_qrcode_image' => true
]
]),
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/qrcodes/with_due"
payload := strings.NewReader("{\n \"amount\": 1000,\n \"bank_account_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\",\n \"counterparty\": {\n \"info\": {\n \"address\": \"Rua Exemplo, 123\",\n \"city\": \"Curitiba\",\n \"email\": \"counterparty@mail.com\",\n \"postal_code\": \"80000000\",\n \"state\": \"PR\"\n },\n \"name\": \"counterparty_name\",\n \"tax_number\": \"12345678900\"\n },\n \"description\": \"description\",\n \"due_detail\": {\n \"due_date\": \"2026-10-27\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 200\n },\n \"interest\": {\n \"calculation_days\": \"calendar\",\n \"calculation_period\": \"month\",\n \"calculation_type\": \"percentage\",\n \"value\": 100\n }\n },\n \"expiration_days\": 30,\n \"external_id\": \"external_id\",\n \"options\": {\n \"allow_change_the_amount_on_payment\": false,\n \"show_qrcode_image\": true\n }\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/qrcodes/with_due")
.header("Trio-Version", "<trio-version>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 1000,\n \"bank_account_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\",\n \"counterparty\": {\n \"info\": {\n \"address\": \"Rua Exemplo, 123\",\n \"city\": \"Curitiba\",\n \"email\": \"counterparty@mail.com\",\n \"postal_code\": \"80000000\",\n \"state\": \"PR\"\n },\n \"name\": \"counterparty_name\",\n \"tax_number\": \"12345678900\"\n },\n \"description\": \"description\",\n \"due_detail\": {\n \"due_date\": \"2026-10-27\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 200\n },\n \"interest\": {\n \"calculation_days\": \"calendar\",\n \"calculation_period\": \"month\",\n \"calculation_type\": \"percentage\",\n \"value\": 100\n }\n },\n \"expiration_days\": 30,\n \"external_id\": \"external_id\",\n \"options\": {\n \"allow_change_the_amount_on_payment\": false,\n \"show_qrcode_image\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.trio.com.br/v2/in/pix/qrcodes/with_due")
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\": 1000,\n \"bank_account_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\",\n \"counterparty\": {\n \"info\": {\n \"address\": \"Rua Exemplo, 123\",\n \"city\": \"Curitiba\",\n \"email\": \"counterparty@mail.com\",\n \"postal_code\": \"80000000\",\n \"state\": \"PR\"\n },\n \"name\": \"counterparty_name\",\n \"tax_number\": \"12345678900\"\n },\n \"description\": \"description\",\n \"due_detail\": {\n \"due_date\": \"2026-10-27\",\n \"fine\": {\n \"calculation_type\": \"percentage\",\n \"value\": 200\n },\n \"interest\": {\n \"calculation_days\": \"calendar\",\n \"calculation_period\": \"month\",\n \"calculation_type\": \"percentage\",\n \"value\": 100\n }\n },\n \"expiration_days\": 30,\n \"external_id\": \"external_id\",\n \"options\": {\n \"allow_change_the_amount_on_payment\": false,\n \"show_qrcode_image\": true\n }\n}"
response = http.request(request)
puts response.read_body{
"data": {
"amount": {
"amount": 1000,
"currency": "BRL"
},
"bank_account_id": "01a0d98d-7547-22cf-f4f6-e8a63cd72cf5",
"counterparty": {
"id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2"
},
"description": "description",
"due_detail": {
"due_date": "2026-09-30",
"fine": {
"calculation_type": "percentage",
"value": 200
}
},
"expiration_datetime": "2026-10-06T02:59:59.999999Z",
"external_id": "external_id",
"fee": {
"amount": 0,
"currency": "BRL"
},
"hash": "00020101021226640014br.gov.bcb.pix2542qrcode.trio.com.br/cobv/01M3CRTXYFDDFTA8MF4XH2183B5204000053039865802BR5909NAME TEST6009NAME TEST62070503***63042C42",
"id": "01a0d98d-77cf-6b5f-a522-8f276220a06b",
"inserted_at": "2026-09-25T17:12:02.255000Z",
"options": {
"allow_change_the_amount_on_payment": true
},
"origin": {
"id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"type": "none"
},
"status": "created",
"updated_at": "2026-09-25T17:12:02.255000Z"
}
}{
"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
Pix QRCode with due date payload
Body params to create a dynamic QRCode with due date
Amount value of the dynamic QRCode
Bank Account ID
Counterparty (payer) information. Required for QRCodes with due date
Show child attributes
Show child attributes
Due detail of a Pix charge with due date. Each rule takes amount (cents) for the amount calculation type and value (basis points, 100 = 1%) for percentage.
Show child attributes
Show child attributes
Example:
{
"discount": {
"per_day_antecipated": {
"amount": 50,
"calculation_days": "working",
"calculation_type": "amount"
}
},
"due_date": "2026-09-30",
"fine": {
"calculation_type": "percentage",
"value": 200
},
"interest": {
"calculation_days": "calendar",
"calculation_period": "month",
"calculation_type": "percentage",
"value": 100
}
}
QRCode creation options
Show child attributes
Show child attributes
Description of the dynamic QRCode
Number of days after the due date during which the QRCode can still be paid. Defaults to 1
Required range:
x >= 0External ID of the dynamic QRCode
Merchant to register as the split org merchant. When sent, it is saved.
Show child attributes
Show child attributes
Platform ID of the dynamic QRCode
Cashin split configurations
Show child attributes
Show child attributes
Response
Pix QRCode with due date
Response schema for a single dynamic QRCode with due date
A dynamic QRCode with due date, as returned by show and create. image is present only when create was asked for it with options.show_qrcode_image.
Show child attributes
Show child attributes
Example:
{
"amount": { "amount": 1000, "currency": "BRL" },
"bank_account_id": "01a0d98d-7547-22cf-f4f6-e8a63cd72cf5",
"counterparty": {
"id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2"
},
"description": "description",
"due_detail": {
"due_date": "2026-09-30",
"fine": {
"calculation_type": "percentage",
"value": 200
}
},
"expiration_datetime": "2026-10-06T02:59:59.999999Z",
"external_id": "external_id",
"fee": { "amount": 0, "currency": "BRL" },
"hash": "00020101021226640014br.gov.bcb.pix2542qrcode.trio.com.br/cobv/01M3CRTXYFDDFTA8MF4XH2183B5204000053039865802BR5909NAME TEST6009NAME TEST62070503***63042C42",
"id": "01a0d98d-77cf-6b5f-a522-8f276220a06b",
"inserted_at": "2026-09-25T17:12:02.255000Z",
"options": {
"allow_change_the_amount_on_payment": true
},
"origin": {
"id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"type": "none"
},
"status": "created",
"updated_at": "2026-09-25T17:12:02.255000Z"
}