.. meta::
   :description: Настройка конечных точек в интерфейсе торговца SBC: терминалы, назначенные Торговцу для API-запросов Платёжного Шлюза, с поиском конечных точек и KPI.

.. _endpoints:

Терминалы
#########

.. role:: ex

.. role:: code


Терминал — это уникально идентифицированный терминал в Платежном шлюзе, который назначается Торговцу и должен быть указан в API командах Платежного Шлюза.

Поиск терминалов и KPI
=======================

.. |i| image:: ../_static/images/10/pic113new.png
.. |j| image:: ../_static/images/10/pic114new.png

| На этом экране отображаются все терминалы, созданные для торговца в системе:
|

.. figure:: ../_static/images/10/endnew.png
  :scale: 70 %
  :align: center
  :alt: pic102 merchant faq

|
| |i| The Endpoint is enabled.
| |j| The Endpoint is disabled.
|
| В случае большого количества Терминалов можно использовать поиск:
|

.. image:: ../_static/images/10/spnew.png
  :width: 750
  :align: center
  :alt: pic103 merchant faq

|
| Для мониторинга активности по Терминалу используются ключевые показатели эффективности (KPI), такие как заработок Торговца и другие.
| Подменю KPI открывается при нажатии кнопки :ex:`Детали` на экране поиска Терминала. Подробнее см. в :ref:`kpi`.
| Щелкните на название Терминала, чтобы открыть подробную информацию об этом Терминале.

Детали Терминалов
=================

| Экран сведений о Терминале содержит информацию о настроенных параметрах данного Терминала, его идентификаторе, лимитах и связанном проекте. Терминал наследует свою валюту от проекта, с которым он связан.
| Важно отметить, что настройки Терминала (такие как лимиты, платёжные формы, определение Клиента и т. д.) переопределяют настройки Проекта.
| Для просмотра фильтров, настроенных на Терминале, используйте вкладку "Фильтры фрод-защиты".
| Чтобы просмотреть необходимость дополнительных полей в платежной форме, воспользуйтесь вкладкой "API Поля".
| Для работы с другими параметрами конфигурации см. информацию ниже.

.. _endpoint_messages:

Шаблоны сообщений
=================

| Шаблоны сообщений можно использовать для отправки клиенту SMS-сообщений или сообщений по электронной почте после каждой успешной транзакции. Для отправки таких сообщений с адреса Торговца, Торговец должен предоставить менеджеру службы поддержки SBC свои учетные данные сервера сообщений. Шаблоны создаются с помощью кнопки :ex:`Шаблон`. Пример заполнения формы:
|

.. figure:: ../_static/images/10/shnew.png
  :scale: 50 %
  :align: center
  :alt: pic105 merchant faq

|
| Пример шаблона сообщения в форме:
|

.. image:: ../_static/images/10/engnew.png
  :width: 700
  :align: center
  :alt: pic106 merchant faq

|
| |i| Message sending is enabled.
| |j| Message sending is disabled.

.. _endpoint_forms:

Платёжная Форма
===============

На Терминале или Мастер терминале зможно настроить пользовательские платёжные формы. Для настройки см. раздел `Настройка форм <https://doc.sbctech.ru/integration/reference/forms_customization.html>`_ в интеграционной документации. Предоставьте настроенные формы менеджеру службы поддержки SBC для установки. Названия установленных форм будут видны на экране сведений о терминале.

.. _endpoint_callbacks:

Обратные вызовы
===============

Обратный вызов настраивается на уровне Терминала с помощью утилиты Создания обратного вызова. Чтобы настроить новый обратный вызов, перейдите в нижнюю часть экрана сведений Терминала и нажмите кнопку “Добавить обратный вызов”.

* Тип транзакции.
* URL-адрес — это полностью определенный URL-адрес со всеми параметрами, которые потребуются целевой странице или скрипту Торговца. Пример: https://www.merchant.com/sale_completed.
* Комментарий, если необходимо, .

|

.. image:: ../_static/images/pic68new.png
   :width: 400
   :align: center
   :alt: pic68 торговец_callback

|

.. _endpoint_bnb:

Кнопка Купить сейчас
======================

