S
docs.syncra.money
API ReferenceMerchant API

Справочник банков и методов оплаты

Список поддерживаемых банков России и СНГ, доступные платежные методы в Syncra V2

Банки и методы оплаты

Для тонкой настройки процесса проведения P2P-платежей Syncra V2 предоставляет справочник банков и платежных каналов. Это позволяет мерчантам направлять клиентов на предпочтительные способы оплаты для повышения конверсии.


Поддерживаемые банки

Список банков определяется конфигурацией тенанта и управляется администратором через панель управления. Актуальный перечень можно получить через GET /banks.

Примеры банков для рынка РФ:

Системное имяОтображаемое названиеМетоды
sberСбербанкSBP, BANK_CARD
t-bankТ-БанкSBP, BANK_CARD

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


Доступные методы оплаты (Payment Methods)

Методы оплаты определяют технический протокол проведения платежа:

  • SBP (Система быстрых платежей): Перевод по номеру телефона плательщика на карту трейдера в любом банке-участнике СБП. Максимальная конверсия на рынке РФ.
  • BANK_CARD (Перевод с карты на карту): Прямой перевод по 16-значному номеру банковской карты получателя.

Получение списка банков через API

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

GET /api/v1/p2p/merchant/banks

Параметры запроса (Query Parameters)

ПолеТипОбяз.Описание
countrystringНетISO-код страны для фильтрации (например, "ru", "uz").
currencystringНетВалюта платежей (например, "RUB").

Пример запроса

GET /api/v1/p2p/merchant/banks?country=ru&currency=RUB

Пример ответа (200 OK)

{
  "data": {
    "banks": [
      {
        "bank_name": "sber",
        "display_name": "Сбербанк",
        "country": "ru",
        "methods": ["BANK_CARD", "SBP"]
      },
      {
        "bank_name": "t-bank",
        "display_name": "Т-Банк",
        "country": "ru",
        "methods": ["BANK_CARD", "SBP"]
      }
    ]
  }
}

Автоматическая фильтрация и каскады

Шлюз Syncra V2 автоматически управляет доступностью банков:

  • Если у трейдеров исчерпаны лимиты по приему на карты определенного банка (например, ВТБ), этот банк временно пропадает из ответа /banks и скрывается на платежной форме клиента.
  • Система распределяет входящий поток платежей по картам банков-партнеров для предотвращения блокировок, что повышает долговечность платежных реквизитов.

On this page