Настройка виджета LanbillingX

Подготовка к подключению виджета

Чтобы аутентифицировать клиента, для которого будет отображаться виджет, необходимо сгенерировать JWT токен, уникальный для этого клиента.

Параметры JWT токена:

1. ident_type - тип параметра, по которому пользователь будет найден в LanbillingX. Может принимать значения:

• 0 - Логин клиента
• 1 - Имя/Название клиента
• 2 - ИНН клиента
• 3 - Мобильный телефон клиента
• 4 - Email клиента
• 5 - Номер договора клиента

Выберите тот тип параметра, по которому этот клиент будет найден в LanbillingX и доступен в вашей системе на момент генерации токена.

2. ident - значение параметра указанного в ident_type, например, 7726520179 для ИНН

3. iat - Timestamp создания токена

Пример payload токена:

{
  "ident_type": 2,
  "ident": "7726520179",
  "iat": 1712131614
}

Для генерации токена можно использовать сторонние библиотеки, например firebase/php-jwt. Токен должен быть подписан с использованием секрета, который вы получили в Email, с помощью алгоритма HS256.

После генерации токена получите строку вида:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.
eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.
SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c.

Её нужно будет передать при инициализации виджета.

Подключение виджета

Для подключения виджета LanbillingX выполните следующие шаги:

1. Подключите файл «widget» на вашей странице:

<script src="https://URL_billing/lbxwidget.js"></script>

2. Добавьте контейнер в html страницы, на которой будете отображать виджет:

<div id="widget-container"></div>

3. После загрузки файла «script» инициируйте рендер виджета в созданном контейнере:

const widget = lbxwidget({ token: {jwtToken}, {...остальные параметры} });
widget.render('widget-container');

Описание параметров

1. Объект настроек виджета:

   • token - JWT токен, сгенерированный ранее (обязательный параметр).
   • disableCreateSubscription: boolean - отключает возможность создания подписки.
   • disableEditSubscription: boolean - отключает возможность редактирования подписки.
   • disableStopSubscription: boolean - отключает возможность остановки подписки.
   • disableAutopayments: boolean - отключает автоплатежи.
   • disablePayments: boolean - отключает возможность оплаты.
   • disableInvoiceGeneration: boolean - отключает возможность генерации счёта.
   • hideInvoicesList: boolean - отключает отображение списка счетов.
   • hideSubscriptionsList: boolean - отключает отображение списка подписок.

2. Контейнер, в котором будет отображаться виджет.