Documentation

Documentation

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

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

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

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

Работа с API

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

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

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

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

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

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

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

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

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

  • Возможности
  • Процесс платежа
  • Платеж банковской картой
  • Платежи с холдированием
  • Возвраты
  • Рекуррентные платежи
  • Сплит-платежи

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

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

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

Виджеты

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

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

  • Возможности
  • Взаимодействие
  • Проверка паспорта
  • Статус проверки
  • HTTP-коды ответа

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

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

Справочник 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 сможет понять, что самозанятый прошел проверку.

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