Terminale di pagamento Integrations

Argomenti in questo documento:

• Introduzione -Configuration
• Configura fornitore terminale di pagamento
• Configurazione infrastruttura Charging -Roaming Tariffs
• Charging Controllo sessione

Introduzione

Questo documento descrive i requisiti di configurazione per l’integrazione del terminale di pagamento (POS (Point of Sale)) tramite**protocolli di comunicazione OCPI (Open Charge Point Interface) o OICP (Open InterCharge Protocol)**su Tridens EV Charge.

L’integrazione prevede che i**fornitori di terminali di pagamento (PTP (Point-to-Point))**comunichino con l’infrastruttura di ricarica degli operatori dei punti di ricarica (CPO (Charge Point Operator)). Nel presente documento il terminefornitore di terminali di pagamentoviene utilizzato come termine tecnico ed è considerato sinonimo del termine meno tecnicofornitore POS. Il Fornitore del terminale di pagamento funge da gateway verso l’infrastruttura di ricarica tramite protocolli OCPI o OICP per il controllo della sessione di ricarica e il relativo trasferimento dei dati. Il protocollo OCPI offre supporto per terminali di pagamento ufficiali. Per l’OICP è possibile utilizzare un concetto ibrido.

***Figura 1:***Topologia di comunicazione OCPI per fornitori di terminali di pagamento.

##Configuration

I fornitori di terminali di pagamento possono essere configurati negli ambienti tenant Tridens EV Charge per CPO. Le seguenti istruzioni si concentrano sul protocollo OCPI, poiché definisce ufficialmente la configurazione e la comunicazione del terminale di pagamento (standardizzato a partire da OCPI 2.2.1).

Configura il fornitore del terminale di pagamento

Per configurare l’ambiente per un fornitore di terminali di pagamento (PTP) in roaming:

1.Navigate to Roaming:

• Vai alla sezioneRoamingnel menu a sinistra del dashboard Tridens EV Charge.
• Roaming Profile in questo caso rappresenta l’ambiente in quanto operatore dell’infrastruttura di ricarica (caricabatterie) nella rete di roaming.
• Roaming Platform qui rappresenta il fornitore di terminali di pagamento di terze parti.
• Invia configurazione.

2.Create Roaming Profile (CPO):

• Nella schedaRoaming Profiles, crea un nuovo profilo o utilizzane uno esistente. -Nome e codice: assegna un nome e un codice per identificare il profilo roaming. -Type: SelezionareCPO(operatore punto di ricarica). -Protocol: selezionaOCPI. -Roaming ID (Identifier): identificatore di tre lettere maiuscole che rappresenterà CPO in roaming.
• Invia configurazione.

3.Create Roaming Platform (PTP):

