Zahlungsterminal-Integrationen

Themen in diesem Dokument:

• Einführung
• Konfiguration
  • Zahlungsterminal-Anbieter konfigurieren
  • Einrichtung der Ladeinfrastruktur
  • Roaming-Tarife
• Steuerung der Ladesitzung

Einführung

Dieses Dokument beschreibt die Einrichtungsanforderungen für die Integration von Zahlungsterminals (POS - Point of sale) über OCPI oder OICP Kommunikationsprotokolle auf Tridens EV Charge.

Die Integration beinhaltet die Kommunikation von Zahlungsterminal-Anbietern (PTP - Payment terminal provider) mit der Ladeinfrastruktur von Ladepunktbetreibern (CPO - Charge point operator). In diesem Dokument wird der Begriff Zahlungsterminal-Anbieter als technischer Begriff verwendet und gilt als Synonym für den weniger technischen Begriff POS-Anbieter. Der Zahlungsterminal-Anbieter fungiert als Gateway zur Ladeinfrastruktur über OCPI (Open charge point interface) oder OICP (Open interCharge protocol) Protokolle zur Steuerung der Ladesitzung und den damit verbundenen Datentransfer. Das OCPI-Protokoll bietet offizielle Unterstützung für Zahlungsterminals. Für OICP kann ein hybrides Konzept genutzt werden.

Abbildung 1: OCPI-Kommunikationstopologie für Zahlungsterminal-Anbieter.

Konfiguration

Zahlungsterminal-Anbieter können in Tridens EV Charge Mandantenumgebungen für CPOs konfiguriert werden. Die folgenden Anweisungen konzentrieren sich auf das OCPI-Protokoll, da es offiziell die Einrichtung und Kommunikation von Zahlungsterminals definiert (standardisiert seit OCPI 2.2.1).

Zahlungsterminal-Anbieter konfigurieren

Um die Umgebung für einen Roaming-Zahlungsterminal-Anbieter (PTP) zu konfigurieren:

1. Zu Roaming navigieren:

   • Gehen Sie zum Abschnitt Roaming im Menü auf der linken Seite des Tridens EV Charge Dashboards.
   • Das Roaming-Profil stellt in diesem Fall die Umgebung als Betreiber der Ladeinfrastruktur (Ladegeräte) im Roaming-Netzwerk dar.
   • Die Roaming-Plattform repräsentiert hier den Drittanbieter von Zahlungsterminals.
   • Konfiguration absenden.

2. Roaming-Profil erstellen (CPO):

   • Erstellen Sie auf dem Reiter Roaming Profiles ein neues Profil oder verwenden Sie ein vorhandenes.
   • Name & Code: Weisen Sie einen Namen und einen Code zu, um das Roaming-Profil zu identifizieren.
   • Type: Wählen Sie CPO (Ladepunktbetreiber).
   • Protocol: Wählen Sie OCPI.
   • Roaming ID: Kennung aus drei Großbuchstaben, die den CPO im Roaming repräsentieren wird.
   • Konfiguration absenden.

