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

Для тонкой настройки процесса проведения P2P-платежей Syncra V2 предоставляет справочник банков и платежных каналов. Это позволяет мерчантам направлять клиентов на предпочтительные способы оплаты для повышения конверсии. Платформа не привязана к конкретной стране: в справочнике могут быть банки РФ/СНГ (карты, СБП) и международных рынков (IBAN/BANK_TRANSFER — Турция, ЕС и др.).

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

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

Примеры банков по рынкам:

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

Методы оплаты определяют технический протокол проведения платежа. Под капотом каждый метод имеет тип реквизита (RequisiteType) — это нейтральная к стране классификация платёжного инструмента:

• SBP (Система быстрых платежений): Перевод по номеру телефона плательщика на карту трейдера в любом банке-участнике СБП. Максимальная конверсия на рынке РФ. Тип реквизита: SBP.
• BANK_CARD (Перевод с карты на карту): Прямой перевод по 16-значному номеру банковской карты получателя. Тип реквизита: BANK_CARD.
• BANK_TRANSFER (Международный банковский перевод по IBAN): Перевод по IBAN (ISO 13616) — международному номеру счёта получателя. Используется для рынков за пределами РФ/СНГ: Havale (Турция, TRY), SEPA (ЕС, EUR) и любые другие банковские переводы, где идентификатором получателя служит IBAN. На платёжной странице игроку отдаются поля iban, holder_name и payment_method_name; IBAN зашифрован в Vault тем же transit key, что и PAN. Тип реквизита: BANK_TRANSFER.

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

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

GET /api/v1/p2p/merchant/banks

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

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

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

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

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

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

Канонический справочник методов вашего тенанта — эндпоинт:

GET /api/v1/p2p/merchant/payment-methods

Возвращает активные (status: ACTIVE) методы тенанта мерчанта. Это канонический каталог идентификаторов методов: UUID (поле id) и слаг (поле slug) для payment_method_id в POST /deals/payin и для payment_method в POST /deals/payout — обе ноги сделки принимают оба формата (унифицированный контракт; рекомендуемый формат для PayIn — UUID, для PayOut — слаг).

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

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "slug": "express-havale",
      "name": "Havale Express (TRY)",
      "requisite_types": ["BANK_TRANSFER"],
      "currency_code": "TRY",
      "status": "ACTIVE"
    },
    {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "slug": "sbp_rub",
      "name": "SBP",
      "requisite_types": ["SBP"],
      "currency_code": "RUB",
      "status": "ACTIVE"
    }
  ]
}

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

• Состав ответа GET /banks формируется из активных методов тенанта (p2p_payment_methods.status = ACTIVE) с фильтрами по стране/валюте — никаких «временных исчезновений» банка из справочника при исчерпании дневных лимитов трейдеров не происходит (доступность конкретного трейдера/реквизита влияет на матчинг сделки, а не на справочник банков).
• Система распределяет входящий поток платежей по картам / IBAN-счетам банков-партнеров для предотвращения блокировок, что повышает долговечность платежных реквизитов. Это применяется ко всем типам реквизитов — BANK_CARD, SBP, E_WALLET, SIM, BANK_TRANSFER.