Generate Card Top Up QR Code

Generate QR Code for Card Top Up card balance

curl --request POST \
  --url https://api.sandbox.trio.com.br/v2/cards/{id}/topup/qrcode \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'Trio-Version: <trio-version>' \
  --data '
{
  "amount": {
    "amount": 1000,
    "currency": "BRL"
  },
  "counterparty": {
    "name": "John Doe",
    "tax_number": "12345678909"
  },
  "entity_id": "019514eb-5d5c-4a1e-9f0b-1c2d3e4f5a6b"
}
'

import requests

url = "https://api.sandbox.trio.com.br/v2/cards/{id}/topup/qrcode"

payload = {
    "amount": {
        "amount": 1000,
        "currency": "BRL"
    },
    "counterparty": {
        "name": "John Doe",
        "tax_number": "12345678909"
    },
    "entity_id": "019514eb-5d5c-4a1e-9f0b-1c2d3e4f5a6b"
}
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: {amount: 1000, currency: 'BRL'},
    counterparty: {name: 'John Doe', tax_number: '12345678909'},
    entity_id: '019514eb-5d5c-4a1e-9f0b-1c2d3e4f5a6b'
  })
};

fetch('https://api.sandbox.trio.com.br/v2/cards/{id}/topup/qrcode', 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/cards/{id}/topup/qrcode",
  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' => [
        'amount' => 1000,
        'currency' => 'BRL'
    ],
    'counterparty' => [
        'name' => 'John Doe',
        'tax_number' => '12345678909'
    ],
    'entity_id' => '019514eb-5d5c-4a1e-9f0b-1c2d3e4f5a6b'
  ]),
  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/cards/{id}/topup/qrcode"

	payload := strings.NewReader("{\n  \"amount\": {\n    \"amount\": 1000,\n    \"currency\": \"BRL\"\n  },\n  \"counterparty\": {\n    \"name\": \"John Doe\",\n    \"tax_number\": \"12345678909\"\n  },\n  \"entity_id\": \"019514eb-5d5c-4a1e-9f0b-1c2d3e4f5a6b\"\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/cards/{id}/topup/qrcode")
  .header("Trio-Version", "<trio-version>")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": {\n    \"amount\": 1000,\n    \"currency\": \"BRL\"\n  },\n  \"counterparty\": {\n    \"name\": \"John Doe\",\n    \"tax_number\": \"12345678909\"\n  },\n  \"entity_id\": \"019514eb-5d5c-4a1e-9f0b-1c2d3e4f5a6b\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sandbox.trio.com.br/v2/cards/{id}/topup/qrcode")

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\": {\n    \"amount\": 1000,\n    \"currency\": \"BRL\"\n  },\n  \"counterparty\": {\n    \"name\": \"John Doe\",\n    \"tax_number\": \"12345678909\"\n  },\n  \"entity_id\": \"019514eb-5d5c-4a1e-9f0b-1c2d3e4f5a6b\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "amount": {
      "amount": 10000,
      "currency": "BRL"
    },
    "description": "0197a339-481c-5bc5-7809-3bc11807df2f",
    "expiration_datetime": "2025-06-24T23:35:30.091799Z",
    "hash": "00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01K1BWRSMG89A3TE0SNZFNPMH05204000053039865802BR5910brcodename6010brcodecity62070503***6304E6A4",
    "id": "0197a339-49ab-27db-a98d-29c56a0c1b1c"
  }
}

{
  "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"
      }
    ]
  }
}

{
  "error": {
    "error_code": "INVALID_PARAMETER",
    "error_message": "Invalid parameters: /amount: Invalid integer. Got: string",
    "errors": [
      {
        "field": "/amount",
        "message": "Invalid integer. Got: string"
      }
    ]
  }
}

POST

cards

{id}

topup

qrcode

Generate QR Code for Card Top Up card balance

curl --request POST \
  --url https://api.sandbox.trio.com.br/v2/cards/{id}/topup/qrcode \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'Trio-Version: <trio-version>' \
  --data '
{
  "amount": {
    "amount": 1000,
    "currency": "BRL"
  },
  "counterparty": {
    "name": "John Doe",
    "tax_number": "12345678909"
  },
  "entity_id": "019514eb-5d5c-4a1e-9f0b-1c2d3e4f5a6b"
}
'

import requests

url = "https://api.sandbox.trio.com.br/v2/cards/{id}/topup/qrcode"

