Documentation

Documentation

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

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

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

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

Работа с API

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

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

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

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

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

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

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

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

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

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

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

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

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

Виджеты

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

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

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

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

Самозанятые

  • Общая информация
  • Привязка
  • Проверка привязки
  • Проверка данных
  • Оповещения из ФНС
  • Начисления и бонусы

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

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

Справочник API

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

Взаимодействие с API

Формат запросов

Все данные в запросах к Банку 131 и уведомлениях от Банка передаются методом GET или POST по протоколу HTTP. Параметры сообщения упаковываются в JSON-объект.

Адрес для отправки запросов

Как сформировать

<адрес сервера> + /api/v1.1/ + <адрес для отправки запросов нужного метода>

Адреса серверов

  • Для тестирования https://kyc-stage.bank131.ru/
  • Для реальных операций https://kyc.bank131.ru/

Аутентификация

В заголовках запросов к Банку 131 необходимо передавать идентификатор вашего проекта.

Заголовки

НазваниеОбязательностьТипОписание
X-PARTNER-PROJECT+stringИдентификатор проекта. Выдается менеджером Банка 131

Пример запроса с аутентификацией

curl -X GET \
  https://kyc.bank131.ru/api/v1.1/check/7 \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -d '{
    // тело запроса
}'
 

Подпись запросов

В запросах на проверку отправляются персональные данные, поэтому требуется подписывать запросы с помощью КриптоПро.

Что нужно для работы с КриптоПро

  1. Получить усиленную квалифицированную электронную подпись (УКЭП), если у вас ее нет. Это можно сделать в любом удостоверяющем центре.

Для тестирования можно создать сертификат ключа проверки электронной подписи в Тестовом удостоверяющем центре КриптоПро, но для реальных операций он не подойдет.

  1. Установить КриптоПро CSP на свой компьютер.

  2. Добавить в КриптоПро сертификат своей электронной подписи (вот, для примера, инструкция для Windows).

  3. Отправить публичную часть ключа электронной подписи вашему менеджеру в Банке 131 (чтобы мы могли проверять ваши запросы).

Готово, теперь вы можете подписывать запросы с помощью КриптоПро.

Как подписывать запросы

Шаг 1. Создайте файл для подписи

Возьмите тело запроса (содержимое payload), отсортируйте по ключам и запишите в файл. Используйте кодировку UTF-8.

Пример
import json

payload = {...}

payload_bytes = bytes(json.dumps(payload, sort_keys=True) + '\r\n', encoding='utf-8')

with open('payload_bytes.jsonb', 'wb') as f:
    f.write(payload_bytes)

Шаг 2. Подпишите файл

Подпишите файл средствами КриптоПро. Например, с помощью приложения cryptcp (входит в КриптоПро).

Пример создания подписи с помощью cryptcp
cryptcp -sign -display -thumbprint <отпечаток_ключа_для_подписи> -detached payload_json.json payload_json.sig

Шаг 3. Добавьте в запрос подпись

Заберите получившуюся подпись из файла payload_json.sig и передайте в запросе — в поле signature.

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