Интеграция платежных терминалов

Темы в этом документе:

• Введение
• Конфигурация
• Настроить поставщика платежных терминалов
• Настройка инфраструктуры зарядки
• Тарифы на роуминг
• Управление сеансом зарядки

Введение

В этом документе описаны требования к настройке для интеграции платежного терминала (POS (Point of Sale)) по протоколам связи OCPI (Open Charge Point Interface) или OICP (Open InterCharge Protocol) на Tridens EV Charge.

Интеграция предполагает взаимодействие Поставщиков платежных терминалов (PTP) с инфраструктурой зарядки операторов пунктов оплаты (CPO (Charge Point Operator)).
В этом документе термин поставщик платежных терминалов используется как технический термин и считается синонимом менее технического термина поставщик POS. Поставщик платежных терминалов действует как шлюз к инфраструктуре взимания платы через протоколы OCPI или OICP для управления сеансом взимания платы и соответствующей передачи данных. Протокол OCPI предлагает официальную поддержку платежных терминалов. Для OICP можно использовать гибридную концепцию.

Рисунок 1: Топология связи OCPI для поставщиков платежных терминалов.

Конфигурация

Поставщиков платежных терминалов можно настроить в клиентских средах Tridens EV Charge для CPO. Следующие инструкции посвящены протоколу OCPI, поскольку он официально определяет настройку и связь платежного терминала (стандартизирован начиная с OCPI 2.2.1).

Настройка поставщика платежных терминалов

Чтобы настроить среду для роумингового поставщика платежных терминалов (PTP):

1. ХЗХ5ХЗХ:

   • Перейдите в раздел Roaming в левом меню приборной панели Tridens EV Charge.
   • Профиль роуминга в данном случае представляет собой среду оператора зарядной инфраструктуры (зарядных устройств) в роуминговой сети.
   • Роуминговая платформа здесь представляет стороннего поставщика платежных терминалов.
   • Отправьте конфигурацию.

2. Создать роуминговый профиль (CPO):

   • На вкладке Roaming Profiles создайте новый профиль или используйте существующий.
   • Имя и код: назначьте имя и код для идентификации роумингового профиля.
   • Type: выберите CPO (оператор пункта зарядки).
   • Protocol: выберите OCPI.
   • Roaming ID (Identifier): идентификатор из трех заглавных букв, который будет обозначать CPO в роуминге.
   • Отправьте конфигурацию.

3. Создать платформу роуминга (PTP):

   • Создайте новый Roaming Platform:
   • Имя и код: назначьте значения для идентификации платформы.
   • Type: выберите Поставщик платежного терминала (PTP).
   • URL (Uniform Resource Locator): введите URL-адрес сервера бэк-офиса провайдера платежного терминала (например, https://your-pos-provider.com/api/ocpi).
   • Country: выберите страну происхождения поставщика платежного терминала.
   • Connection Initiation: выберите, какая сторона будет инициировать соединение OCPI с использованием регистрационного токена.
   • Обмен учетными данными (токен):
     • Если PTP предоставляет токен: выберите «Я буду использовать токен, предоставленный моим партнером по роумингу» и введите токен в поле.
     • Если CPO предоставляет токен: выберите «Я предоставлю токен своему партнеру по роумингу» и нажмите Generate. Поделитесь сгенерированным токеном и URL-адресом вашего подключения с поставщиком платежного терминала.

4. ХЗХ5ХЗХ:

   • Общение должно быть инициировано посредством регистрации.
   • Регистрация учетных данных
     • Если вы использовали токен партнера, нажмите «Зарегистрировать учетные данные» на выбранной Роуминговой платформе.
     • Если вы предоставили токен, провайдер платежного терминала должен инициировать регистрацию.
   • Update Credentials: используйте «Обновить учетные данные», чтобы при необходимости изменить учетные данные.
   • Invalidate Credentials: используйте «Недействительные учетные данные», чтобы прекратить связь/интеграцию.

Рисунок 2: Последовательность связи OCPI.

Настройка инфраструктуры зарядки

Как только CPO и PTP обмениваются данными, поставщик платежных терминалов может получить данные об инфраструктуре зарядки CPO (местоположения, EVSE (Electric Vehicle Supply Equipment), соединители). CPO должен заполнить определенные атрибуты роуминга, чтобы раскрыть инфраструктуру:

• Area: заполните roaming id уникальным идентификатором и phone number.
• Charger: заполните поле roaming id уникальным идентификатором и отметьте атрибут roaming как включенный.
• Connector: заполните roaming id уникальным идентификатором.

Местоположение и инфраструктура зарядки передаются поставщику платежных терминалов (режим push), а также могут быть получены (режим pull).

Тарифы на роуминг

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

Важные примечания:

• Тарифы на роуминг рассчитывают расходы, которые провайдер платежного терминала должен оплатить оператору пункта оплаты.
• Эти цены не обязательно совпадают с ценами, которые платит конечный потребитель (водитель электромобиля).

Рекомендации по настройке:

1. ХЗХ5ХЗХ:

   • Перейдите к Roaming -> Roaming Tariffs.
   • Добавить новый тариф с Name и Code.
   • Установите для Status значение Активно и определите диапазон времени действия.
   • Отправить, чтобы создать определение тарифа.

2. ХЗХ5ХЗХ:

   • Внутри тарифа добавьте Tariff Details.
   • Recurrency: выберите Одноразовый или Ежедневный повторяющийся.
   • Priority: детали с более высоким приоритетом имеют приоритет над более низкими, если временные рамки перекрываются.
   • Time Frame: определите включительную дату и время начала и эксклюзивную дату и время окончания. Выберите, в какие дни применяется детализация тарифа.
   • Pricing: установите цену и процент НДС для показателей рейтинга (энергия, время зарядки, время парковки, квартира, время бронирования и т. д.). Пустые поля считаются нулевыми.
   • Отправьте конфигурацию.

3. Присвоение тарифа платформе роуминга (PTP):

   • Вернитесь к Roaming -> Roaming Platforms.
   • Отредактируйте конкретную Роуминговую платформу для поставщика платежных терминалов, настроенную ранее.
   • В мастере настройки (обычно это шаг 1) назначьте Тариф роуминга.
   • Отправьте конфигурацию.

4. ХЗХ5ХЗХ:

   • Перейдите на любой уровень инфраструктуры зарядки, имеющий Настройки сеанса (также называемый Session Rating Profile), который назначен инфраструктуре зарядки на разных уровнях.
   • Назначьте Roaming Tariff для желаемого уровня области действия:
     • Site
     • Operator
     • Charger
   • Отправьте конфигурацию.

После настройки стоимость новых сеансов зарядки, связанных с этим поставщиком платежных терминалов, будет рассчитываться на основе этих настроек. Тарифы передаются поставщику платежного терминала (режим push), а также могут быть получены (режим pull).

Контроль сеанса зарядки

Операции, с помощью которых поставщик платежных терминалов может запросить оператора пункта зарядки Tridens EV Charge для управления сеансом зарядки:

• Удаленный запуск сеанса
• Удаленная остановка сеанса

Результирующие и промежуточные действия сеанса начисления передаются обратно провайдеру платежного терминала через API (Application Programming Interface):

• Начало сеанса
• Обновление сеанса
• Конец сессии
• Изменение статуса зарядной инфраструктуры.
• Окончательный отчет о потреблении

О ходе сеанса сообщается поставщику платежного терминала (режим push), а также может быть получено (режим pull).