Documentation

Documentation

  • API Банка 131
  • Languages iconРусский
    • English

›Проверка паспорта

Документация

  • Возможности API
  • С чего начать

Работа с API

  • Формат работы
  • Библиотеки
  • Тестирование
  • История изменений

Массовые выплаты

  • Возможности
  • Как всё работает
  • Сценарии выплат
  • Возвраты выплат
  • Самозанятые

    • Выплаты самозанятым
    • Привязка самозанятого
    • Фискализация без выплаты

    Способы получения выплат

    • На российскую банковскую карту
    • На иностранную карту
    • На счет в российском банке
    • В кошелек QIWI
    • В кошелек ЮMoney (Яндекс.Деньги)
    • В налоговую
    • Через СБП по номеру телефона

    Выплаты по шагам

    • Выплата на карту с виджетом
    • Выплата одним запросом
    • Выплата на карту с PCI DSS
    • Выплата самозанятому с фискализацией

Прием платежей

  • Возможности
  • Процесс платежа
  • Платеж банковской картой
  • Платежи с холдированием
  • Возвраты
  • Рекуррентные платежи
  • Интеграция с Google Pay™
  • Платежи через Telegram
  • Платежи через СБП по QR-коду
  • Сплит-платежи

    • Варианты и возможности
    • Сплит-платежи без доработок
    • Сплит-платежи по API

    Платежи по шагам

    • Оплата через платежную форму
    • Оплата с PCI DSS
    • Платеж одним запросом
    • Google Pay™

Виджеты

  • Виджет для токенизации карты
  • Виджет платежной формы
  • Виджет для привязки самозанятого

Проверка паспорта

  • Возможности
  • Взаимодействие
  • Методы

    • Проверка паспорта
    • Статус проверки
  • Ответы и ошибки

Акты и реестры

  • Реестр выплат
  • Реестр платежей
  • Акт

Справочник API

  • Объекты
  • Методы
  • Вебхуки
  • Коды ошибок

Возможности

Когда у платежа есть выгодоприобретатель или бенефициар, Банку 131 требуется проверять получателя платежа — до проведения операции.

Например, если вы работаете с самозанятыми по агентской схеме (самозанятый является вашим выгодоприобретателем, а вы — агентом по приему денег в его пользу) и отправляете им выплаты или сплит-платежи.

Или вы осуществляете расчеты с использованием номинального счета, тогда деньги на этом счете принадлежат бенефициару. Им может быть физическое или юридическое лицо плательщик, или получателем-физическим лицом - зависит от вашей юридической модели. Если вы не знаете, кто бенефициар, обратитесь к своему менеджеру.

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

Для проверки бенифициаров физических лиц необходимо использовать данное АПИ.

Если вы не знаете, требуется ли вам проверять получателей, значит, вам это не нужно.

Как настроить взаимодействие

Взаимодействие с API проходит не так, как обычно: нужно использовать «КриптоПро» для подписи запросов. Это требование закона.

Подробнее про взаимодействие

Как провести проверку

Шаг 1. Отправьте запрос на проверку

Отправьте запрос cheсk с данными физического лица, Банк 131 проверит данные в СМЭВ.

Вам в ответ придет идентификатор заявки на проверку.

Шаг 2. Проверьте результат

Отправляйте запрос check/{id} с идентификатором, который пришел на предыдущем шаге.

Результат проверки вернется не сразу: может пройти от 10 минут до 2 суток.

Если всё в порядке (status — success), можно отправлять деньги.

Если вы отправите запрос cheсk с теми же данными (inn и agent_contract_number), в ответ на запрос check/{id} вернется ошибка (description — already exists).

В описании ошибки придет идентификатор предыдущей проверки, по которому можно узнать её статус.

Пример ответа при повторной проверке

{
    "status": "error",
    "error": {
        "code": "already_exists",
        "description": "Request with the same data already exists"
    }
    "data": {
        "id": "7" // идентификатор предыдущей проверки
       }
}

Как Банк 131 узнает, что данные проверены

При отправке выплаты самозанятому вы указываете ИНН (в поле tax_reference). По этому ИНН Банк 131 сможет понять, что самозанятый прошел проверку.

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

← Виджет для привязки самозанятогоВзаимодействие →
  • Как настроить взаимодействие
  • Как провести проверку
    • Шаг 1. Отправьте запрос на проверку
    • Шаг 2. Проверьте результат
  • Как Банк 131 узнает, что данные проверены
Documentation
Документация
Массовые выплатыПрием платежейСправочник API
Сценарии по шагам
Выплата на карту с токеномВыплата на карту с PCI DSSВыплата самозанятомуОплата через платежную форму
Напишите нам
Предложения и идеи — partners@131.ruПресса — press@131.ru
© 2022 Банк 131