Get Balance

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. Total amount collected from fiat/crypto payin orders
  2. Total amount paid out for fiat/crypto payout orders
  3. Total fees deducted from the MCA account for fiat/crypto payout orders
  4. Total amount settled to the customer from the MCA account
  5. Total amount yet to be settled in the MCA account

curl --request GET \
     --url 'https://sandbox-api.transfi.com/v2/balance?currency=EUR' \
     --header 'MID: ATY3AY_NA_NA' \
     --header 'accept: application/json' \
     --header 'MID: ABCDEF_NA_NA' \
     --header 'authorization: Basic abcdef123abcdef' \
{
  "balance": [
    {
      "_id": "EUR",
      "totalCollectionsAmount": 9371.61,
      "totalPayoutAmount": 283.32,
      "totalSettledAmount": 198.8,
      "totalUnsettledAmount": 3665.69,
      "totalAvailablePrefundingBalance": 16980.49,
      "totalPayoutFee": 0,
      "totalPayoutInTransitBalance": 0,
      "currency": "EUR"
    }
  ],
  "date": "2025-08-12"
}