Get a transaction
curl --request GET \
--url https://api.banking.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}import requests
url = "https://api.banking.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.banking.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.banking.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.banking.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.banking.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.banking.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"_id": "6710c9a2b4d3e80012c9a1e4",
"environment": "LIVE",
"realmId": "f495ff0c-ab54-4f99-8e92-ca8682e4de9b",
"organizationId": "c4bd3f21-dfbd-44e8-8055-68ba15bed410",
"accountId": "66f2a1c7b4d3e80012c9a0b4",
"walletId": "66f2a3d1b4d3e80012c9a0d2",
"availableBalanceBefore": 1250000,
"financialImpactType": "CREDIT",
"responseCode": 0,
"msgType": 1600,
"txnType": 36,
"effectiveAt": "2026-10-17T13:42:58.000Z",
"billingAmount": 15000,
"billingAmountAuthorized": 15000,
"createdAt": "2026-10-17T13:43:01.000Z",
"updatedAt": "2026-10-17T13:43:01.000Z",
"cardId": "66f2a4b8b4d3e80012c9a0e1",
"balanceCategory": "FLEX_INTERNATIONAL",
"billingCurrency": "986",
"cardTransaction": {
"localTime": "2026-11-02T15:20:31.000Z",
"txnCurrency": "986",
"txnAmount": 18990,
"txnAmountAuthorized": 18990,
"linkedTransactions": [
{
"transactionId": "66f2a7e9b4d3e80012c9a113",
"linkType": "CLEARING_DEBITED_BY",
"createdAt": "2026-11-03T09:12:40.000Z",
"updatedAt": "2026-11-03T09:12:40.000Z",
"_id": "66f2a7e9b4d3e80012c9a114"
}
],
"_id": "66f2a7e9b4d3e80012c9a115",
"acquiringCountryCode": "076",
"acquiringId": "012345",
"mcc": "5943",
"merchantCity": "SAO PAULO",
"merchantCountry": "BRA",
"merchantId": "000000000473921",
"merchantName": "PAPELARIA CENTRAL",
"expired": false,
"cleared": true,
"overcleared": false,
"reversed": false,
"posEntryMode": "E-Commerce",
"recurring": false,
"mobileWalletProvider": 103
},
"pixTransaction": {
"creditParty": {
"name": "Papelaria Central Ltda",
"document": "12345678000190",
"_id": "6710c9a2b4d3e80012c9a1e5",
"key": "financeiro@papelariacentral.com.br",
"bankIspb": "60701190",
"branch": "0001",
"accountNumber": "123456",
"accountType": "CACC",
"street": null,
"city": null,
"state": null,
"postalCode": null
},
"debitParty": {
"name": "Papelaria Central Ltda",
"document": "12345678000190",
"_id": "6710c9a2b4d3e80012c9a1e5",
"key": "financeiro@papelariacentral.com.br",
"bankIspb": "60701190",
"branch": "0001",
"accountNumber": "123456",
"accountType": "CACC",
"street": null,
"city": null,
"state": null,
"postalCode": null
},
"receipt": {
"endToEndId": "E60701190202611031520s0a1b2c3d4e"
},
"txnCurrency": "986",
"txnOriginalAmount": 15000,
"txnDiscountAmount": 0,
"txnFineAmount": 0,
"txnInterestAmount": 0,
"txnPurchaseAmount": 0,
"txnWithdrawalAmount": 0,
"txnUpdatedAmount": 15000,
"txnUpdatedAmountAuthorized": 15000,
"initiationType": "DICT",
"_id": "6710c9a2b4d3e80012c9a1e7",
"internalPixId": "6710c8f1b4d3e80012c9a1d0",
"internalPixBillingId": "6710c8f1b4d3e80012c9a1d1",
"payer": {
"document": "12345678909",
"name": "Mariana Costa"
},
"withdrawal": {
"agentType": null,
"serviceProvider": null
},
"description": "Pedido 1234",
"dueDate": null,
"expiresAt": null,
"qrCodeType": "COB",
"pixCopyPaste": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-4266554400005204000053039865802BR5913PAPELARIA6009SAO PAULO62070503***63041D3D",
"qrQrCodeActive": true,
"errorDescription": "Saldo insuficiente",
"cleared": true,
"additionalInfo": [
{
"key": "Pedido",
"value": "1234",
"_id": "6710c9a2b4d3e80012c9a1e6"
}
],
"linkedTransactions": [
{
"transactionId": "66f2a7e9b4d3e80012c9a113",
"linkType": "CLEARING_DEBITED_BY",
"createdAt": "2026-11-03T09:12:40.000Z",
"updatedAt": "2026-11-03T09:12:40.000Z",
"_id": "66f2a7e9b4d3e80012c9a114"
}
]
},
"boletoTransaction": {
"internalBoletoId": "6718b0c4b4d3e80012c9a2a7",
"barcode": "34191790010104351004791020150008291070026000",
"txnCurrency": "986",
"txnOriginalAmount": 26000,
"txnDiscountAmount": 0,
"txnFineAmount": 0,
"txnInterestAmount": 0,
"txnUpdatedAmount": 26000,
"txnUpdatedAmountAuthorized": 26000,
"txnMaxAmount": 26000,
"txnMinAmount": 26000,
"issuer": "Banco Itaú",
"type": "GENERIC",
"linkedTransactions": [
{
"transactionId": "66f2a7e9b4d3e80012c9a113",
"linkType": "CLEARING_DEBITED_BY",
"createdAt": "2026-11-03T09:12:40.000Z",
"updatedAt": "2026-11-03T09:12:40.000Z",
"_id": "66f2a7e9b4d3e80012c9a114"
}
],
"_id": "6718b0c4b4d3e80012c9a2a8",
"receipt": {
"authentication": null,
"authenticationApi": "A1B2C3D4E5F60718293A4B5C6D7E8F90",
"receipt": null
},
"confirmedAt": "2026-10-23T14:02:11.000Z",
"dueDate": "2026-10-25T00:00:00.000Z",
"finalPaymentAt": "2026-11-24T00:00:00.000Z",
"settleAt": "2026-10-23T00:00:00.000Z",
"payee": "Papelaria Central Ltda",
"payeeDocument": "12345678000190",
"payer": "Acme Comércio Ltda",
"payerDocument": "98765432000110"
},
"tedTransaction": {
"txnCurrency": "986",
"txnAmount": 120000,
"txnAmountAuthorized": 120000,
"_id": "6722a0b1b4d3e80012c9a3c0",
"internalTedId": "6722a07eb4d3e80012c9a3bf",
"creditParty": {
"_id": "6722a0b1b4d3e80012c9a3c1",
"name": "Papelaria Central Ltda",
"personName": "João Silva",
"document": "12345678000190",
"bankCode": "341",
"branch": "0001",
"accountNumber": "123456",
"accountType": "CACC"
},
"debitParty": {
"_id": "6722a0b1b4d3e80012c9a3c1",
"name": "Papelaria Central Ltda",
"personName": "João Silva",
"document": "12345678000190",
"bankCode": "341",
"branch": "0001",
"accountNumber": "123456",
"accountType": "CACC"
},
"description": "Pagamento fornecedor",
"rolledback": {
"reason": "Conta inexistente",
"reasonCode": "AC03"
},
"linkedTransactions": [
{
"transactionId": "66f2a7e9b4d3e80012c9a113",
"linkType": "CLEARING_DEBITED_BY",
"createdAt": "2026-11-03T09:12:40.000Z",
"updatedAt": "2026-11-03T09:12:40.000Z",
"_id": "66f2a7e9b4d3e80012c9a114"
}
]
},
"p2pTransaction": {
"txnCurrency": "986",
"txnAmount": 50000,
"txnAmountAuthorized": 50000,
"payeeAccountId": "66f2a1c7b4d3e80012c9a0b4",
"payerAccountId": "66f2a1c7b4d3e80012c9a0b4",
"_id": "6720f1a3b4d3e80012c9a3b2",
"payeeWalletId": "66f2a3d1b4d3e80012c9a0d3",
"payerWalletId": "66f2a3d1b4d3e80012c9a0d2",
"linkedTransactions": [
{
"transactionId": "66f2a7e9b4d3e80012c9a113",
"linkType": "CLEARING_DEBITED_BY",
"createdAt": "2026-11-03T09:12:40.000Z",
"updatedAt": "2026-11-03T09:12:40.000Z",
"_id": "66f2a7e9b4d3e80012c9a114"
}
]
},
"feeTransaction": {
"txnCurrency": "986",
"txnAmount": 664,
"txnAmountAuthorized": 664,
"_id": "66f2a7e9b4d3e80012c9a117",
"linkedTransactions": [
{
"transactionId": "66f2a7e9b4d3e80012c9a113",
"linkType": "CLEARING_DEBITED_BY",
"createdAt": "2026-11-03T09:12:40.000Z",
"updatedAt": "2026-11-03T09:12:40.000Z",
"_id": "66f2a7e9b4d3e80012c9a114"
}
],
"description": "Tarifa de compra internacional",
"external": {
"invoiceId": "66f2a8a1b4d3e80012c9a120",
"dealId": "66f2a8a1b4d3e80012c9a121",
"contractId": "66f2a8a1b4d3e80012c9a122"
},
"creditParty": {
"type": "LOCAL",
"_id": "66f2a7e9b4d3e80012c9a118",
"local": {
"realmId": "f495ff0c-ab54-4f99-8e92-ca8682e4de9b",
"organizationId": "c4bd3f21-dfbd-44e8-8055-68ba15bed410",
"accountId": "66f2a1c7b4d3e80012c9a0b4",
"walletId": "66f2a3d1b4d3e80012c9a0d2"
},
"remote": {
"pixKey": "financeiro@acme.com.br",
"pixDict": "EMAIL"
}
},
"debitParty": {
"type": "LOCAL",
"_id": "66f2a7e9b4d3e80012c9a118",
"local": {
"realmId": "f495ff0c-ab54-4f99-8e92-ca8682e4de9b",
"organizationId": "c4bd3f21-dfbd-44e8-8055-68ba15bed410",
"accountId": "66f2a1c7b4d3e80012c9a0b4",
"walletId": "66f2a3d1b4d3e80012c9a0d2"
},
"remote": {
"pixKey": "financeiro@acme.com.br",
"pixDict": "EMAIL"
}
}
},
"enrichment": {
"merchant": null,
"category": "OFFICE_SUPPLIES",
"rulesVersion": 3,
"_id": "66f2a7e9b4d3e80012c9a116"
},
"customFields": {
"cost-center": "CC-1020"
},
"spendReview": {
"status": "PENDING_APPROVAL",
"policyId": "3f2e1d0c-9b8a-4c7d-8e6f-5a4b3c2d1e0f",
"policyRequestId": "4d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a",
"requester": {
"userId": "e3553bc1-5e20-4e17-b22a-a796fda0aa99",
"name": "Mariana Costa",
"email": "mariana.costa@acme.com.br"
},
"requestedAt": "2026-11-02T18:02:11.000Z",
"autoApproved": false,
"approvalExpiresAt": "2026-12-02T18:02:11.000Z",
"decidedAt": "2026-11-03T10:15:00.000Z",
"declineOutcome": "DENIED",
"decisionReason": "Falta o comprovante"
},
"spendReviewSubmissionLeaseUntil": "2026-11-02T18:07:11.000Z",
"receipts": "https://files.example.com/receipt.pdf",
"external": {
"transactionId": "0F1E2D3C4B5A69788796A5B4C3D2E1F0",
"pixId": "b6c2a1f0-3d4e-4f5a-8b9c-0d1e2f3a4b5c",
"paymentId": "c7d3b2a1-4e5f-4a6b-9c0d-1e2f3a4b5c6d",
"boletoId": "d8e4c3b2-5f6a-4b7c-8d1e-2f3a4b5c6d7e",
"tedId": "e9f5d4c3-6a7b-4c8d-9e2f-3a4b5c6d7e8f"
},
"processingType": "INSTANT",
"internalErrorCode": "LIMIT_EXCEEDED",
"__v": 0,
"paymentInfo": {
"status": "PAID",
"external": {
"pixId": "c7810c30-971f-4e84-8feb-b7819087d4de",
"platformUserId": "e3553bc1-5e20-4e17-b22a-a796fda0aa99"
}
}
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "FORBIDDEN_WALLET",
"origin": "BANKING",
"message": "You do not have permission to perform this action on this wallet"
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "ACCOUNT_NOT_FOUND",
"origin": "BANKING",
"message": "Account not found"
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "BAD_REQUEST",
"origin": "BANKING",
"message": "Bad Request: Your request is invalid or incomplete. Please make sure you are requesting with the right fields.",
"fields": [
{
"field": "details",
"message": "Invalid option: expected one of \"true\"|\"false\"",
"code": "DETAILS_ONE_OF"
}
]
}Get a transaction
Returns one of the wallet’s transactions in full: its details sub-document (cardTransaction, pixTransaction, boletoTransaction, tedTransaction, p2pTransaction or feeTransaction), its custom fields and, once it was submitted for an expense review, its spendReview.
GET
/
realms
/
{realmId}
/
organizations
/
{organizationId}
/
accounts
/
{accountId}
/
wallets
/
{walletId}
/
transactions
/
{transactionId}
Get a transaction
curl --request GET \
--url https://api.banking.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}import requests
url = "https://api.banking.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.banking.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.banking.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.banking.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.banking.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.banking.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/accounts/{accountId}/wallets/{walletId}/transactions/{transactionId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"_id": "6710c9a2b4d3e80012c9a1e4",
"environment": "LIVE",
"realmId": "f495ff0c-ab54-4f99-8e92-ca8682e4de9b",
"organizationId": "c4bd3f21-dfbd-44e8-8055-68ba15bed410",
"accountId": "66f2a1c7b4d3e80012c9a0b4",
"walletId": "66f2a3d1b4d3e80012c9a0d2",
"availableBalanceBefore": 1250000,
"financialImpactType": "CREDIT",
"responseCode": 0,
"msgType": 1600,
"txnType": 36,
"effectiveAt": "2026-10-17T13:42:58.000Z",
"billingAmount": 15000,
"billingAmountAuthorized": 15000,
"createdAt": "2026-10-17T13:43:01.000Z",
"updatedAt": "2026-10-17T13:43:01.000Z",
"cardId": "66f2a4b8b4d3e80012c9a0e1",
"balanceCategory": "FLEX_INTERNATIONAL",
"billingCurrency": "986",
"cardTransaction": {
"localTime": "2026-11-02T15:20:31.000Z",
"txnCurrency": "986",
"txnAmount": 18990,
"txnAmountAuthorized": 18990,
"linkedTransactions": [
{
"transactionId": "66f2a7e9b4d3e80012c9a113",
"linkType": "CLEARING_DEBITED_BY",
"createdAt": "2026-11-03T09:12:40.000Z",
"updatedAt": "2026-11-03T09:12:40.000Z",
"_id": "66f2a7e9b4d3e80012c9a114"
}
],
"_id": "66f2a7e9b4d3e80012c9a115",
"acquiringCountryCode": "076",
"acquiringId": "012345",
"mcc": "5943",
"merchantCity": "SAO PAULO",
"merchantCountry": "BRA",
"merchantId": "000000000473921",
"merchantName": "PAPELARIA CENTRAL",
"expired": false,
"cleared": true,
"overcleared": false,
"reversed": false,
"posEntryMode": "E-Commerce",
"recurring": false,
"mobileWalletProvider": 103
},
"pixTransaction": {
"creditParty": {
"name": "Papelaria Central Ltda",
"document": "12345678000190",
"_id": "6710c9a2b4d3e80012c9a1e5",
"key": "financeiro@papelariacentral.com.br",
"bankIspb": "60701190",
"branch": "0001",
"accountNumber": "123456",
"accountType": "CACC",
"street": null,
"city": null,
"state": null,
"postalCode": null
},
"debitParty": {
"name": "Papelaria Central Ltda",
"document": "12345678000190",
"_id": "6710c9a2b4d3e80012c9a1e5",
"key": "financeiro@papelariacentral.com.br",
"bankIspb": "60701190",
"branch": "0001",
"accountNumber": "123456",
"accountType": "CACC",
"street": null,
"city": null,
"state": null,
"postalCode": null
},
"receipt": {
"endToEndId": "E60701190202611031520s0a1b2c3d4e"
},
"txnCurrency": "986",
"txnOriginalAmount": 15000,
"txnDiscountAmount": 0,
"txnFineAmount": 0,
"txnInterestAmount": 0,
"txnPurchaseAmount": 0,
"txnWithdrawalAmount": 0,
"txnUpdatedAmount": 15000,
"txnUpdatedAmountAuthorized": 15000,
"initiationType": "DICT",
"_id": "6710c9a2b4d3e80012c9a1e7",
"internalPixId": "6710c8f1b4d3e80012c9a1d0",
"internalPixBillingId": "6710c8f1b4d3e80012c9a1d1",
"payer": {
"document": "12345678909",
"name": "Mariana Costa"
},
"withdrawal": {
"agentType": null,
"serviceProvider": null
},
"description": "Pedido 1234",
"dueDate": null,
"expiresAt": null,
"qrCodeType": "COB",
"pixCopyPaste": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-4266554400005204000053039865802BR5913PAPELARIA6009SAO PAULO62070503***63041D3D",
"qrQrCodeActive": true,
"errorDescription": "Saldo insuficiente",
"cleared": true,
"additionalInfo": [
{
"key": "Pedido",
"value": "1234",
"_id": "6710c9a2b4d3e80012c9a1e6"
}
],
"linkedTransactions": [
{
"transactionId": "66f2a7e9b4d3e80012c9a113",
"linkType": "CLEARING_DEBITED_BY",
"createdAt": "2026-11-03T09:12:40.000Z",
"updatedAt": "2026-11-03T09:12:40.000Z",
"_id": "66f2a7e9b4d3e80012c9a114"
}
]
},
"boletoTransaction": {
"internalBoletoId": "6718b0c4b4d3e80012c9a2a7",
"barcode": "34191790010104351004791020150008291070026000",
"txnCurrency": "986",
"txnOriginalAmount": 26000,
"txnDiscountAmount": 0,
"txnFineAmount": 0,
"txnInterestAmount": 0,
"txnUpdatedAmount": 26000,
"txnUpdatedAmountAuthorized": 26000,
"txnMaxAmount": 26000,
"txnMinAmount": 26000,
"issuer": "Banco Itaú",
"type": "GENERIC",
"linkedTransactions": [
{
"transactionId": "66f2a7e9b4d3e80012c9a113",
"linkType": "CLEARING_DEBITED_BY",
"createdAt": "2026-11-03T09:12:40.000Z",
"updatedAt": "2026-11-03T09:12:40.000Z",
"_id": "66f2a7e9b4d3e80012c9a114"
}
],
"_id": "6718b0c4b4d3e80012c9a2a8",
"receipt": {
"authentication": null,
"authenticationApi": "A1B2C3D4E5F60718293A4B5C6D7E8F90",
"receipt": null
},
"confirmedAt": "2026-10-23T14:02:11.000Z",
"dueDate": "2026-10-25T00:00:00.000Z",
"finalPaymentAt": "2026-11-24T00:00:00.000Z",
"settleAt": "2026-10-23T00:00:00.000Z",
"payee": "Papelaria Central Ltda",
"payeeDocument": "12345678000190",
"payer": "Acme Comércio Ltda",
"payerDocument": "98765432000110"
},
"tedTransaction": {
"txnCurrency": "986",
"txnAmount": 120000,
"txnAmountAuthorized": 120000,
"_id": "6722a0b1b4d3e80012c9a3c0",
"internalTedId": "6722a07eb4d3e80012c9a3bf",
"creditParty": {
"_id": "6722a0b1b4d3e80012c9a3c1",
"name": "Papelaria Central Ltda",
"personName": "João Silva",
"document": "12345678000190",
"bankCode": "341",
"branch": "0001",
"accountNumber": "123456",
"accountType": "CACC"
},
"debitParty": {
"_id": "6722a0b1b4d3e80012c9a3c1",
"name": "Papelaria Central Ltda",
"personName": "João Silva",
"document": "12345678000190",
"bankCode": "341",
"branch": "0001",
"accountNumber": "123456",
"accountType": "CACC"
},
"description": "Pagamento fornecedor",
"rolledback": {
"reason": "Conta inexistente",
"reasonCode": "AC03"
},
"linkedTransactions": [
{
"transactionId": "66f2a7e9b4d3e80012c9a113",
"linkType": "CLEARING_DEBITED_BY",
"createdAt": "2026-11-03T09:12:40.000Z",
"updatedAt": "2026-11-03T09:12:40.000Z",
"_id": "66f2a7e9b4d3e80012c9a114"
}
]
},
"p2pTransaction": {
"txnCurrency": "986",
"txnAmount": 50000,
"txnAmountAuthorized": 50000,
"payeeAccountId": "66f2a1c7b4d3e80012c9a0b4",
"payerAccountId": "66f2a1c7b4d3e80012c9a0b4",
"_id": "6720f1a3b4d3e80012c9a3b2",
"payeeWalletId": "66f2a3d1b4d3e80012c9a0d3",
"payerWalletId": "66f2a3d1b4d3e80012c9a0d2",
"linkedTransactions": [
{
"transactionId": "66f2a7e9b4d3e80012c9a113",
"linkType": "CLEARING_DEBITED_BY",
"createdAt": "2026-11-03T09:12:40.000Z",
"updatedAt": "2026-11-03T09:12:40.000Z",
"_id": "66f2a7e9b4d3e80012c9a114"
}
]
},
"feeTransaction": {
"txnCurrency": "986",
"txnAmount": 664,
"txnAmountAuthorized": 664,
"_id": "66f2a7e9b4d3e80012c9a117",
"linkedTransactions": [
{
"transactionId": "66f2a7e9b4d3e80012c9a113",
"linkType": "CLEARING_DEBITED_BY",
"createdAt": "2026-11-03T09:12:40.000Z",
"updatedAt": "2026-11-03T09:12:40.000Z",
"_id": "66f2a7e9b4d3e80012c9a114"
}
],
"description": "Tarifa de compra internacional",
"external": {
"invoiceId": "66f2a8a1b4d3e80012c9a120",
"dealId": "66f2a8a1b4d3e80012c9a121",
"contractId": "66f2a8a1b4d3e80012c9a122"
},
"creditParty": {
"type": "LOCAL",
"_id": "66f2a7e9b4d3e80012c9a118",
"local": {
"realmId": "f495ff0c-ab54-4f99-8e92-ca8682e4de9b",
"organizationId": "c4bd3f21-dfbd-44e8-8055-68ba15bed410",
"accountId": "66f2a1c7b4d3e80012c9a0b4",
"walletId": "66f2a3d1b4d3e80012c9a0d2"
},
"remote": {
"pixKey": "financeiro@acme.com.br",
"pixDict": "EMAIL"
}
},
"debitParty": {
"type": "LOCAL",
"_id": "66f2a7e9b4d3e80012c9a118",
"local": {
"realmId": "f495ff0c-ab54-4f99-8e92-ca8682e4de9b",
"organizationId": "c4bd3f21-dfbd-44e8-8055-68ba15bed410",
"accountId": "66f2a1c7b4d3e80012c9a0b4",
"walletId": "66f2a3d1b4d3e80012c9a0d2"
},
"remote": {
"pixKey": "financeiro@acme.com.br",
"pixDict": "EMAIL"
}
}
},
"enrichment": {
"merchant": null,
"category": "OFFICE_SUPPLIES",
"rulesVersion": 3,
"_id": "66f2a7e9b4d3e80012c9a116"
},
"customFields": {
"cost-center": "CC-1020"
},
"spendReview": {
"status": "PENDING_APPROVAL",
"policyId": "3f2e1d0c-9b8a-4c7d-8e6f-5a4b3c2d1e0f",
"policyRequestId": "4d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a",
"requester": {
"userId": "e3553bc1-5e20-4e17-b22a-a796fda0aa99",
"name": "Mariana Costa",
"email": "mariana.costa@acme.com.br"
},
"requestedAt": "2026-11-02T18:02:11.000Z",
"autoApproved": false,
"approvalExpiresAt": "2026-12-02T18:02:11.000Z",
"decidedAt": "2026-11-03T10:15:00.000Z",
"declineOutcome": "DENIED",
"decisionReason": "Falta o comprovante"
},
"spendReviewSubmissionLeaseUntil": "2026-11-02T18:07:11.000Z",
"receipts": "https://files.example.com/receipt.pdf",
"external": {
"transactionId": "0F1E2D3C4B5A69788796A5B4C3D2E1F0",
"pixId": "b6c2a1f0-3d4e-4f5a-8b9c-0d1e2f3a4b5c",
"paymentId": "c7d3b2a1-4e5f-4a6b-9c0d-1e2f3a4b5c6d",
"boletoId": "d8e4c3b2-5f6a-4b7c-8d1e-2f3a4b5c6d7e",
"tedId": "e9f5d4c3-6a7b-4c8d-9e2f-3a4b5c6d7e8f"
},
"processingType": "INSTANT",
"internalErrorCode": "LIMIT_EXCEEDED",
"__v": 0,
"paymentInfo": {
"status": "PAID",
"external": {
"pixId": "c7810c30-971f-4e84-8feb-b7819087d4de",
"platformUserId": "e3553bc1-5e20-4e17-b22a-a796fda0aa99"
}
}
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "FORBIDDEN_WALLET",
"origin": "BANKING",
"message": "You do not have permission to perform this action on this wallet"
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "ACCOUNT_NOT_FOUND",
"origin": "BANKING",
"message": "Account not found"
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "BAD_REQUEST",
"origin": "BANKING",
"message": "Bad Request: Your request is invalid or incomplete. Please make sure you are requesting with the right fields.",
"fields": [
{
"field": "details",
"message": "Invalid option: expected one of \"true\"|\"false\"",
"code": "DETAILS_ONE_OF"
}
]
}For a Pix sent, a boleto paid or a card transaction,
paymentInfo adds the status and references of the Pix payment, boleto payment or card behind it; with details=true, the whole record instead. Use default as walletId for the organization’s main wallet, and send x-environment: LIVE for production wallets.
Organization admins can read every wallet’s transactions; other users only those of the wallets shared with them, in any role.Headers
Environment of the wallet: LIVE (production) or TEST (sandbox). When you omit it, the request runs in TEST; any other value is rejected.
Available options:
LIVE, TEST Path Parameters
ID of your realm.
Format: UUID
ID of the organization the wallet belongs to.
Format: UUID
ID of the organization's account (24 hexadecimal characters).
Pattern:
^[0-9a-fA-F]{24}$ID of the wallet (24 hexadecimal characters), or default for the organization's main wallet.
Pattern:
^([0-9a-fA-F]{24}|default)$ID of the transaction (24 hexadecimal characters).
Pattern:
^[0-9a-fA-F]{24}$Query Parameters
true to get, in paymentInfo, the whole Pix payment, boleto payment or card behind the transaction instead of its status and external references (or, for a card, its masked number). Defaults to false.
Available options:
true, false Response
Successful response
A transaction, with what the payment or card behind it says.
ID of the transaction.
Example:
"6710c9a2b4d3e80012c9a1e4"
Environment of the transaction: LIVE (production) or TEST (sandbox).
Available options:
LIVE, TEST Example:
"LIVE"
ID of the realm.
Example:
"f495ff0c-ab54-4f99-8e92-ca8682e4de9b"
ID of the organization.
Example:
"c4bd3f21-dfbd-44e8-8055-68ba15bed410"
ID of the organization's account.
Example:
"66f2a1c7b4d3e80012c9a0b4"
ID of the wallet.
Example:
"66f2a3d1b4d3e80012c9a0d2"
Balance of that category before the transaction, in cents (BRL). Can be null.
Example:
1250000
Effect on the balance: DEBIT (money out), CREDIT (money in) or NONE (no effect — a declined or authorization-only card transaction, a failed transfer).
Available options:
DEBIT, CREDIT, NONE Example:
"CREDIT"
Result code. 0 is success; for a card, a few other codes are approvals too (such as 10, partially approved) and the rest are decline reasons, such as 51 (insufficient funds). Use financialImpactType to know whether money moved.
Example:
0
Kind of message: 1100 (card authorization), 1120 (card settlement or credit), 1400 (card refund), 1420 (card reversal), 1600 (Pix or boleto), 1220 (transfer between wallets, or TED), 1722 (charge), 8900 / 8901 / 8902 (fee).
Example:
1600
Operation type: for a card, ISO 8583 codes such as 0 (purchase) or 14 (return); for the others, 12 (credit), 13 (debit), 36 (Pix received), 39 (Pix or boleto paid) or 27 (a refund).
Example:
36
When the transaction happened. Lists are ordered by it, and the period filters apply to it.
Example:
"2026-10-17T13:42:58.000Z"
Amount charged to or credited on the wallet, in cents (BRL).
Example:
15000
Amount authorized, in cents (BRL). The totals add this one up.
Example:
15000
When the record was created.
Example:
"2026-10-17T13:43:01.000Z"
When the record last changed.
Example:
"2026-10-17T13:43:01.000Z"
ID of the card, on a card transaction or a fee charged on a card.
Example:
"66f2a4b8b4d3e80012c9a0e1"
Balance category of the wallet the amount was taken from or added to, such as FLEX_INTERNATIONAL, FLEX_NATIONAL, ADS, TRAVEL, HOTEL, AIRLINES, GAS, FOOD or CASHBACK.
Example:
"FLEX_INTERNATIONAL"
Currency of the billed amounts, as an ISO 4217 numeric code: 986 (Brazilian real). Absent on a few boleto transactions.
Example:
"986"
Details of a card purchase, its settlement or refund.
Show child attributes
Show child attributes
Details of a Pix sent or received.
Show child attributes
Show child attributes
Details of a boleto paid or received.
Show child attributes
Show child attributes
Details of a TED sent.
Show child attributes
Show child attributes
Details of a transfer between wallets at Portão 3.
Show child attributes
Show child attributes
Details of a fee.
Show child attributes
Show child attributes
Merchant and spending category recognized for a card purchase. Absent on older ones.
Show child attributes
Show child attributes
Values of the organization's transaction custom fields, keyed by each field's slug. Absent when the transaction has none. On a few older transactions it is still an array of custom field entries, from before values were keyed by slug.
Example: {"cost-center":"CC-1020"}
- object
- object[]
Show child attributes
Show child attributes
Example:
{ "cost-center": "CC-1020" }
The expense review, once the transaction was submitted for approval.
Show child attributes
Show child attributes
Until when a submission for review is being processed. Absent otherwise.
Example:
"2026-11-02T18:07:11.000Z"
Receipt attached to an older transaction.
Example:
"https://files.example.com/receipt.pdf"
References of the transaction outside its ledger record. Absent on a transfer between wallets that failed.
Show child attributes
Show child attributes
INSTANT (processed as it happened) or DELAYED (processed later, such as a payment scheduled for a later day). Absent on a few older transactions.
Available options:
INSTANT, DELAYED Example:
"INSTANT"
Why a transaction that moved no money failed, such as INSUFFICIENT_FUNDS, LIMIT_EXCEEDED or REJECTED_BY_ANTIFRAUD_PREVENTION_RULES.
Example:
"LIMIT_EXCEEDED"
Version of the record. Absent on a few older ones.
Example:
0
On a Pix sent, a boleto paid or a card transaction: the status and references of the Pix payment, boleto payment or card behind it — or, with details=true, that whole Pix payment (as GET .../pix/{pixId} returns it), boleto payment or card. null when that record is gone; absent on any other transaction.
- Option 1
- Option 2
- Option 3
- Option 4
Show child attributes
Show child attributes