3. Roaming-Plattform erstellen (PTP):

   • Erstellen Sie eine neue Roaming Platform:
   • Name & Code: Weisen Sie Werte zu, um die Plattform zu identifizieren.
   • Type: Wählen Sie Payment Terminal Provider (PTP).
   • URL: Geben Sie die Back-Office-Server-URL des Zahlungsterminal-Anbieters ein (z. B. https://your-pos-provider.com/api/ocpi).
   • Country: Wählen Sie das Herkunftsland des Zahlungsterminal-Anbieters.
   • Connection Initiation: Wählen Sie, welche Seite die OCPI-Verbindung unter Verwendung des Registrierungstokens initiieren wird.
   • Credentials Exchange (Token):
     • Wenn PTP das Token bereitstellt: Wählen Sie „I will use token provided by my roaming partner“ und geben Sie das Token in das Feld ein.
     • Wenn CPO das Token bereitstellt: Wählen Sie „I will provide token to my roaming partner“ und klicken Sie auf Generate. Teilen Sie das generierte Token und Ihre Verbindungs-URL dem Zahlungsterminal-Anbieter mit.

4. Registrierung:

   • Die Kommunikation muss über die Registrierung initiiert werden.
   • Register credentials
     • Wenn Sie das Token des Partners verwendet haben, klicken Sie auf der ausgewählten Roaming-Plattform auf „Register credentials“.
     • Wenn Sie das Token bereitgestellt haben, muss der Zahlungsterminal-Anbieter die Registrierung initiieren.
   • Update Credentials: Verwenden Sie „Update credentials“, um Anmeldeinformationen bei Bedarf neu auszuhandeln.
   • Invalidate Credentials: Verwenden Sie „Invalidate credentials“, um die Kommunikation/Integration zu stoppen.

Abbildung 2: OCPI-Kommunikationssequenz.

Einrichtung der Ladeinfrastruktur

Sobald CPO und PTP kommunizieren, kann der Zahlungsterminal-Anbieter die Ladeinfrastruktur des CPO (Standorte, EVSEs (Electric vehicle supply equipment), Anschlüsse) abrufen. Der CPO muss spezifische Roaming-Attribute füllen, um die Infrastruktur offenzulegen:

• Area: Füllen Sie die roaming id mit einer eindeutigen Kennung und der phone number.
• Charger: Füllen Sie die roaming id mit einer eindeutigen Kennung und markieren Sie das Attribut roaming als enabled.
• Connector: Füllen Sie die roaming id mit einer eindeutigen Kennung.

Standorte und Ladeinfrastruktur werden an den Zahlungsterminal-Anbieter gemeldet (Push-Modus) und können auch abgerufen werden (Pull-Modus).

Roaming-Tarife

Als Ladepunktbetreiber möchten Sie möglicherweise Roaming-Tarife zuweisen, um Preise für Sitzungen darzustellen, die von Zahlungsterminal-Anbietern (PTP) initiiert wurden. Richten Sie den Roaming Tariff für Ad-hoc-Zahlungen mit den gewünschten Preisen für Energie und Zeit ein, einschließlich Steuern. Der Tarif enthält auch den maximalen Betrag für die Zahlungsautorisierung der Ladesitzung.

Wichtige Hinweise:

• Roaming-Tarife berechnen die Ausgaben, die der Zahlungsterminal-Anbieter an den Ladepunktbetreiber zahlen muss.
• Diese Preise sind nicht unbedingt das, was der Endkunde (EV-Fahrer) zahlt.

Konfigurationsrichtlinien:

1. Roaming-Tarif erstellen:

   • Navigieren Sie zu Roaming -> Roaming Tariffs.
   • Fügen Sie einen neuen Tarif mit einem Name und Code hinzu.
   • Setzen Sie Status auf Active und definieren Sie den Gültigkeitszeitraum.
   • Senden Sie ab, um die Tarifdefinition zu erstellen.

2. Tarifdetails hinzufügen:

   • Fügen Sie innerhalb des Tarifs Tariff Details hinzu.
   • Recurrency: Wählen Sie One-time oder Daily wiederkehrend.
   • Priority: Details mit höherer Priorität überschreiben niedrigere, wenn sich Zeitrahmen überschneiden.
   • Time Frame: Bestimmen Sie das inklusive Startdatum/-zeit und das exklusive Stoppdatum/-zeit. Wählen Sie aus, an welchen Tagen das Tarifdetail gilt.
   • Pricing: Legen Sie den Preis und den Mehrwertsteuersatz für Bewertungsmetriken fest (Energie, Ladezeit, Parkzeit, Pauschale, Reservierungszeit usw.). Leere Felder werden als Null behandelt.
   • Senden Sie die Konfiguration ab.

3. Tarif der Roaming-Plattform (PTP) zuweisen:

   • Navigieren Sie zurück zu Roaming -> Roaming Platforms.
   • Bearbeiten Sie die spezifische Roaming-Plattform für den zuvor konfigurierten Zahlungsterminal-Anbieter.
   • Im Einrichtungsassistenten (normalerweise Schritt 1) weisen Sie den Roaming Tariff zu.
   • Senden Sie die Konfiguration ab.

4. Tarif der Ladeinfrastruktur zuweisen:

   • Navigieren Sie zu einer beliebigen Ebene der Ladeinfrastruktur, die die Session Settings (auch als Session Rating Profile bezeichnet) hat, die der Ladeinfrastruktur auf verschiedenen Ebenen zugewiesen ist.
   • Weisen Sie den Roaming Tariff für die gewünschte Umfangsebene zu:
     • Site
     • Operator
     • Charger
   • Senden Sie die Konfiguration ab.

Sobald konfiguriert, werden für neue Ladesitzungen, die sich auf diesen Zahlungsterminal-Anbieter beziehen, Kosten basierend auf diesen Einstellungen berechnet. Tarife werden an den Zahlungsterminal-Anbieter gemeldet (Push-Modus) und können auch abgerufen werden (Pull-Modus).

Steuerung der Ladesitzung

Operationen, mit denen der Zahlungsterminal-Anbieter den Ladepunktbetreiber von Tridens EV Charge auffordern kann, die Ladesitzung zu verwalten:

• Fernstart der Sitzung
• Fernstopp der Sitzung

Resultierende und zwischenzeitliche Ladesitzungsaktionen werden per API an den Zahlungsterminal-Anbieter zurückgeleitet:

• Sitzungsstart
• Sitzungsaktualisierung
• Sitzungsende
• Statusänderungen der Ladeinfrastruktur
• Endgültiger Verbrauchsbericht

Der Sitzungsfortschritt wird an den Zahlungsterminal-Anbieter gemeldet (Push-Modus) und kann auch abgerufen werden (Pull-Modus).