Integracije plačilnih terminalov

Teme v tem dokumentu:

• Uvod
• Konfiguracija
  • Konfiguracija ponudnika plačilnih terminalov
  • Nastavitev polnilne infrastrukture
  • Tarife gostovanja
• Nadzor polnilne seje

Uvod

Ta dokument opisuje zahteve za namestitev integracije plačilnega terminala (POS - ang. Point of sale) prek komunikacijskih protokolov OCPI ali OICP na Tridens EV Charge.

Integracija vključuje komunikacijo ponudnikov plačilnih terminalov (PTP - ang. Payment terminal provider) s polnilno infrastrukturo operaterjev polnilnih mest (CPO - ang. Charge point operator). V tem dokumentu se izraz ponudnik plačilnih terminalov uporablja kot tehnični izraz in se šteje za sinonim manj tehničnega izraza ponudnik POS. Ponudnik plačilnih terminalov deluje kot prehod do polnilne infrastrukture prek protokolov OCPI (ang. Open charge point interface) ali OICP (ang. Open interCharge protocol) za nadzor polnilne seje in s tem povezan prenos podatkov. Protokol OCPI ponuja uradno podporo za plačilne terminale. Za OICP se lahko uporabi hibridni koncept.

Slika 1: Topologija komunikacije OCPI za ponudnike plačilnih terminalov.

Konfiguracija

Ponudnike plačilnih terminalov je mogoče konfigurirati v najemniških okoljih Tridens EV Charge za CPO-je. Naslednja navodila se osredotočajo na protokol OCPI, saj uradno opredeljuje nastavitev in komunikacijo plačilnega terminala (standardizirano od OCPI 2.2.1).

Konfiguracija ponudnika plačilnih terminalov

Za konfiguracijo okolja za ponudnika plačilnih terminalov (PTP) v gostovanju:

1. Navigacija do gostovanja:

   • Pojdite na razdelek Gostovanje v meniju na levi strani nadzorne plošče Tridens EV Charge.
   • Profil gostovanja v tem primeru predstavlja okolje kot operaterja polnilne infrastrukture (polnilnikov) v omrežju gostovanja.
   • Platforma gostovanja tukaj predstavlja tretjega ponudnika plačilnih terminalov.
   • Oddajte konfiguracijo.

2. Ustvari profil gostovanja (CPO):

   • Na zavihku Roaming Profiles ustvarite nov profil ali uporabite obstoječega.
   • Name & Code: Dodelite ime in kodo za identifikacijo profila gostovanja.
   • Type: Izberite CPO (operater polnilnega mesta).
   • Protocol: Izberite OCPI.
   • Roaming ID: Identifikator iz treh velikih črk, ki bo predstavljal CPO v gostovanju.
   • Oddajte konfiguracijo.

