Check a brcode hash
curl --request POST \
--url https://api.sandbox.trio.com.br/v2/out/pix/brcodes/check \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'Trio-Version: <trio-version>' \
--data '
{
"entity_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"hash": "00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01JM0B0TY9BT4375S074Q00E0M5204000053039865802BR5908John Doe6009Sao Paulo62070503***6304F3A0"
}
'import requests
url = "https://api.sandbox.trio.com.br/v2/out/pix/brcodes/check"
payload = {
"entity_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"hash": "00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01JM0B0TY9BT4375S074Q00E0M5204000053039865802BR5908John Doe6009Sao Paulo62070503***6304F3A0"
}
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({
entity_id: '41234d60-f6a9-4c9c-8cc3-5769ce9bbea2',
hash: '00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01JM0B0TY9BT4375S074Q00E0M5204000053039865802BR5908John Doe6009Sao Paulo62070503***6304F3A0'
})
};
fetch('https://api.sandbox.trio.com.br/v2/out/pix/brcodes/check', 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/out/pix/brcodes/check",
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([
'entity_id' => '41234d60-f6a9-4c9c-8cc3-5769ce9bbea2',
'hash' => '00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01JM0B0TY9BT4375S074Q00E0M5204000053039865802BR5908John Doe6009Sao Paulo62070503***6304F3A0'
]),
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/out/pix/brcodes/check"
payload := strings.NewReader("{\n \"entity_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\",\n \"hash\": \"00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01JM0B0TY9BT4375S074Q00E0M5204000053039865802BR5908John Doe6009Sao Paulo62070503***6304F3A0\"\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/out/pix/brcodes/check")
.header("Trio-Version", "<trio-version>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"entity_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\",\n \"hash\": \"00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01JM0B0TY9BT4375S074Q00E0M5204000053039865802BR5908John Doe6009Sao Paulo62070503***6304F3A0\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.trio.com.br/v2/out/pix/brcodes/check")
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 \"entity_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\",\n \"hash\": \"00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01JM0B0TY9BT4375S074Q00E0M5204000053039865802BR5908John Doe6009Sao Paulo62070503***6304F3A0\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"amount": {
"amount": 100,
"currency": "BRL"
},
"amount_editable": false,
"counterparty": {
"bank_account": {
"branch": "0001",
"digit": "7",
"id": "0008d49c-e6d5-a58e-a742-449e9b38f795",
"ispb": "12345678",
"number": "123456",
"type": "checking"
},
"id": "0008d49c-e6d5-4d86-232a-a6f4b9138f10",
"name": "ACME LTDA",
"tax_number": "11222333000181"
},
"due_date": null,
"expires_at": "2026-02-13T20:25:16.000000Z",
"hash": "00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01JM0B0TY9BT4375S074Q00E0M5204000053039865802BR5908ACME LTDA6009Sao Paulo62070503***6304F3A0",
"id": "019500b0-71d2-ac32-3712-e8ba5e06e0f7",
"inserted_at": "2026-02-13T19:01:58.354481Z",
"key": "11222333000181",
"key_type": "tax_number",
"updated_at": "2026-02-13T19:01:58.354481Z"
}
}{
"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"
}
]
}
}QR Code
Check Pix BR Code
Checks a brcode hash
POST
/
v2
/
out
/
pix
/
brcodes
/
check
Check a brcode hash
curl --request POST \
--url https://api.sandbox.trio.com.br/v2/out/pix/brcodes/check \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'Trio-Version: <trio-version>' \
--data '
{
"entity_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"hash": "00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01JM0B0TY9BT4375S074Q00E0M5204000053039865802BR5908John Doe6009Sao Paulo62070503***6304F3A0"
}
'import requests
url = "https://api.sandbox.trio.com.br/v2/out/pix/brcodes/check"
payload = {
"entity_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2",
"hash": "00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01JM0B0TY9BT4375S074Q00E0M5204000053039865802BR5908John Doe6009Sao Paulo62070503***6304F3A0"
}
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({
entity_id: '41234d60-f6a9-4c9c-8cc3-5769ce9bbea2',
hash: '00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01JM0B0TY9BT4375S074Q00E0M5204000053039865802BR5908John Doe6009Sao Paulo62070503***6304F3A0'
})
};
fetch('https://api.sandbox.trio.com.br/v2/out/pix/brcodes/check', 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/out/pix/brcodes/check",
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([
'entity_id' => '41234d60-f6a9-4c9c-8cc3-5769ce9bbea2',
'hash' => '00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01JM0B0TY9BT4375S074Q00E0M5204000053039865802BR5908John Doe6009Sao Paulo62070503***6304F3A0'
]),
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/out/pix/brcodes/check"
payload := strings.NewReader("{\n \"entity_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\",\n \"hash\": \"00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01JM0B0TY9BT4375S074Q00E0M5204000053039865802BR5908John Doe6009Sao Paulo62070503***6304F3A0\"\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/out/pix/brcodes/check")
.header("Trio-Version", "<trio-version>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"entity_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\",\n \"hash\": \"00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01JM0B0TY9BT4375S074Q00E0M5204000053039865802BR5908John Doe6009Sao Paulo62070503***6304F3A0\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.trio.com.br/v2/out/pix/brcodes/check")
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 \"entity_id\": \"41234d60-f6a9-4c9c-8cc3-5769ce9bbea2\",\n \"hash\": \"00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01JM0B0TY9BT4375S074Q00E0M5204000053039865802BR5908John Doe6009Sao Paulo62070503***6304F3A0\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"amount": {
"amount": 100,
"currency": "BRL"
},
"amount_editable": false,
"counterparty": {
"bank_account": {
"branch": "0001",
"digit": "7",
"id": "0008d49c-e6d5-a58e-a742-449e9b38f795",
"ispb": "12345678",
"number": "123456",
"type": "checking"
},
"id": "0008d49c-e6d5-4d86-232a-a6f4b9138f10",
"name": "ACME LTDA",
"tax_number": "11222333000181"
},
"due_date": null,
"expires_at": "2026-02-13T20:25:16.000000Z",
"hash": "00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01JM0B0TY9BT4375S074Q00E0M5204000053039865802BR5908ACME LTDA6009Sao Paulo62070503***6304F3A0",
"id": "019500b0-71d2-ac32-3712-e8ba5e06e0f7",
"inserted_at": "2026-02-13T19:01:58.354481Z",
"key": "11222333000181",
"key_type": "tax_number",
"updated_at": "2026-02-13T19:01:58.354481Z"
}
}{
"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
Headers
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
Check brcode payload

