Create a new static QRCode
curl --request POST \
--url https://api.sandbox.trio.com.br/v2/in/pix/qrcodes/static \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'Trio-Version: <trio-version>' \
--data '
{
"amount": 2000,
"bank_account_id": "01919020-51ee-527b-5147-3feacb8ea333",
"description": "description",
"external_id": "external_id",
"options": {
"fee": 0,
"show_qrcode_image": false
}
}
'import requests
url = "https://api.sandbox.trio.com.br/v2/in/pix/qrcodes/static"
payload = {
"amount": 2000,
"bank_account_id": "01919020-51ee-527b-5147-3feacb8ea333",
"description": "description",
"external_id": "external_id",
"options": {
"fee": 0,
"show_qrcode_image": False
}
}
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: 2000,
bank_account_id: '01919020-51ee-527b-5147-3feacb8ea333',
description: 'description',
external_id: 'external_id',
options: {fee: 0, show_qrcode_image: false}
})
};
fetch('https://api.sandbox.trio.com.br/v2/in/pix/qrcodes/static', 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/static",
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' => 2000,
'bank_account_id' => '01919020-51ee-527b-5147-3feacb8ea333',
'description' => 'description',
'external_id' => 'external_id',
'options' => [
'fee' => 0,
'show_qrcode_image' => false
]
]),
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/static"
payload := strings.NewReader("{\n \"amount\": 2000,\n \"bank_account_id\": \"01919020-51ee-527b-5147-3feacb8ea333\",\n \"description\": \"description\",\n \"external_id\": \"external_id\",\n \"options\": {\n \"fee\": 0,\n \"show_qrcode_image\": false\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/static")
.header("Trio-Version", "<trio-version>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 2000,\n \"bank_account_id\": \"01919020-51ee-527b-5147-3feacb8ea333\",\n \"description\": \"description\",\n \"external_id\": \"external_id\",\n \"options\": {\n \"fee\": 0,\n \"show_qrcode_image\": false\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.trio.com.br/v2/in/pix/qrcodes/static")
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\": 2000,\n \"bank_account_id\": \"01919020-51ee-527b-5147-3feacb8ea333\",\n \"description\": \"description\",\n \"external_id\": \"external_id\",\n \"options\": {\n \"fee\": 0,\n \"show_qrcode_image\": false\n }\n}"
response = http.request(request)
puts response.read_body{
"data": {
"amount": {
"amount": 10,
"currency": "BRL"
},
"bank_account_id": "019252ca-4859-55f0-0f20-6f02250b5acd",
"description": "description",
"external_id": "external_id",
"fee": {
"amount": 0,
"currency": "BRL"
},
"hash": "00020126580014br.gov.bcb.pix0136019252ca-48b2-e95e-c398-3133a04a5b3e52040000530398654040.105802BR5911brcode_name6011brcode_city622605222HwV3MJojKRR2FxvgYTgYF6304C4D0",
"id": "019252ca-4a5b-b711-2371-0a0142807c75",
"inserted_at": "2024-10-03T14:30:42.011732Z",
"origin": {
"id": null,
"type": null
},
"status": "created",
"updated_at": "2024-10-03T14:30:42.011732Z"
}
}{
"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"
}
]
}
}Static QR Code
Create static QR code
Create a new static QRCode
POST
/
v2
/
in
/
pix
/
qrcodes
/
static
Create a new static QRCode
curl --request POST \
--url https://api.sandbox.trio.com.br/v2/in/pix/qrcodes/static \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'Trio-Version: <trio-version>' \
--data '
{
"amount": 2000,
"bank_account_id": "01919020-51ee-527b-5147-3feacb8ea333",
"description": "description",
"external_id": "external_id",
"options": {
"fee": 0,
"show_qrcode_image": false
}
}
'import requests
url = "https://api.sandbox.trio.com.br/v2/in/pix/qrcodes/static"
payload = {
"amount": 2000,
"bank_account_id": "01919020-51ee-527b-5147-3feacb8ea333",
"description": "description",
"external_id": "external_id",
"options": {
"fee": 0,
"show_qrcode_image": False
}
}
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: 2000,
bank_account_id: '01919020-51ee-527b-5147-3feacb8ea333',
description: 'description',
external_id: 'external_id',
options: {fee: 0, show_qrcode_image: false}
})
};
fetch('https://api.sandbox.trio.com.br/v2/in/pix/qrcodes/static', 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/static",
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' => 2000,
'bank_account_id' => '01919020-51ee-527b-5147-3feacb8ea333',
'description' => 'description',
'external_id' => 'external_id',
'options' => [
'fee' => 0,
'show_qrcode_image' => false
]
]),
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/static"
payload := strings.NewReader("{\n \"amount\": 2000,\n \"bank_account_id\": \"01919020-51ee-527b-5147-3feacb8ea333\",\n \"description\": \"description\",\n \"external_id\": \"external_id\",\n \"options\": {\n \"fee\": 0,\n \"show_qrcode_image\": false\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/static")
.header("Trio-Version", "<trio-version>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 2000,\n \"bank_account_id\": \"01919020-51ee-527b-5147-3feacb8ea333\",\n \"description\": \"description\",\n \"external_id\": \"external_id\",\n \"options\": {\n \"fee\": 0,\n \"show_qrcode_image\": false\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.trio.com.br/v2/in/pix/qrcodes/static")
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\": 2000,\n \"bank_account_id\": \"01919020-51ee-527b-5147-3feacb8ea333\",\n \"description\": \"description\",\n \"external_id\": \"external_id\",\n \"options\": {\n \"fee\": 0,\n \"show_qrcode_image\": false\n }\n}"
response = http.request(request)
puts response.read_body{
"data": {
"amount": {
"amount": 10,
"currency": "BRL"
},
"bank_account_id": "019252ca-4859-55f0-0f20-6f02250b5acd",
"description": "description",
"external_id": "external_id",
"fee": {
"amount": 0,
"currency": "BRL"
},
"hash": "00020126580014br.gov.bcb.pix0136019252ca-48b2-e95e-c398-3133a04a5b3e52040000530398654040.105802BR5911brcode_name6011brcode_city622605222HwV3MJojKRR2FxvgYTgYF6304C4D0",
"id": "019252ca-4a5b-b711-2371-0a0142807c75",
"inserted_at": "2024-10-03T14:30:42.011732Z",
"origin": {
"id": null,
"type": null
},
"status": "created",
"updated_at": "2024-10-03T14:30:42.011732Z"
}
}{
"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 static QRCode payload
Body params to create a static QRCode
Amount in cents. Send 0 for an open-amount code: the payer chooses the amount.
Required range:
x >= 0Bank account ID
Create options
Show child attributes
Show child attributes
Description of the static QRCode
External ID of the static QRCode
Merchant to register as the split org merchant. When sent, it is saved.
Show child attributes
Show child attributes
Platform ID of the static QRCode
Cashin split configurations
Show child attributes
Show child attributes
Response
StaticBrcode
Response for a single static QRCode
A static QRCode, 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": 10, "currency": "BRL" },
"bank_account_id": "019252ca-4859-55f0-0f20-6f02250b5acd",
"description": "description",
"external_id": "external_id",
"fee": { "amount": 0, "currency": "BRL" },
"hash": "00020126580014br.gov.bcb.pix0136019252ca-48b2-e95e-c398-3133a04a5b3e52040000530398654040.105802BR5911brcode_name6011brcode_city622605222HwV3MJojKRR2FxvgYTgYF6304C4D0",
"id": "019252ca-4a5b-b711-2371-0a0142807c75",
"inserted_at": "2024-10-03T14:30:42.011732Z",
"origin": { "id": null, "type": null },
"status": "created",
"updated_at": "2024-10-03T14:30:42.011732Z"
}