Dynamic QR Codes

Create a new dynamic pix QRCode

post

/banking/cashin/pix/qrcodes

Creates a new dynamic pix QRCode

Body

Body params to create a dynamic QRCode

amountintegerRequired

Amount value of the dynamic QRCode

descriptionstringOptional

Description of the dynamic QRCode

expiration_datetimestring · date-timeOptional

Expiration datetime

external_idstringOptional

External ID of the dynamic QRCode

virtual_account_idstringRequired

Virtual Account ID

Responses

201

Pix QRCode

application/json

401

Unauthorized

application/json

500

Internal server error

application/json

post

/banking/cashin/pix/qrcodes

POST /banking/cashin/pix/qrcodes HTTP/1.1
Host: api.sandbox.trio.com.br
Content-Type: application/json
Accept: */*
Content-Length: 432

{
  "amount": 10,
  "counterparty": {
    "bank_accounts": [
      {
        "branch": "1",
        "digit": "1",
        "ispb": "00000001",
        "number": "80808080",
        "type": "checking"
      }
    ],
    "name": "counterparty_name",
    "tax_number": "45261517001"
  },
  "description": "description",
  "expiration_datetime": "2025-09-23T16:55:30.710801Z",
  "external_id": "external_id",
  "options": {
    "allow_change_the_amount_on_payment": true,
    "show_qrcode_image": true
  },
  "virtual_account_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2"
}

{
  "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": "2025-09-23T16:55:30.645169Z",
    "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": "2025-09-23T16:55:30.645170Z"
      }
    ],
    "status": "created",
    "timestamp": "2025-09-23T16:55:30.643621Z",
    "virtual_account_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2"
  }
}

Get a specific dynamic QRCode

get

/banking/cashin/pix/qrcodes/{id}

Gets a specific dynamic QRCode

Path parameters

idstring · uuidRequired

Unique identifier

Responses

200

Dynamic

application/json

401

Unauthorized

application/json

404

Unprocessable Entity

application/json

500

Internal server error

application/json

get

/banking/cashin/pix/qrcodes/{id}

GET /banking/cashin/pix/qrcodes/{id} HTTP/1.1
Host: api.sandbox.trio.com.br
Accept: */*

{
  "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": "2025-09-23T16:55:30.645169Z",
    "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": "2025-09-23T16:55:30.645170Z"
      }
    ],
    "status": "created",
    "timestamp": "2025-09-23T16:55:30.643621Z",
    "virtual_account_id": "41234d60-f6a9-4c9c-8cc3-5769ce9bbea2"
  }
}

Update a dynamic pix QRCode

put

/banking/cashin/pix/qrcodes/{id}

Updates a dynamic pix QRCode

Path parameters

idstring · uuidRequired

Unique identifier

Body

Body params to update a dynamic QRCode

amountinteger | nullableOptional

Amount value of the dynamic QRCode

expiration_datetimestring · date-time | nullableOptional

Expiration datetime in ISO8601

Responses

204

Update

application/json

401

Unauthorized

application/json

500

Internal server error

application/json

put

/banking/cashin/pix/qrcodes/{id}

PUT /banking/cashin/pix/qrcodes/{id} HTTP/1.1
Host: api.sandbox.trio.com.br
Content-Type: application/json
Accept: */*
Content-Length: 66

{
  "amount": 100,
  "expiration_datetime": "2025-09-23T16:55:30.771630Z"
}

No Content

Get a QRCode dynamic hash

get

/banking/cashin/pix/qrcodes/{id}/hash

Gets a dynamic hash

Path parameters

idstring · uuidRequired

Unique identifier

Responses

200

Hash

application/json

401

Unauthorized

application/json

404

Unprocessable Entity

application/json

500

Internal server error

application/json

get

/banking/cashin/pix/qrcodes/{id}/hash

GET /banking/cashin/pix/qrcodes/{id}/hash HTTP/1.1
Host: api.sandbox.trio.com.br
Accept: */*

{
  "data": {
    "hash": "0000BResdasadjvajsidunajkTTrioTecnologia"
  }
}

Get dynamic pix QRCode image

get

/banking/cashin/pix/qrcodes/{id}/image

Gets a dynamic pix QRCode image

Path parameters

idstringRequired

Dynamic Pix QRCode ID

Responses

200

Image

application/json

401

Unauthorized

application/json

404

Unprocessable Entity

application/json

500

Internal server error

application/json

get

/banking/cashin/pix/qrcodes/{id}/image

GET /banking/cashin/pix/qrcodes/{id}/image HTTP/1.1
Host: api.sandbox.trio.com.br
Accept: */*

{
  "data": {
    "image": "12389HV8AHRIKVHQ374HFULAGLE8FAH0H4F890QHO2HEFOA7EUG8FU"
  }
}

PreviousRefund NextBoletos

Was this helpful?