Boletos

Check boleto

post

https://api.sandbox.trio.com.brhttps://api.qa.trio.com.brhttps://api.trio.com.br

/banking/cashout/boletos/check

Check a boleto barcode or line code

Required scopes

This endpoint requires the following scopes:

Authorizations

basic

Body

application/json

Check boleto request params

codestringRequired

Boleto barcode or digitable_line

typestring · enumOptional

Barcode type

Possible values:

Responses

201

Created

application/json

401

Unauthorized

application/json

404

Unprocessable Entity

application/json

500

Internal server error

application/json

post

/banking/cashout/boletos/check

HTTPcURLJavaScriptPython

POST /banking/cashout/boletos/check HTTP/1.1
Host: api.sandbox.trio.com.br
Content-Type: application/json
Accept: */*
Content-Length: 71

{
  "code": "81620000001482115872026022712600000000001207",
  "type": "boleto"
}

{
  "data": {
    "amount": {
      "amount": 100,
      "currency": "BRL"
    },
    "barcode": "63391136900000001000001112265643600168303958",
    "company_id": "1a760495-cb95-4023-96e8-0cff5776b011",
    "digitable_line": "63390001161226564360601683039588113690000000100",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "inserted_at": "2026-02-20T17:38:42.001475Z",
    "name": "Trio Pagamentos S.A.",
    "org_id": "1a760495-cb95-4023-96e8-0cff5776b011",
    "payer_name": "09122219965",
    "payer_tax_number": "Luiz Felipe de Carvalho",
    "tax_number": "13712912235011",
    "timestamp": "2026-02-20T17:38:42.001475Z",
    "type": "boleto",
    "updated_at": "2026-02-20T17:38:42.001475Z"
  }
}

Pay boleto

post

https://api.sandbox.trio.com.brhttps://api.qa.trio.com.brhttps://api.trio.com.br

/banking/cashout/boletos

Generate a pay boleto

Required scopes

This endpoint requires the following scopes:

Authorizations

basic

Body

application/json

Body params to generate a boleto V1 payment

amountintegerRequired

Amount of the boleto in cents

check_idstring · uuidRequired

Unique identifier

descriptionstringOptional

Description for the boleto

external_idstringOptional

External ID for reference

virtual_account_idstring · uuidRequired

Unique identifier

Responses

201

Created

application/json

401

Unauthorized

application/json

404

Unprocessable Entity

application/json

500

Internal server error

application/json

post

/banking/cashout/boletos

HTTPcURLJavaScriptPython

POST /banking/cashout/boletos HTTP/1.1
Host: api.sandbox.trio.com.br
Content-Type: application/json
Accept: */*
Content-Length: 251

{
  "amount": 100,
  "check_id": "4b760495-cb55-4043-95e8-0cff5776b013",
  "description": "Magna dolor velit duis velit ad elit anim laborum aliqua.",
  "external_id": "10760495-cb95-4023-96e9-0cff5776b011",
  "virtual_account_id": "1a760495-cb95-4023-96e8-0cff5776b010"
}

{
  "data": {
    "payment_document_id": "1a760495-cb95-4023-96e8-0cff5776b010"
  }
}

Pay boleto v2

post

https://api.sandbox.trio.com.brhttps://api.qa.trio.com.brhttps://api.trio.com.br

/banking/cashout/boletos/v2

Generate a pay boleto v2

Required scopes

This endpoint requires the following scopes:

Authorizations

basic

Body

application/json

Body params to generate a boleto V2

amountintegerRequired

Amount of the boleto in cents

codestringRequired

Barcode or digitable_line of the boleto

descriptionstringOptional

Description of the boleto

external_idstringOptional

External ID of the boleto for reference

typestring · enumOptional

Barcode type

Possible values:

virtual_account_idstring · uuidRequired

Unique identifier

Responses

201

Created

application/json

401

Unauthorized

application/json

404

Unprocessable Entity

application/json

500

Internal server error

application/json

post

/banking/cashout/boletos/v2

HTTPcURLJavaScriptPython

POST /banking/cashout/boletos/v2 HTTP/1.1
Host: api.sandbox.trio.com.br
Content-Type: application/json
Accept: */*
Content-Length: 262

{
  "amount": 100,
  "code": "4b760495-cb55-4043-95e8-0cff5776b013",
  "description": "Consectetur esse sed irure incididunt est culpa nostrud.",
  "external_id": "5b760495-cb55-4043-95e8-0cff5776b014",
  "type": "boleto",
  "virtual_account_id": "1a760495-cb95-4023-96e8-0cff5776b010"
}

{
  "data": {
    "payment_document_id": "1a760495-cb95-4023-96e8-0cff5776b010"
  }
}