Интеграция кнопки "Купить сейчас" актуальна для Торговцев, имеющих ограниченный ассортимент товаров для продажи. Это самый простой способ интеграции с SBC. Такой способ интеграции не требует больших технических усилий. Интеграция кнопки Купить сейчас также позволяет Торговцу (или Присоеденяющейся стороне, представляющей Торговца) исключить себя из процесса хранения, обработки или передачи данных держателя карты Плательщика или других конфиденциальных платежных данных. Такие данные отправляются Плательщиком в форме сведений о клиенте, размещенной на SBC, и в платёжной форме в сертифицированной среде PCI DSS.

Настройка кнопки Купить сейчас
--------------------------------

Чтобы настроить кнопку Купить сейчас на сайте Торговца, следуйте этим инструкциям.

 • Найдите нужный Терминал;
 • Перейдите на вкладку :ex:`Товары Купить сейчас`;
 • Нажмите на :ex:`Добавить товар`;
 • Заполните обязательные поля.

Обязательные поля кнопки Купить сейчас
----------------------------------------

.. list-table::
  :widths: 20, 50, 25
  :header-rows: 1
  :class: longtable table-text-justify

  * - Название параметра
    - Описание
    - Значение
  * - :code:`Сумма`
    - Сумма к оплате. Сумма должна быть указана в наибольших единицах с разделителем :ex:`.`. Например, :ex:`10.5` для USD означает 10 долларов США и 50 центов.
    - | ``Необходимость``: Обязательно
      | ``Тип``: Numeric
      | ``Длина``: 10
  * - :code:`Описание`
    - Описание товара.
    - | ``Необходимость``: Обязательно
      | ``Тип``: String
      | ``Длина``: 64k
  * - :code:`redirect_url`
    - URL-адрес страницы, на которую будет перенаправлен плательщик после завершения транзакции.
    - | ``Необходимость``: Обязательно
      | ``Тип``: String
      | ``Длина``: 1024
  * - :code:`Пункт назначения`
    - Назначение платежа. Этот параметр полезен для торговцев, которые позволяют своим плательщикам пополнять свои счета с помощью банковской карты (счета мобильных телефонов, игровые счета и т. д.). Примеры значений: :ex:`+9999999999`; :ex:`mail@example.com` и т. д. Это значение может использоваться системой мониторинга мошенничества.
    - | ``Необходимость``: Опционально
      | ``Тип``: String
      | ``Длина``: 128
  * - :code:`Платежный инструмент`
    - Методы оплаты.
    - | ``Необходимость``: Опционально
      | ``Тип``: String
      | ``Длина``: 128

Поля платёжной формы кнопки Купить сейчас
-------------------------------------------

Чтобы настроить поля, которые будут отображаться в платежной форме, обратитесь к менеджеру службы поддержки SBC: 1. Перейдите в :ex:`API поля` на соответствующем Терминале. 2. Отметьте каждое необходимое :ex:`поле API` как :ex:`Видимое` и/или :ex:`Обязательное`. 3. Сохраните :ex:`API поля` и просмотрите платёжную форму.

.. warning::
   | Рекомендуется создавать отдельные Терминалы для кнопки "Купить сейчас", поскольку активация этой опции может привести к некорретной работе других типов интеграции. Также:
   | 1. Кнопки нельзя удалить, можно только отключить Терминал полностью, чтобы остановить транзакции с помощью кнопки Купить сейчас.
   | 2. Изменение суммы транзакции в платежной форме не будет поддерживаться, если на данном Терминале настроена какая-либо кнопка "Купить сейчас".

.. _endpoint_balances:

Баланс счёта
===============

У каждой Присоеденяющейся Стороны есть учетная запись Торговца, созданная в Платежном Шлюзе. Текущие балансы счетов Торговцев можно проверить через вкладку :ex:`Общие` на Терминалах. Балансы также можно запросить через API `по Терминалу <https://doc.sbctech.ru/integration/API_commands/api_v2_get_balance.html>`_ или `по Торговцу <https://doc.sbctech.ru/integration/API_commands/api_v2_get_balance_merchant.html>`_.

.. note:: Чтобы включить эту функцию, обратитесь в службу поддержки SBC.

Ниже приведен пример окна Терминала с текущими счетами:

.. image:: ../_static/images/get_balance/balancesendpoint.png
  :alt: balancesendpoint
  :align: center
  :width: 870