Darf

Check DARF

post

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

/banking/cashout/darf/check

Check a DARF

Required scopes

This endpoint requires the following scopes:

Authorizations

basic

Body

application/json

Check DARF request params

accumulated_revenue_amountintegerRequired

Accumulated revenue amount

amountintegerRequired

Amount

assessment_datestringRequired

Assessment date

authentication_datestringRequired

Authentication date

due_datestringRequired

Due date

federal_revenue_idstringRequired

Federal revenue ID

fine_amountintegerRequired

Fine amount

interest_amountintegerRequired

Interest amount

namestringRequired

Name

percentageintegerRequired

Percentage

phonestringRequired

Phone number

reference_numberinteger · nullableOptional

Reference number

tax_numberstringRequired

Tax number

Responses

201

Created

application/json

Response schema for a single DARF generation

401

Unauthorized

application/json

404

Unprocessable Entity

application/json

500

Internal server error

application/json

post/banking/cashout/darf/check

HTTPcURLJavaScriptPython

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

{
  "accumulated_revenue_amount": 100,
  "amount": 100,
  "assessment_date": "2026-01-01",
  "authentication_date": "2026-01-01",
  "due_date": "2026-01-01",
  "federal_revenue_id": "",
  "fine_amount": 10,
  "interest_amount": 5,
  "name": "John Doe",
  "percentage": 2,
  "phone": "[phone]",
  "reference_number": 123456789,
  "tax_number": "12345678901234"
}

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Pay DARF

post

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

/banking/cashout/darf/pay

Generate a pay DARF

Required scopes

This endpoint requires the following scopes:

Authorizations

basic

Body

application/json

Body params to generate a DARF V1 payment

amountintegerOptional

Amount 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

Response schema for a single boleto V1 generation

401

Unauthorized

application/json

404

Unprocessable Entity

application/json

500

Internal server error

application/json

post/banking/cashout/darf/pay

HTTPcURLJavaScriptPython

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

{
  "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 DARF v2

post

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

/banking/cashout/darf/pay/v2

Generate a pay DARF v2

Required scopes

This endpoint requires the following scopes:

Authorizations

basic

Body

application/json

Body params to generate a DARF V2

accumulated_revenue_amountintegerRequired

Accumulated revenue amount

amountintegerRequired

Amount

assessment_datestringRequired

Assessment date

authentication_datestringRequired

Authentication date

descriptionstring · nullableOptional

Description of the DARF

due_datestringRequired

Due date

external_idstring · nullableOptional

External ID of the DARF for reference

federal_revenue_idstringRequired

Federal revenue ID

fine_amountintegerRequired

Fine amount

interest_amountintegerRequired

Interest amount

namestringRequired

Name

percentageintegerRequired

Percentage

phonestringRequired

Phone number

reference_numberinteger · nullableOptional

Reference number

tax_numberstringRequired

Tax number

virtual_account_idstring · uuidRequired

Unique identifier

Responses

201

Created

application/json

Response schema for a single DARF V2 generation

401

Unauthorized

application/json

404

Unprocessable Entity

application/json

500

Internal server error

application/json

post/banking/cashout/darf/pay/v2

HTTPcURLJavaScriptPython

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

{
  "accumulated_revenue_amount": 100,
  "amount": 100,
  "assessment_date": "2026-01-01",
  "authentication_date": "2026-01-01",
  "description": "Consectetur esse sed irure incididunt est culpa nostrud.",
  "due_date": "2026-01-01",
  "external_id": "5b760495-cb55-4043-95e8-0cff5776b014",
  "federal_revenue_id": "12345678901234",
  "fine_amount": 10,
  "interest_amount": 5,
  "name": "John Doe",
  "percentage": 2,
  "phone": "[phone]",
  "reference_number": 123456789,
  "tax_number": "12345678901234",
  "virtual_account_id": "1a760495-cb95-4023-96e8-0cff5776b010"
}

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