Utility

Check utility

post

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

/banking/cashout/utility/check

Check a utility barcode or line code

Required scopes

This endpoint requires the following scopes:

Authorizations

basic

Body

application/json

Check utility request params

codestringRequired

Utility barcode or digitable_line

Responses

201

Created

application/json

401

Unauthorized

application/json

404

Unprocessable Entity

application/json

500

Internal server error

application/json

post

/banking/cashout/utility/check

HTTPcURLJavaScriptPython

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

{
  "code": "81620000001482115872026022712600000000001207"
}

{
  "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": "utility",
    "updated_at": "2026-02-20T17:38:42.001475Z"
  }
}

Pay utility

post

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

/banking/cashout/utility/pay

Generate a pay utility

Required scopes

This endpoint requires the following scopes:

Authorizations

basic

Body

application/json

Body params to generate a utility V1 payment

amountintegerRequired

Amount of the utility in cents

check_idstring · uuidRequired

Unique identifier

descriptionstringOptional

Description for the utility

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/utility/pay

HTTPcURLJavaScriptPython

POST /banking/cashout/utility/pay 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 utility v2

post

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

/banking/cashout/utility/pay/v2

Generate a pay utility v2

Required scopes

This endpoint requires the following scopes:

Authorizations

basic

Body

application/json

Body params to generate a utility V2

amountintegerRequired

Amount of the utility in cents

codestringRequired

Barcode or digitable_line of the utility

descriptionstringOptional

Description of the utility

external_idstringOptional

External ID of the utility 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/utility/pay/v2

HTTPcURLJavaScriptPython

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

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

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