Приложение, баланс и курсы

Информация о приложении, баланс, курсы монет, список доступных монет и статистика: getMe, getBalance, getExchangeRates, getCurrencies, getStats.

На этой странице

getMe getBalance getExchangeRates getCurrencies getStats

Эти методы ничего не меняют — только читают данные. Их можно вызывать через GET или POST и безопасно повторять.

getMe

Проверка токена и базовая информация о приложении. Параметров нет.

cURL

curl https://pay.pswallet.org/api/getMe \
  -H "PSWallet-Pay-API-Token: $TOKEN"

Возвращает объект:

Поле	Тип	Описание
`app_id`	Number	ID приложения (в кабинете — `#A1234`).
`name`	String	Название приложения.
`payment_processing_bot_username`	String	Бот, в котором пользователи оплачивают счета.

json

{
  "ok": true,
  "result": {
    "app_id": 1234,
    "name": "My Shop",
    "payment_processing_bot_username": "pswallet"
  }
}

getBalance

Баланс приложения по всем доступным монетам, включая нулевые. Параметров нет. Возвращает массив Balance.

available — можно потратить на переводы, чеки и вывод.
onhold — удержано под неактивированные чеки.

cURL

curl https://pay.pswallet.org/api/getBalance \
  -H "PSWallet-Pay-API-Token: $TOKEN"

json

{
  "ok": true,
  "result": [
    { "currency_code": "USDT-TRC20", "available": "84.47", "onhold": "2" },
    { "currency_code": "USDT-BEP20", "available": "0", "onhold": "0" },
    { "currency_code": "USDT-ERC20", "available": "0", "onhold": "0" },
    { "currency_code": "USDT-TON", "available": "12.5", "onhold": "0" },
    { "currency_code": "XAUT", "available": "0", "onhold": "0" },
    { "currency_code": "TRX", "available": "150.25", "onhold": "0" },
    { "currency_code": "BNB", "available": "0", "onhold": "0" },
    { "currency_code": "ETH", "available": "0", "onhold": "0" },
    { "currency_code": "GRAM", "available": "0", "onhold": "0" },
    { "currency_code": "RUB", "available": "1455.48", "onhold": "0" }
  ]
}

Временно недоступные монеты в ответ не попадают. Балансы USDT возвращаются по сетям: у приложения отдельный баланс в каждой сети.

getExchangeRates

Текущие курсы монет к USD и RUB. Параметров нет. Возвращает массив ExchangeRate. По этим курсам пересчитываются фиатные счета.

Курсы возвращаются для USDT (одинаковый для всех сетей), остальных доступных монет и рубля. Если источник курса временно недоступен, у строки is_valid: false и rate: "0" — не используйте такой курс в расчётах.

cURL

curl https://pay.pswallet.org/api/getExchangeRates \
  -H "PSWallet-Pay-API-Token: $TOKEN"

json

{
  "ok": true,
  "result": [
    { "is_valid": true, "is_crypto": true, "is_fiat": false, "source": "USDT", "target": "USD", "rate": "1" },
    { "is_valid": true, "is_crypto": true, "is_fiat": false, "source": "USDT", "target": "RUB", "rate": "81.25" },
    { "is_valid": true, "is_crypto": true, "is_fiat": false, "source": "TRX", "target": "USD", "rate": "0.2874" },
    { "is_valid": true, "is_crypto": true, "is_fiat": false, "source": "TRX", "target": "RUB", "rate": "23.35" },
    { "is_valid": true, "is_crypto": false, "is_fiat": true, "source": "RUB", "target": "USD", "rate": "0.01230769231" }
  ]
}

Курсы в примере условные; ответ сокращён.

getCurrencies

Список монет и валют, которые сейчас принимает API. Параметров нет. Возвращает массив Currency.

В списке — коды монет с сетью (USDT-TRC20, USDT-BEP20 и т. д.) и фиатная валюта USD. Временно недоступные монеты в список не попадают. Код USDT (любая сеть) в списке отдельно не указан, но его можно использовать в параметрах — см. Монеты и суммы.

cURL

curl https://pay.pswallet.org/api/getCurrencies \
  -H "PSWallet-Pay-API-Token: $TOKEN"

json

{
  "ok": true,
  "result": [
    { "is_blockchain": true, "is_stablecoin": true, "is_fiat": false, "name": "Tether (TRC20)", "code": "USDT-TRC20", "decimals": 6 },
    { "is_blockchain": true, "is_stablecoin": true, "is_fiat": false, "name": "Tether (BEP20)", "code": "USDT-BEP20", "decimals": 6 },
    { "is_blockchain": true, "is_stablecoin": false, "is_fiat": false, "name": "TRON", "code": "TRX", "decimals": 6 },
    { "is_blockchain": true, "is_stablecoin": false, "is_fiat": false, "name": "BNB (BEP20)", "code": "BNB", "decimals": 8 },
    { "is_blockchain": false, "is_stablecoin": false, "is_fiat": true, "name": "Russian Ruble", "code": "RUB", "decimals": 2 },
    { "is_blockchain": false, "is_stablecoin": false, "is_fiat": true, "name": "US Dollar", "code": "USD", "decimals": 2 }
  ]
}

Ответ сокращён.

getStats

Статистика приложения за период. Возвращает AppStats.

Параметр	Тип	Описание
`start_at`	String	Необязательно. Начало периода, ISO 8601. По умолчанию — сутки назад от `end_at`.
`end_at`	String	Необязательно. Конец периода, ISO 8601. По умолчанию — сейчас.

Начало периода должно быть раньше конца, иначе вернётся ошибка PARAM_START_AT_INVALID. Неверная дата — PARAM_START_AT_INVALID или PARAM_END_AT_INVALID.

cURL

curl "https://pay.pswallet.org/api/getStats?start_at=2026-11-01T00:00:00Z&end_at=2026-11-08T00:00:00Z" \
  -H "PSWallet-Pay-API-Token: $TOKEN"

json

{
  "ok": true,
  "result": {
    "volume": 1520.5,
    "conversion": 0.6154,
    "unique_users_count": 31,
    "created_invoice_count": 65,
    "paid_invoice_count": 40,
    "start_at": "2026-11-01T00:00:00.000+00:00",
    "end_at": "2026-11-08T00:00:00.000+00:00"
  }
}

volume — оборот оплаченных за период счетов в USD (по курсу в момент оплаты).
conversion — доля оплаченных счетов среди созданных за период, от 0 до 1.

Приложение, баланс и курсы

#getMe

#getBalance

#getExchangeRates

#getCurrencies

#getStats

getMe

getBalance

getExchangeRates

getCurrencies

getStats