Перейти к основному содержимому

Виджет для привязки самозанятого к Банку 131

Этот виджет позволяет привязать самозанятого к Банку 131. Перед тем, как его показывать пользователю, можно узнать, является ли человек самозанятым и привязан ли он к Банку 131. Это можно сделать с помощью пары запросов check и session/request.

Как выглядит виджет​

Начальное состояние виджета​

alt-text

Запрос на привязку самозанятого был успешно отправлен​

alt-text

Физлицо подтвердило привязку к Банку 131 и обновило статус заявки​

alt-text

Физлицо отклонило привязку к Банку 131​

alt-text

Ошибка в процессе привязки​

alt-text

Как добавить виджет на страницу​

Для использования виджета необходимо подключить на страницу JavaScript-библиотеку и получить токен. По одному токену можно провести одну операцию.

1. Подключите скрипт и базовые стили на страницу​

На тестовой среде

<link
  href="https://widget-demo.bank131.ru/self-employed.css"
  rel="stylesheet"
/>
<script src="https://widget-demo.bank131.ru/self-employed.js"></script>

Для реальных операций

<link href="https://widget.bank131.ru/self-employed.css" rel="stylesheet" />
<script src="https://widget.bank131.ru/self-employed.js"></script>

2. Разместите в коде контейнер, в который будет вставлен виджет​

<div id="bank131-self-employed"></div>

3. Создайте экземпляр виджета​

Для создания экземпляра виджета используйте глобальный объект Bank131SelfEmployed, отобразите его в контейнере с помощью метода render(). Вам понадобится уникальный токен, полученный для работы с этим виджетом. В значении параметра taxReference можно передать ИНН физлица, который будет показан в виджете, это позволит самозанятому не ошибиться при вводе своего ИНН при привязке.

<script>
  if (window.Bank131SelfEmployed) {
    const selfEmployed = new Bank131SelfEmployed({
      initialValues: {
        taxReference: '500000000000',
      },
      stage: Bank131SelfEmployed.STAGES.bind,
      publicToken: '0eb43bd1b6f5c7ed83903d7acd774179621018a2e74fb2702e5616f1f31fe553', // токен
    });

    selfEmployed.render();
  }
</script>

5. Получите результат от виджета​

Подпишитесь на сообщения на текущей странице.

window.addEventListener('message', function (event) {
  // Код обработчика

  console.dir(event.data);
});

Формат сообщения event.data

{
  "meta": {
    "stage": "bind"
  },
  "payload": {
    "status": "completed" // "in_progress" или "failed"
  }
}

Возможные значения поля status:

  • completed — привязка прошла успешно;
  • in_progress — регистрация в процессе, ждем, когда самозанятый подтвердит привязку в приложении «Мой налог» или на сайте налоговой.
  • failed — произошла ошибка, привязать самозанятого не получилось.