Cards
Generate Card Invoice Statement CSV URL for an invoice
Invoice ID
Entity ID
Card ID
GET /banking/cards/invoices/{id}/export HTTP/1.1
Host: api.sandbox.trio.com.br
Accept: */*
{
"data": {
"from_datetime": "2024-11-04T14:24:28.430838Z",
"to_datetime": "2024-11-04T14:24:28.430838Z",
"url": "https://app.trio.com.br/invoice_statements/closed/company/org/entidade_0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b.csv"
}
}
List Card Invoices
Entity ID
Parameter used for pagination. It is a base64 encoded param used to access the previous page of results. It is provided alongside a metadata section if there is a previous page.
g3QAAAABZAACaWRtAAAAJDU4ZjFlYzhlLWFmYTktNDk0My05M2I1LWQ2ZGM3OWI0M2VhYQ==
Parameter used for pagination. It's a base64 encoded param used to access the previous page of results. Provided along with the data in the metadata section if there is a previous page.
g3QAAAABZAACaWRtAAAAJGJhYTNiNmM1LTAyYTYtNGQ5Ny05NzU1LTI3OGFiNjRiN2Y1MQ==
Parameter used for pagination.
GET /banking/cards/invoices HTTP/1.1
Host: api.sandbox.trio.com.br
Accept: */*
{
"data": [
{
"balance": 10000,
"company_id": "0182b3d1-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"entity_id": "0182b3d3-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"from_datetime": "2025-06-11T03:00:00.000000Z",
"id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"org_id": "0182b3d2-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"pending_confirmation_amount": 10000,
"purchase_balance": 10000,
"status": "open",
"to_datetime": "2025-06-12T03:00:00.000000Z"
}
]
}
Cancel an existing card
Unique identifier
No Content
POST /banking/cards/{id}/cancel HTTP/1.1
Host: api.sandbox.trio.com.br
Accept: */*
No Content
Card sensitive information: holder name, card number, expiration date and cvv
Unique identifier
GET /banking/cards/{id}/info HTTP/1.1
Host: api.sandbox.trio.com.br
Accept: */*
{
"data": {
"expiration_date": "2022-12-31T23:59:59Z",
"holder_name": "John Doe",
"number": "5209199870273875",
"security_code": "123"
}
}
Transfer card balance to another card
From card ID
Card transfer balance params
Amount to transfer (R$)
Destination card UUID
Entity UUID
No Content
POST /banking/cards/{id}/transfer_balance HTTP/1.1
Host: api.sandbox.trio.com.br
Content-Type: application/json
Accept: */*
Content-Length: 127
{
"amount": 1000,
"destination_card_id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"entity_id": "019514eb-5d5c-b395-5a77-449d12701ce7"
}
No Content
List lines for a specific Card Invoice
Invoice ID
Entity ID
Parameter used for pagination. It is a base64 encoded param used to access the previous page of results. It is provided alongside a metadata section if there is a previous page.
g3QAAAABZAACaWRtAAAAJDU4ZjFlYzhlLWFmYTktNDk0My05M2I1LWQ2ZGM3OWI0M2VhYQ==
Parameter used for pagination. It's a base64 encoded param used to access the previous page of results. Provided along with the data in the metadata section if there is a previous page.
g3QAAAABZAACaWRtAAAAJGJhYTNiNmM1LTAyYTYtNGQ5Ny05NzU1LTI3OGFiNjRiN2Y1MQ==
Parameter used for pagination.
GET /banking/cards/invoices/{id}/lines HTTP/1.1
Host: api.sandbox.trio.com.br
Accept: */*
{
"data": [
{
"amount": {
"amount": 10000,
"currency": "BRL"
},
"card_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"card_number": "5555 **** **** 1234",
"id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"invoice_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"line_category": "food",
"line_status": "confirmed",
"line_title": "Fast Food",
"ref_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"ref_type": "purchase",
"timestamp": "2020-01-01T00:00:00Z"
}
]
}
Block an existing card
Unique identifier
No Content
POST /banking/cards/{id}/block HTTP/1.1
Host: api.sandbox.trio.com.br
Accept: */*
No Content
Get an existing card
Unique identifier
GET /banking/cards/{id} HTTP/1.1
Host: api.sandbox.trio.com.br
Accept: */*
{
"data": {
"balance": 0,
"company_id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"display_name": "marketing card",
"entity_id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"holder_id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"masked_number": "5555 **** **** 1234",
"org_id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"status": "active",
"type": "virtual"
}
}
Update card display name
Unique identifier
Card update params
Display name
No Content
PUT /banking/cards/{id} HTTP/1.1
Host: api.sandbox.trio.com.br
Content-Type: application/json
Accept: */*
Content-Length: 37
{
"display_name": "New marketing card"
}
No Content
Get Card current Invoice
Entity ID
GET /banking/cards/invoices/current HTTP/1.1
Host: api.sandbox.trio.com.br
Accept: */*
{
"data": {
"balance": 10000,
"company_id": "0182b3d1-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"entity_id": "0182b3d3-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"from_datetime": "2025-06-11T03:00:00.000000Z",
"id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"org_id": "0182b3d2-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"pending_confirmation_amount": 10000,
"purchase_balance": 10000,
"status": "open",
"to_datetime": "2025-06-12T03:00:00.000000Z"
}
}
List Card purchase documents
Unique identifier
From datetime
To datetime
Unique identifier
Category Code
Category Type
Parameter used for pagination. It is a base64 encoded param used to access the previous page of results. It is provided alongside a metadata section if there is a previous page.
g3QAAAABZAACaWRtAAAAJDU4ZjFlYzhlLWFmYTktNDk0My05M2I1LWQ2ZGM3OWI0M2VhYQ==
Parameter used for pagination. It's a base64 encoded param used to access the previous page of results. Provided along with the data in the metadata section if there is a previous page.
g3QAAAABZAACaWRtAAAAJGJhYTNiNmM1LTAyYTYtNGQ5Ny05NzU1LTI3OGFiNjRiN2Y1MQ==
Parameter used for pagination.
Status
Order by
GET /banking/cards/purchases HTTP/1.1
Host: api.sandbox.trio.com.br
Accept: */*
{
"data": [
{
"receipt_url": "https://app.trio.com.br/receipt/0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"is_partially_allowed": false,
"holder_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"inserted_at": "2021-01-01T00:00:00Z",
"wallet_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"entity_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"issuer_amount": {
"amount": 10000,
"currency": "BRL"
},
"category_type": "restaurants",
"tax": {
"amount": 10,
"currency": "BRL"
},
"merchant_country_code": "BR",
"card_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"category_code": "foodAndBeverages",
"method_code": "manual",
"company_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"status": "confirmed",
"updated_at": "2021-01-01T00:00:00Z",
"description": "description",
"id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"purpose": "purchase",
"merchant_amount": {
"amount": 10000,
"currency": "BRL"
},
"merchant_currency_symbol": "R$",
"zip_code": "000000-000",
"merchant_name": "John Doe Store",
"category_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"error_code": "null",
"error_message": "null",
"end_to_end_id": "EE202506111406IVIN5pXVoyp",
"timestamp": "2021-01-01T00:00:00Z",
"org_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"compress_timestamp": "2021-01-01T00:00:00Z",
"amount": {
"amount": 10000,
"currency": "BRL"
},
"score": "1.0",
"merchant_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b"
}
]
}
Top Up card balance
Card ID
Card top up balance params
Amount to top up (R$)
Entity UUID
Source bank account UUID
No Content
POST /banking/cards/{id}/topup HTTP/1.1
Host: api.sandbox.trio.com.br
Content-Type: application/json
Accept: */*
Content-Length: 130
{
"amount": 1000,
"entity_id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"origin_bank_account_id": "019514eb-5d5c-b395-5a77-449d12701ce7"
}
No Content
List cards
Unique identifier
Card Last Four Digits
Card Display Name
Card Holder Name
Card Holder Tax Number
Parameter used for pagination. It is a base64 encoded param used to access the previous page of results. It is provided alongside a metadata section if there is a previous page.
g3QAAAABZAACaWRtAAAAJDU4ZjFlYzhlLWFmYTktNDk0My05M2I1LWQ2ZGM3OWI0M2VhYQ==
Parameter used for pagination. It's a base64 encoded param used to access the previous page of results. Provided along with the data in the metadata section if there is a previous page.
g3QAAAABZAACaWRtAAAAJGJhYTNiNmM1LTAyYTYtNGQ5Ny05NzU1LTI3OGFiNjRiN2Y1MQ==
Parameter used for pagination.
GET /banking/cards HTTP/1.1
Host: api.sandbox.trio.com.br
Accept: */*
{
"data": [
{
"balance": 0,
"company_id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"display_name": "marketing card",
"entity_id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"holder_id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"masked_number": "5555 **** **** 1234",
"org_id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"status": "active",
"type": "virtual"
}
]
}
Create a new card
Card create params
Display name
Entity UUID
Holder Name
POST /banking/cards HTTP/1.1
Host: api.sandbox.trio.com.br
Content-Type: application/json
Accept: */*
Content-Length: 109
{
"display_name": "marketing card",
"entity_id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"holder_name": "John Doe"
}
{
"data": {
"balance": 0,
"company_id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"display_name": "marketing card",
"entity_id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"holder_id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"masked_number": "5555 **** **** 1234",
"org_id": "019514eb-5d5c-b395-5a77-449d12701ce7",
"status": "active",
"type": "virtual"
}
}
Show card purchase document by end to end id
Unique identifier for transactions
EE202506111406IVIN5pXVoyp
Timestamp
GET /banking/cards/purchases/e2e/{id} HTTP/1.1
Host: api.sandbox.trio.com.br
Accept: */*
{
"data": {
"receipt_url": "https://app.trio.com.br/receipt/0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"is_partially_allowed": false,
"holder_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"stages": [
{
"is_partially_allowed": false,
"holder_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"inserted_at": "2021-01-01T00:00:00Z",
"wallet_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"entity_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"issuer_amount": {
"amount": 10000,
"currency": "BRL"
},
"category_type": "restaurants",
"tax": {
"amount": 10,
"currency": "BRL"
},
"merchant_country_code": "BR",
"card_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"category_code": "foodAndBeverages",
"method_code": "manual",
"company_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"status": "confirmed",
"updated_at": "2021-01-01T00:00:00Z",
"description": "description",
"id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"purpose": "purchase",
"merchant_amount": {
"amount": 10000,
"currency": "BRL"
},
"purchase_document_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"merchant_currency_symbol": "R$",
"zip_code": "000000-000",
"merchant_name": "John Doe Store",
"category_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"callback_amount": {
"amount": 10000,
"currency": "BRL"
},
"error_code": "null",
"error_message": "null",
"end_to_end_id": "EE202506111406IVIN5pXVoyp",
"timestamp": "2021-01-01T00:00:00Z",
"callback_type": "approved",
"org_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"amount": {
"amount": 10000,
"currency": "BRL"
},
"score": "1.0",
"merchant_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b"
}
],
"inserted_at": "2021-01-01T00:00:00Z",
"wallet_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"entity_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"issuer_amount": {
"amount": 10000,
"currency": "BRL"
},
"category_type": "restaurants",
"tax": {
"amount": 10,
"currency": "BRL"
},
"merchant_country_code": "BR",
"card_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"category_code": "foodAndBeverages",
"method_code": "manual",
"company_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"status": "confirmed",
"updated_at": "2021-01-01T00:00:00Z",
"description": "description",
"id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"purpose": "purchase",
"merchant_amount": {
"amount": 10000,
"currency": "BRL"
},
"merchant_currency_symbol": "R$",
"zip_code": "000000-000",
"merchant_name": "John Doe Store",
"category_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"error_code": "null",
"error_message": "null",
"end_to_end_id": "EE202506111406IVIN5pXVoyp",
"timestamp": "2021-01-01T00:00:00Z",
"org_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"compress_timestamp": "2021-01-01T00:00:00Z",
"amount": {
"amount": 10000,
"currency": "BRL"
},
"score": "1.0",
"merchant_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b"
}
}
Show Card purchase document by id
Unique identifier
GET /banking/cards/purchases/{id} HTTP/1.1
Host: api.sandbox.trio.com.br
Accept: */*
{
"data": {
"receipt_url": "https://app.trio.com.br/receipt/0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"is_partially_allowed": false,
"holder_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"stages": [
{
"is_partially_allowed": false,
"holder_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"inserted_at": "2021-01-01T00:00:00Z",
"wallet_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"entity_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"issuer_amount": {
"amount": 10000,
"currency": "BRL"
},
"category_type": "restaurants",
"tax": {
"amount": 10,
"currency": "BRL"
},
"merchant_country_code": "BR",
"card_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"category_code": "foodAndBeverages",
"method_code": "manual",
"company_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"status": "confirmed",
"updated_at": "2021-01-01T00:00:00Z",
"description": "description",
"id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"purpose": "purchase",
"merchant_amount": {
"amount": 10000,
"currency": "BRL"
},
"purchase_document_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"merchant_currency_symbol": "R$",
"zip_code": "000000-000",
"merchant_name": "John Doe Store",
"category_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"callback_amount": {
"amount": 10000,
"currency": "BRL"
},
"error_code": "null",
"error_message": "null",
"end_to_end_id": "EE202506111406IVIN5pXVoyp",
"timestamp": "2021-01-01T00:00:00Z",
"callback_type": "approved",
"org_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"amount": {
"amount": 10000,
"currency": "BRL"
},
"score": "1.0",
"merchant_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b"
}
],
"inserted_at": "2021-01-01T00:00:00Z",
"wallet_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"entity_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"issuer_amount": {
"amount": 10000,
"currency": "BRL"
},
"category_type": "restaurants",
"tax": {
"amount": 10,
"currency": "BRL"
},
"merchant_country_code": "BR",
"card_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"category_code": "foodAndBeverages",
"method_code": "manual",
"company_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"status": "confirmed",
"updated_at": "2021-01-01T00:00:00Z",
"description": "description",
"id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"purpose": "purchase",
"merchant_amount": {
"amount": 10000,
"currency": "BRL"
},
"merchant_currency_symbol": "R$",
"zip_code": "000000-000",
"merchant_name": "John Doe Store",
"category_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"error_code": "null",
"error_message": "null",
"end_to_end_id": "EE202506111406IVIN5pXVoyp",
"timestamp": "2021-01-01T00:00:00Z",
"org_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b",
"compress_timestamp": "2021-01-01T00:00:00Z",
"amount": {
"amount": 10000,
"currency": "BRL"
},
"score": "1.0",
"merchant_id": "0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b"
}
}
Unblock an existing card
Unique identifier
No Content
POST /banking/cards/{id}/unblock HTTP/1.1
Host: api.sandbox.trio.com.br
Accept: */*
No Content
Was this helpful?