Terminal płatności Integracje

• • Tematy niniejszego dokumentu: * *

• [Wprowadzenie] (# wprowadzenie)
• [Konfiguracja] (# konfiguracja)
  • [Konfiguracja Terminal płatności Dostawca] (# configure- payment- terminal- provider)
  • [Infrastruktura podatkowa Ustalenia] (# charging- infrastruktura-konfiguracja)
  • [Taryfy roamingowe] (# roaming- taryfy)
• (# charging- session- control)

Wprowadzenie

Niniejszy dokument opisuje wymogi dotyczące konfiguracji terminala płatniczego (POS) integracja przez * *OCPI lub OICP projekt komunikacyjny * * on Tridens EV Charge.

Integracja obejmuje * * Dostawcy Terminalu Płatności (PTP) * * komunikowanie się z infrastrukturą ładowania operatorów punktów ładowania (CPO).
W niniejszym dokumencie termin * dostawca terminali płatników * jest używany jako termin techniczny i jest uważany za synonim dla terminu mniej technicznego *POS dostawca *. Usługodawca Terminalu Płatności działa jako brama do infrastruktury ładowania poprzez OCPI lub OICP protokoły pobierania opłat za kontrolę sesji i związane z nią przekazywanie danych. OCPI protokół oferuje obsługę oficjalnych terminali płatniczych. Dla OICP, hybryda koncepcja może być wykorzystana.

![OCPI topologia komunikacji dla dostawców terminali płatników.] (../payment-terminal-integration-by-ocpi.png)

• • • Rysunek 1: * * *OCPI topologia komunikacji dla dostawów terminali płatników. *

Konfiguracja

Dostawcy terminali płatniczych mogą być skonfigurowane w Tridens EV Charge środowiska lokatorów dla CPO. Poniższe instrukcje koncentrują się na OCPI protokół, ponieważ oficjalnie definiuje konfigurację terminala płatności i komunikację (standaryzowane od OCPI 2.2.1).

Konfiguracja Terminal płatności Dostawca

Konfigurowanie środowiska dla dostawcy terminali płatniczych w roamingu (PTP):

1. • • Navigate to Roaming * *
   • Przejdź do sekcji * * Roaming * * w lewym menu Tridens EV Charge deska rozdzielcza.
   • Profil roamingu w tym przypadku reprezentuje środowisko naturalne jako operator infrastruktury pobierania opłat (ładowarek) w sieci roamingu.
   • Platforma roamingu reprezentuje trzeciego dostawcy terminalu płatności.
   • Prześlij konfigurację.
2. • • Tworzenie profilu roamingu (CPO)**:
   • W zakładce * * Roaming Profiles * * należy utworzyć nowy profil lub użyć istniejącego.
   • • • Nazwa i kod * *: Przypisz nazwę i kod w celu identyfikacji profilu roamingu.
   • • • Type * *: Select * CPO * (operator punktu ładowania).
   • • • Protocol * : Select * OCPI.
   • • • Roaming ID* *: 3-uppercase-letter identifier that will represent CPO w roamingu.
   • Prześlij konfigurację.
3. • • Tworzenie platformy roamingu (PTP)**:
   • Utwórz nową platformę * * Roaming * *:
   • • • Nazwa & Kod * *: Przypisz wartości do identyfikacji platformy.
   • • • Typ * *: Wybierz * * Dostawca Terminalu Płatności (PTP)**.
   • *URL *: Wprowadź serwer back-office dostawcy terminala płatniczego URL (np., https://your-pos-provider.com/api/ocpi).
   • • • Kraj * *: Wybierz kraj pochodzenia dostawcy terminali płatniczych.
   • • • Inicjacja połączenia * *: Wybierz, która strona rozpocznie OCPI połączenie za pomocą symbolu rejestracyjnego.
   • • • Kredyty giełdowe (Token) * *:
     • Jeśli * *PTP dostarcza żeton * *: Wybierz “Użyję tokena dostarczonego przez mojego partnera w roamingu” i wprowadź tokena w polu.
     • Jeśli * *CPO dostarcza żeton * *: Wybierz “I will provide token to my voiling partner” i kliknij * * Generate * *. Udostępnij wygenerowany token i połączenie URL z dostawcą terminalu płatniczego.
4. • • Rejestracja * *:
   • Komunikacja musi być zainicjowana poprzez rejestrację.
   • • • Dokumenty rejestracyjne * *
     • Jeśli użyłeś symbolu partnera, kliknij “Zarejestruj się” na wybranej platformie roamingu.
     • Jeśli podałeś token, dostawca terminali płatniczych musi zainicjować rejestrację.
   • • • Aktualizuj zasługi * *: Użyj “Aktualizuj referencje” do renegocjacji referencji w razie potrzeby.
   • • • Invalidate Credities * *: Użyj “Invalidate references”, aby zatrzymać komunikację / integrację.

![OCPI sekwencja operacyjna.] (../sequence-ocpi.png)

• • • Rysunek 2: * * *OCPI sekwencja komunikacyjna. *

Infrastruktura ładowania Ustawienia

Raz CPO oraz PTP komunikacji, dostawca terminalu płatności może pobrać CPOinfrastruktura ładowania (lokalizacje, EVSE, połączenia). W CPO muszą popularyzować określone atrybuty roamingu w celu ujawnienia infrastruktury:

• • • Area * *: Populuj roaming id z niepowtarzalnym identyfikatorem i phone number.
• • • Charger * *: Populuj roaming id z niepowtarzalnym identyfikatorem i oznaczyć roaming atrybut * * własny * *.
• • • Connector * *: Populuj roaming id z niepowtarzalnym identyfikatorem.

Lokalizacje i infrastruktura ładowania są zgłaszane dostawcy terminali płatniczych (tryb push) i mogą być również pobrane (tryb pull).

Taryfy roamingowe

Jako operator punktów poboru opłat, możesz chcieć przypisać taryfy roamingowe do reprezentowania cen sesji inicjowanych przez dostawców terminali płatniczych (PTP). Utwórz [Taryfa roamingowa] (../../roaming/roaming_tariffs.md) w przypadku płatności ad hoc z pożądanymi cenami energii i czasu, w tym podatków. Taryfa zawiera również maksymalną kwotę za zezwolenie na płatność sesji pobierania opłat.

• • Ważne uwagi: * *

• Taryfy roamingowe obliczają koszty, które dostawca terminalu płatniczego musi zapłacić operatorowi punktu ładowania.
• Ceny te niekoniecznie są tym, za co płaci klient końcowy (kierowca EV).

• • Wytyczne dotyczące konfiguracji: * *

1. • • Create Roaming Taryfa * *:
   • Nawigacja do * * Roaming * * - > * * Roaming Tariffs * *.
   • Dodaj nową taryfę z * * Nazwa * * i * * Kod * *.
   • Ustaw * * Status * * na * Aktywne * i zdefiniuj zakres czasu ważności.
   • Prześlij do stworzenia definicji taryfy.
2. • • Dodaj szczegóły taryfowe * *:
   • W ramach taryfy dodaj * * Szczegóły taryfowe * *.
   • • • Recurrency * *: Select * Raz * lub * Codziennie * returning.
   • • • Priorytet * *: Wyższe szczegóły priorytetów nadrabiają niższe, jeśli ramy czasowe pokrywają się.
   • • • Time Frame * *: Determinate the * * inclusive start date - time * * and * * wymyślny czas zatrzymania * *. Wybierz dni, w których obowiązuje szczegół taryfowy.
   • • • Pricing * *: Ustaw cenę i procent VAT dla wskaźników ratingowych (energia, czas ładowania, czas parkowania, mieszkanie, czas rezerwacji itp.). Puste pola traktowane są jako zero.
   • Prześlij konfigurację.
3. • • Przypisanie taryfy platformie roamingu (PTP)**:
   • Wróć do * * Roaming * * - > [* * Roaming Platform * *] (../../roaming/roaming_platform.md).
   • Edytuj specjalną platformę roamingu dla wcześniej skonfigurowanego dostawcy terminali płatniczych.
   • W asystencie konfiguracji (zazwyczaj krok 1) przypisz * * [Taryfa roamingowa] (../../roaming/roaming_tariffs.md)**.
   • Prześlij konfigurację.
4. • • Przypisanie taryfy do infrastruktury ładowania * *:
   • Przejdź do każdego poziomu infrastruktury ładowania o [Ustawienia sesji] (../../sessions/#session-rating-settings) (zwany również * * Session Rating Profile * *), który jest przypisany do infrastruktury ładowania na różnych poziomach.
   • Przypisz * * taryfę roamingową * * dla pożądanego poziomu zakresu:
     • • • Site * *
     • / Operator
     • • • Charger * *
   • Prześlij konfigurację.

Po skonfigurowaniu, * * nowe sesje pobierania opłat * * związane z tym dostawcą terminali płatniczych będą miały koszty obliczone na podstawie tych ustawień. Taryfy są zgłaszane dostawcy terminali płatniczych (tryb push) i mogą być pobierane (tryb pull).

Kontrola ładowania sesji

Operacje, za pomocą których dostawca terminalu płatniczego może zwrócić się do operatora punktów ładowania o: Tridens EV Charge zarządzanie sesją pobierania opłat:

• Zdalny start sesji
• Zdalne zatrzymanie sesji

Rezultaty i pośrednie działania sesyjne pobierania opłat są przekazywane dostawcy terminalu płatności przez API:

• Początek sesji
• Aktualizacja sesji
• Koniec sesji
• Zmiany stanu infrastruktury obciążającej
• Sprawozdanie dotyczące konsumpcji końcowej

Postęp sesji jest zgłaszany dostawcy terminala płatności (tryb push) i może być również pobrany (tryb pull).