Skip to main content

Get wallet balance

GET https://wallet.paysera.com/rest/v1/wallet/{walletId}/balance

Retrieve current balances for all currencies in the wallet.

Example queries:

  • Basic: GET /wallet/14471/balance
  • With conversion: GET /wallet/14471/balance?convert_to=EUR
  • Show historical: GET /wallet/14471/balance?show_historical_currencies=true

Balance Types​

  • Available: Amount that can be spent or withdrawn
  • Reserved: Amount temporarily locked for pending transactions

Requirements​

  • SCOPE_BALANCE or SCOPE_BALANCE_OFFLINE

Authorization​

This endpoint requires MAC (Message Authentication Code) authentication.

Authorization Header Format:

Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH", ext="body_hash=BODY_HASH"

Example:

Authorization: MAC id="a9b8c7d6e5f4g3h2", ts="1234567890", nonce="xyz123abc456def", mac="dGhpcyBpcyBhIHJhbmRvbSBtYWMgaGFzaCB2YWx1ZQ==", ext="body_hash=cmFuZG9tQm9keUhhc2hWYWx1ZQ%3D%3D"

For more details, see the Authentication section.

Parameters​

Path Parameters​

NameTypeRequiredDescription
walletIdstring✓Wallet identifier (integer or 'me')

Query Parameters​

NameTypeRequiredDescription
convert_tostringCurrency code to convert all currencies to
show_historical_currenciesbooleanWhether to show currencies with 0 balance

Example​

Request​

GET https://wallet.paysera.com/rest/v1/wallet/{walletId}/balance?convert_to=EUR&show_historical_currencies=value
Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH"

Response​

{
  "EUR": {
    "at_disposal": 2299,
    "at_disposal_decimal": "22.99",
    "reserved": 0,
    "reserved_decimal": "0.00"
  },
  "USD": {
    "at_disposal": 100,
    "at_disposal_decimal": "1.00",
    "reserved": 9800,
    "reserved_decimal": "98.00"
  }
}

AUTHORIZATION: HTTP

REQUEST

Base URL
https://wallet.paysera.com
Query Parameters
convert_to
Currency code to convert all currencies to
show_historical_currencies
Whether to show currencies with 0 balance

RESPONSE

Balance retrieved successfully
{
  "EUR": {
    "at_disposal": 2299,
    "at_disposal_decimal": "22.99",
    "reserved": 0,
    "reserved_decimal": "0.00"
  },
  "USD": {
    "at_disposal": 100,
    "at_disposal_decimal": "1.00",
    "reserved": 9800,
    "reserved_decimal": "98.00"
  }
}