Get Balance
Get Balance API fetches balance details from the MCA for the specified MID (merchant or sub-merchant). If MID is not provided, returns aggregated balances across all supported currencies and entities.
Balances are categorised per currency as follows:
totalCollectionsAmount: Total amount collected from fiat/crypto payin orderstotalPayoutAmount: Total amount paid out for fiat/crypto payout orderstotalPayoutInTransitBalance: Total fees deducted from the MCA account for fiat/crypto payout orderstotalSettledAmount: Total amount settled to the customer from the MCA accounttotalUnsettledAmount: Total amount yet to be settled in the MCA accounttotalAvailablePrefundingBalance: Total available prefunding balance
curl --location 'https://sandbox-api.transfi.com/v3/balance?limit=5&page=1¤cy=USDC' \
--header 'mid: SAH1N3_NA_NA' \
--header 'Authorization: Basic =='
{
"status": "success",
"data": {
"balance": [
{
"currency": "USDC",
"totalCollectionsAmount": 100,
"totalPayoutAmount": 29.069767,
"totalPayoutInTransitBalance": 0,
"totalSettledAmount": 0,
"totalUnsettledAmount": 100,
"totalAvailablePrefundingBalance": 199970.930233,
"totalPayoutFee": 0
}
],
"date": "2026-03-02"
},
"pagination": {
"total": 1,
"pages": 1,
"currentPage": 1,
"limit": 5,
"hasNext": false,
"hasPrev": false
}
}Updated about 1 month ago