• Create un nuovoRoaming Platform: -Nome e codice: assegna valori per identificare la piattaforma. -Type: selezionaFornitore di terminali di pagamento (PTP). -URL (Uniform Resource Locator): inserire l’URL del server di back-office del fornitore del terminale di pagamento (ad es. https://your-pos-provider.com/api/ocpi). -Country: seleziona il paese di origine del fornitore del terminale di pagamento. -Connection Initiation: seleziona quale lato avvierà la connessione OCPI utilizzando il token di registrazione. -Scambio di credenziali (token):
• SePTP fornisce il token: seleziona “Utilizzerò il token fornito dal mio partner in roaming” e inserisci il token nel campo.
• SeCPO fornisce il token: seleziona “Fornirò il token al mio partner in roaming” e fai clic suGenerate. Condividi il token generato e l’URL di connessione con il fornitore del terminale di pagamento.

4.Registration:

• La comunicazione deve essere avviata tramite la registrazione. -Registra credenziali
• Se hai utilizzato il token del partner, clicca su “Registra credenziali” sull’Roaming Platform selezionato.
• Se hai fornito il token, il fornitore del terminale di pagamento deve avviare la registrazione. -Update Credentials: utilizzare “credenziali Update” per rinegoziare le credenziali, se necessario. -Invalidate Credentials: utilizzare “Invalida credenziali” per interrompere la comunicazione/integration.

***Figura 2:***Sequenza di comunicazione OCPI.

Charging Configurazione dell’infrastruttura

Una volta che il CPO e il PTP comunicano, il fornitore del terminale di pagamento può recuperare l’infrastruttura di ricarica del CPO (località, EVSE (Electric Vehicle Supply Equipment), Connectors). Il CPO deve popolare attributi di roaming specifici per esporre l’infrastruttura:

-Area: popola roaming id con un identificatore univoco e phone number. -Charger: popola roaming id con un identificatore univoco e contrassegna l’attributo roaming comeabilitato. -Connector: popola roaming id con un identificatore univoco.

Le posizioni e l’infrastruttura di ricarica vengono comunicate al fornitore del terminale di pagamento (modalità push) e possono anche essere recuperate (modalità pull).

##Roaming Tariffs

In qualità di operatore del punto di ricarica, potresti voler assegnare tariffe di roaming per rappresentare i prezzi per le sessioni avviate dai fornitori di terminali di pagamento (PTP). Imposta Roaming Tariff per pagamenti ad hoc con i prezzi desiderati per energia e tempo, tasse incluse. La tariffa contiene anche il max. importo per l’autorizzazione al pagamento della sessione di addebito.

Note importanti:

• Le tariffe Roaming calcolano le spese che il fornitore del terminale di pagamento deve pagare all’operatore del punto di ricarica.
• Questi prezzi non corrispondono necessariamente a ciò che paga il cliente finale (conducente di veicoli elettrici).

Linee guida Configuration:

1.Create Roaming Tariff:

• Passare aRoaming->Roaming Tariffs.
• Aggiungi una nuova tariffa conNameeCode.
• ImpostareStatussuActivee definire l’intervallo di tempo di validità.
• Invia per creare la definizione tariffaria.

2.Add Tariff Details:

• All’interno della tariffa aggiungereTariff Details. -Recurrency: selezionaUna voltaoGiornalieroricorrente. -Priority: i dettagli con priorità più alta sovrascrivono quelli più bassi se gli intervalli di tempo si sovrappongono. -Time Frame: determinare ladata-ora di inizio inclusae ladata-ora di fine esclusiva. Seleziona in quali giorni si applica il dettaglio tariffa. -Pricing: imposta il prezzo e la percentuale IVA per le metriche di valutazione (energia, tempo di ricarica, tempo di parcheggio, appartamento, tempo di prenotazione, ecc.). I campi vuoti vengono trattati come zero.
• Invia la configurazione.

3.Assegna tariffa a Roaming Platform (PTP):

• Torna aRoaming-> Roaming Platforms.
• Edit il Roaming Platform specifico per il fornitore del terminale di pagamento configurato in precedenza.
• Nella configurazione guidata (solitamente il passaggio 1), assegnare**Roaming Tariff**.
• Invia la configurazione.

4.Assign Tariff to Charging Infrastructure:

• Navigare verso qualsiasi livello dell’infrastruttura di ricarica avente la Sessione Settings (noto anche comeSession Rating Profile), che è assegnata all’infrastruttura di ricarica su diversi livelli.
• AssegnareRoaming Tariffal livello di ambito desiderato: -Site -Operator -Charger
• Invia la configurazione.

Una volta configurate, lenuove sessioni di addebitorelative a questo fornitore di terminali di pagamento avranno costi calcolati in base a queste impostazioni. Le tariffe vengono comunicate al fornitore del terminale di pagamento (modalità push) e possono anche essere recuperate (modalità pull).

Charging Controllo della sessione

Operations con cui il fornitore del terminale di pagamento può richiedere all’operatore del punto di ricarica di Tridens EV Charge di gestire la sessione di ricarica:

• Avvio della sessione remota
• Interruzione della sessione remota

Le azioni risultanti e intermedie della sessione di addebito vengono inoltrate al fornitore del terminale di pagamento tramite API (Application Programming Interface):

• Inizio della sessione
• Aggiornamento della sessione
• Fine della sessione
• Modifiche allo stato dell’infrastruttura Charging
• Rapporto sui consumi finali

L’avanzamento della sessione viene segnalato al fornitore del terminale di pagamento (modalità push) e può anche essere recuperato (modalità pull).