payload = {
    "amount": {
        "amount": 1000,
        "currency": "BRL"
    },
    "counterparty": {
        "name": "John Doe",
        "tax_number": "12345678909"
    },
    "entity_id": "019514eb-5d5c-4a1e-9f0b-1c2d3e4f5a6b"
}
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: {amount: 1000, currency: 'BRL'},
    counterparty: {name: 'John Doe', tax_number: '12345678909'},
    entity_id: '019514eb-5d5c-4a1e-9f0b-1c2d3e4f5a6b'
  })
};

fetch('https://api.sandbox.trio.com.br/v2/cards/{id}/topup/qrcode', 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/cards/{id}/topup/qrcode",
  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' => [
        'amount' => 1000,
        'currency' => 'BRL'
    ],
    'counterparty' => [
        'name' => 'John Doe',
        'tax_number' => '12345678909'
    ],
    'entity_id' => '019514eb-5d5c-4a1e-9f0b-1c2d3e4f5a6b'
  ]),
  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/cards/{id}/topup/qrcode"

	payload := strings.NewReader("{\n  \"amount\": {\n    \"amount\": 1000,\n    \"currency\": \"BRL\"\n  },\n  \"counterparty\": {\n    \"name\": \"John Doe\",\n    \"tax_number\": \"12345678909\"\n  },\n  \"entity_id\": \"019514eb-5d5c-4a1e-9f0b-1c2d3e4f5a6b\"\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/cards/{id}/topup/qrcode")
  .header("Trio-Version", "<trio-version>")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": {\n    \"amount\": 1000,\n    \"currency\": \"BRL\"\n  },\n  \"counterparty\": {\n    \"name\": \"John Doe\",\n    \"tax_number\": \"12345678909\"\n  },\n  \"entity_id\": \"019514eb-5d5c-4a1e-9f0b-1c2d3e4f5a6b\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sandbox.trio.com.br/v2/cards/{id}/topup/qrcode")

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\": {\n    \"amount\": 1000,\n    \"currency\": \"BRL\"\n  },\n  \"counterparty\": {\n    \"name\": \"John Doe\",\n    \"tax_number\": \"12345678909\"\n  },\n  \"entity_id\": \"019514eb-5d5c-4a1e-9f0b-1c2d3e4f5a6b\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "amount": {
      "amount": 10000,
      "currency": "BRL"
    },
    "description": "0197a339-481c-5bc5-7809-3bc11807df2f",
    "expiration_datetime": "2025-06-24T23:35:30.091799Z",
    "hash": "00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01K1BWRSMG89A3TE0SNZFNPMH05204000053039865802BR5910brcodename6010brcodecity62070503***6304E6A4",
    "id": "0197a339-49ab-27db-a98d-29c56a0c1b1c"
  }
}

{
  "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"
      }
    ]
  }
}

{
  "error": {
    "error_code": "INVALID_PARAMETER",
    "error_message": "Invalid parameters: /amount: Invalid integer. Got: string",
    "errors": [
      {
        "field": "/amount",
        "message": "Invalid integer. Got: string"
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

Trio-Version

enum<string>

required

Version of the v2 contract the client is written against. Each breaking change publishes a new version.

Available options:

2026-10-19.v2

Trio-Target-Org-Id

string<uuid>

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.

Path Parameters

string<uuid>

required

Card ID Unique identifier

Body

application/json

Top Up Card Balance QR Code

Generates a Pix QR code that tops up the card in the path once it is paid

amount

V2 card amount params · object

required

Amount of money to move, in cents

Show child attributes

Example:

{ "amount": 1000, "currency": "BRL" }

counterparty

object

required

Who pays the QR code

Show child attributes

entity_id

string<uuid>

required

ID of the entity that holds the card

Response

Topup QR Code

The QR code created

data

V2 card top up QR code · object

required

Pix QR code that tops up a card

Show child attributes

Example:

{
  "amount": { "amount": 10000, "currency": "BRL" },
  "description": "0197a339-481c-5bc5-7809-3bc11807df2f",
  "expiration_datetime": "2025-06-24T23:35:30.091799Z",
  "hash": "00020101021226630014br.gov.bcb.pix2541pix.example.com/cob/01K1BWRSMG89A3TE0SNZFNPMH05204000053039865802BR5910brcodename6010brcodecity62070503***6304E6A4",
  "id": "0197a339-49ab-27db-a98d-29c56a0c1b1c"
}