Управление балансами мерчанта

Платформа Syncra V2 предоставляет мультивалютный финансовый шлюз, позволяющий мерчантам принимать и выплачивать средства в различных фиатных валютах СНГ и Азии, а также аккумулировать и выводить средства в криптовалюте (USDT).

Для каждого мерчанта в системе ведется учет балансов в разрезе типов кошельков и используемых валют.

Получение балансов мерчанта

Чтобы запросить актуальную финансовую информацию по вашим балансам, выполните следующий GET-запрос:

GET /api/v1/p2p/merchant/balance

Формат ответа (200 OK)

В ответ возвращается объект со списком кошельков wallets, содержащий идентификатор кошелька, валюту, доступный (available), замороженный (frozen) и общий (total) баланс.

{
  "data": {
    "wallets": [
      {
        "wallet_id": "8f870a31-b88d-4cb0-a882-628d08cbda88",
        "currency": "RUB",
        "available": 15000000,
        "frozen": 0,
        "total": 15000000
      },
      {
        "wallet_id": "TRx7Vn2a3bK8HJdZmFc4eD5q1wP9nLs6t",
        "currency": "USDT",
        "available": 450000,
        "frozen": 25000,
        "total": 475000
      }
    ]
  }
}

Поддерживаемые типы балансов

В личном кабинете мерчанта и при расчетах используются следующие типы балансов:

1. MAIN (Основной баланс):

   • Используется для совершения стандартных операций (прием платежей и ручные/автоматические выплаты).
   • Все успешные входящие платежи (PayIn) за вычетом комиссии платформы зачисляются на основной баланс.
   • Выплаты клиентам (PayOut) списываются с основного баланса.

2. INSURANCE (Страховой баланс):

   • Специальный резервный счет мерчанта, используемый для обеспечения обязательств и покрытия диспутов (чарджбэков).
   • Средства на страховом балансе блокируются на определенный срок или хранятся в качестве неснижаемого остатка.

3. DEPOSIT (Депозитный баланс):

   • Баланс, предназначенный для предварительного пополнения мерчантом (депозита) с целью осуществления последующих массовых выплат, если прием платежей на платформе не используется.

Поддерживаемые валюты

Syncra V2 — мультивалютная платформа. Список поддерживаемых валют определяется конфигурацией тенанта (таблица p2p_currencies) и может быть расширен администратором в реальном времени без перезапуска сервисов.

Примеры валют:

Замороженные средства (Frozen)

Показатель frozen в ответе API указывает на сумму средств, временно заблокированную на кошельке:

• Удержание на выплату (Payout Hold): Когда вы создаете запрос на выплату (POST /deals/payout), сумма транзакции плюс расчетная комиссия переводятся в статус frozen до момента подтверждения выплаты трейдером или банком. При успешном завершении средства окончательно списываются, при ошибке — возвращаются в доступный баланс (available).
• Спорные транзакции (Disputes Hold): В случае открытия диспута по входящей транзакции, оспариваемая сумма временно замораживается на балансе мерчанта до вынесения решения арбитражем платформы.