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:

  1. totalCollectionsAmount: Total amount collected from fiat/crypto payin orders
  2. totalPayoutAmount: Total amount paid out for fiat/crypto payout orders
  3. totalPayoutInTransitBalance: Total fees deducted from the MCA account for fiat/crypto payout orders
  4. totalSettledAmount: Total amount settled to the customer from the MCA account
  5. totalUnsettledAmount: Total amount yet to be settled in the MCA account
  6. totalAvailablePrefundingBalance: Total available prefunding balance

curl --location 'https://sandbox-api.transfi.com/v3/balance?limit=5&page=1&currency=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
    }
}