3. Ustvari platformo gostovanja (PTP):

   • Ustvarite novo Roaming Platform:
   • Name & Code: Dodelite vrednosti za identifikacijo platforme.
   • Type: Izberite Payment Terminal Provider (PTP).
   • URL: Vnesite URL strežnika zaledne pisarne ponudnika plačilnih terminalov (npr. https://your-pos-provider.com/api/ocpi).
   • Country: Izberite izvorno državo ponudnika plačilnih terminalov.
   • Connection Initiation: Izberite, katera stran bo začela povezavo OCPI z uporabo registracijskega žetona.
   • Credentials Exchange (Token):
     • Če PTP zagotovi žeton: Izberite “I will use token provided by my roaming partner” in vnesite žeton v polje.
     • Če CPO zagotovi žeton: Izberite “I will provide token to my roaming partner” in kliknite Generate. Delite ustvarjen žeton in vaš URL povezave s ponudnikom plačilnih terminalov.

4. Registracija:

   • Komunikacija se mora začeti prek registracije.
   • Register credentials
     • Če ste uporabili partnerjev žeton, kliknite “Register credentials” na izbrani platformi gostovanja.
     • Če ste zagotovili žeton, mora registracijo začeti ponudnik plačilnih terminalov.
   • Update Credentials: Uporabite “Update credentials” za ponovno pogajanje o poverilnicah, če je potrebno.
   • Invalidate Credentials: Uporabite “Invalidate credentials” za ustavitev komunikacije/integracije.

Slika 2: Zaporedje komunikacije OCPI.

Nastavitev polnilne infrastrukture

Ko CPO in PTP komunicirata, lahko ponudnik plačilnih terminalov pridobi polnilno infrastrukturo CPO (Lokacije, EVSE (ang. Electric vehicle supply equipment), Priključki). CPO mora izpolniti posebne atribute gostovanja, da izpostavi infrastrukturo:

• Area: Izpolnite roaming id z edinstvenim identifikatorjem in phone number.
• Charger: Izpolnite roaming id z edinstvenim identifikatorjem in označite atribut roaming kot enabled.
• Connector: Izpolnite roaming id z edinstvenim identifikatorjem.

Lokacije in polnilna infrastruktura se poročajo ponudniku plačilnih terminalov (način potiskanja) in jih je mogoče tudi pridobiti (način vlečenja).

Tarife gostovanja

Kot operater polnilnega mesta boste morda želeli dodeliti tarife gostovanja za predstavitev cen za seje, ki jih začnejo ponudniki plačilnih terminalov (PTP). Nastavite Roaming Tariff za ad-hoc plačila z želenimi cenami za energijo in čas, vključno z davki. Tarifa vsebuje tudi najvišji znesek za avtorizacijo plačila polnilne seje.

Pomembne opombe:

• Tarife gostovanja izračunajo stroške, ki jih mora ponudnik plačilnih terminalov plačati operaterju polnilnega mesta.
• Te cene niso nujno tiste, ki jih plača končni kupec (voznik EV (ang. Electric vehicle)).

Smernice za konfiguracijo:

1. Ustvari tarifo gostovanja:

   • Navigirajte na Gostovanje -> Roaming Tariffs.
   • Dodajte novo tarifo z Name in Code.
   • Nastavite Status na Active in določite časovni obseg veljavnosti.
   • Oddajte za ustvarjanje definicije tarife.

2. Dodaj podrobnosti tarife:

   • Znotraj tarife dodajte Tariff Details.
   • Recurrency: Izberite One-time ali Daily ponavljajoče.
   • Priority: Podrobnosti z višjo prioriteto preglasijo nižje, če se časovni okviri prekrivajo.
   • Time Frame: Določite vključujoč datum-čas začetka in izključujoč datum-čas konca. Izberite, v katerih dneh velja podrobnost tarife.
   • Pricing: Določite ceno in odstotek DDV za metrike ocenjevanja (energija, čas polnjenja, čas parkiranja, pavšal, čas rezervacije itd.). Prazna polja se obravnavajo kot nič.
   • Oddajte konfiguracijo.

3. Dodeli tarifo platformi gostovanja (PTP):

   • Navigirajte nazaj na Gostovanje -> Roaming Platforms.
   • Uredite specifično platformo gostovanja za predhodno konfiguriranega ponudnika plačilnih terminalov.
   • V čarovniku za namestitev (običajno 1. korak) dodelite Roaming Tariff.
   • Oddajte konfiguracijo.

4. Dodeli tarifo polnilni infrastrukturi:

   • Navigirajte na katero koli raven polnilne infrastrukture, ki ima Session Settings (imenovano tudi Session Rating Profile), ki je dodeljena polnilni infrastrukturi na različnih ravneh.
   • Dodelite Roaming Tariff za želeno raven obsega:
     • Site
     • Operator
     • Charger
   • Oddajte konfiguracijo.

Ko je konfigurirano, bodo za nove polnilne seje, povezane s tem ponudnikom plačilnih terminalov, stroški izračunani na podlagi teh nastavitev. Tarife se poročajo ponudniku plačilnih terminalov (način potiskanja) in jih je mogoče tudi pridobiti (način vlečenja).

Nadzor polnilne seje

Operacije, s katerimi lahko ponudnik plačilnih terminalov zahteva od operaterja polnilnega mesta Tridens EV Charge upravljanje polnilne seje:

• Oddaljeni zagon seje
• Oddaljena ustavitev seje

Posledična in vmesna dejanja polnilne seje se posredujejo nazaj ponudniku plačilnih terminalov prek API-ja:

• Začetek seje
• Posodobitev seje
• Konec seje
• Spremembe statusa polnilne infrastrukture
• Končno poročilo o porabi

Napredek seje se poroča ponudniku plačilnih terminalov (način potiskanja) in ga je mogoče tudi pridobiti (način vlečenja).