Intégrations de terminaux de paiement

Sujets dans ce document :

• Introduction
• Configuration
  • Configurer le fournisseur de terminal de paiement
  • Configuration de l’infrastructure de recharge
  • Tarifs d’itinérance
• Contrôle de la session de charge

Introduction

Ce document décrit les exigences de configuration pour l’intégration du terminal de paiement (POS - Point of sale) par les protocoles de communication OCPI ou OICP sur Tridens EV Charge.

L’intégration implique des fournisseurs de terminaux de paiement (PTP - Payment terminal provider) communiquant avec l’infrastructure de recharge des opérateurs de points de charge (CPO - Charge point operator). Dans ce document, le terme fournisseur de terminal de paiement est utilisé comme terme technique et est considéré comme un synonyme du terme moins technique fournisseur POS. Le fournisseur de terminal de paiement agit comme une passerelle vers l’infrastructure de recharge via les protocoles OCPI (Open charge point interface) ou OICP (Open interCharge protocol) pour le contrôle de la session de charge et le transfert de données connexe. Le protocole OCPI offre une prise en charge officielle des terminaux de paiement. Pour OICP, un concept hybride peut être utilisé.

Figure 1 : Topologie de communication OCPI pour les fournisseurs de terminaux de paiement.

Configuration

Les fournisseurs de terminaux de paiement peuvent être configurés dans les environnements locataires Tridens EV Charge pour les CPO. Les instructions suivantes se concentrent sur le protocole OCPI, car il définit officiellement la configuration et la communication du terminal de paiement (normalisé depuis OCPI 2.2.1).

Configurer le fournisseur de terminal de paiement

Pour configurer l’environnement pour un fournisseur de terminal de paiement (PTP) en itinérance :

1. Naviguer vers l’itinérance :

   • Allez dans la section Itinérance dans le menu de gauche du tableau de bord Tridens EV Charge.
   • Le profil d’itinérance représente dans ce cas l’environnement en tant qu’opérateur de l’infrastructure de recharge (chargeurs) dans le réseau d’itinérance.
   • La plateforme d’itinérance représente ici le fournisseur tiers de terminal de paiement.
   • Soumettez la configuration.

2. Créer un profil d’itinérance (CPO) :

   • Sur l’onglet Roaming Profiles, créez un nouveau profil ou utilisez-en un existant.
   • Name & Code : Attribuez un nom et un code pour identifier le profil d’itinérance.
   • Type : Sélectionnez CPO (opérateur de point de charge).
   • Protocol : Sélectionnez OCPI.
   • Roaming ID : Identifiant à trois lettres majuscules qui représentera le CPO en itinérance.
   • Soumettez la configuration.

3. Créer une plateforme d’itinérance (PTP) :

   • Créez une nouvelle Roaming Platform :
   • Name & Code : Attribuez des valeurs pour identifier la plateforme.
   • Type : Sélectionnez Payment Terminal Provider (PTP).
   • URL : Entrez l’URL du serveur back-office du fournisseur de terminal de paiement (par exemple, https://your-pos-provider.com/api/ocpi).
   • Country : Sélectionnez le pays d’origine du fournisseur de terminal de paiement.
   • Connection Initiation : Sélectionnez quel côté initiera la connexion OCPI en utilisant le jeton d’enregistrement.
   • Credentials Exchange (Token) :
     • Si PTP fournit le jeton : Sélectionnez « I will use token provided by my roaming partner » et entrez le jeton dans le champ.
     • Si CPO fournit le jeton : Sélectionnez « I will provide token to my roaming partner » et cliquez sur Generate. Partagez le jeton généré et votre URL de connexion avec le fournisseur de terminal de paiement.

4. Enregistrement :

   • La communication doit être initiée via l’enregistrement.
   • Register credentials
     • Si vous avez utilisé le jeton du partenaire, cliquez sur « Register credentials » sur la plateforme d’itinérance sélectionnée.
     • Si vous avez fourni le jeton, le fournisseur de terminal de paiement doit initier l’enregistrement.
   • Update Credentials : Utilisez « Update credentials » pour renégocier les informations d’identification si nécessaire.
   • Invalidate Credentials : Utilisez « Invalidate credentials » pour arrêter la communication/intégration.

Figure 2 : Séquence de communication OCPI.

Configuration de l’infrastructure de recharge

Une fois que le CPO et le PTP communiquent, le fournisseur de terminal de paiement peut récupérer l’infrastructure de recharge du CPO (Emplacements, EVSE (Electric vehicle supply equipment), Connecteurs). Le CPO doit remplir des attributs d’itinérance spécifiques pour exposer l’infrastructure :

• Area : Remplissez l’roaming id avec un identifiant unique et le phone number.
• Charger : Remplissez l’roaming id avec un identifiant unique et marquez l’attribut roaming comme enabled.
• Connector : Remplissez l’roaming id avec un identifiant unique.

Les emplacements et l’infrastructure de recharge sont signalés au fournisseur de terminal de paiement (mode push) et peuvent également être récupérés (mode pull).

Tarifs d’itinérance

En tant qu’opérateur de point de charge, vous voudrez peut-être attribuer des tarifs d’itinérance pour représenter les prix des sessions initiées par les fournisseurs de terminaux de paiement (PTP). Configurez le Roaming Tariff pour les paiements ad hoc avec les prix souhaités pour l’énergie et le temps, taxes incluses. Le tarif contient également le montant maximum pour l’autorisation de paiement de la session de charge.

Remarques importantes :

• Les tarifs d’itinérance calculent les dépenses que le fournisseur de terminal de paiement doit payer à l’opérateur de point de charge.
• Ces prix ne sont pas nécessairement ce que le client final (conducteur de VE) paie.

Directives de configuration :

1. Créer un tarif d’itinérance :

   • Naviguez vers Itinérance -> Roaming Tariffs.
   • Ajoutez un nouveau tarif avec un Name et un Code.
   • Définissez Status sur Active et définissez la plage de temps de validité.
   • Soumettez pour créer la définition du tarif.

2. Ajouter des détails tarifaires :

   • À l’intérieur du tarif, ajoutez Tariff Details.
   • Recurrency : Sélectionnez One-time ou Daily récurrent.
   • Priority : Les détails de priorité plus élevée remplacent les plus bas si les délais se chevauchent.
   • Time Frame : Déterminez la date-heure de début inclusive et la date-heure de fin exclusive. Sélectionnez les jours auxquels le détail tarifaire s’applique.
   • Pricing : Définissez le prix et le pourcentage de TVA pour les métriques d’évaluation (énergie, temps de charge, temps de stationnement, forfait, temps de réservation, etc.). Les champs vides sont traités comme zéro.
   • Soumettez la configuration.

3. Attribuer le tarif à la plateforme d’itinérance (PTP) :

   • Naviguez de nouveau vers Itinérance -> Roaming Platforms.
   • Modifiez la plateforme d’itinérance spécifique pour le fournisseur de terminal de paiement configuré précédemment.
   • Dans l’assistant de configuration (généralement l’étape 1), attribuez le Roaming Tariff.
   • Soumettez la configuration.

4. Attribuer le tarif à l’infrastructure de recharge :

   • Naviguez vers n’importe quel niveau d’infrastructure de recharge ayant les Session Settings (également appelés Session Rating Profile), qui est attribué à l’infrastructure de recharge à différents niveaux.
   • Attribuez le Roaming Tariff pour le niveau de portée souhaité :
     • Site
     • Operator
     • Charger
   • Soumettez la configuration.

Une fois configuré, les nouvelles sessions de charge liées à ce fournisseur de terminal de paiement auront des coûts calculés en fonction de ces paramètres. Les tarifs sont signalés au fournisseur de terminal de paiement (mode push) et peuvent également être récupérés (mode pull).

Contrôle de la session de charge

Opérations par lesquelles le fournisseur de terminal de paiement peut demander à l’opérateur de point de charge de Tridens EV Charge de gérer la session de charge :

• Démarrage de session à distance
• Arrêt de session à distance

Les actions de session de charge résultantes et intermédiaires sont renvoyées au fournisseur de terminal de paiement par API :

• Démarrage de session
• Mise à jour de session
• Fin de session
• Changements de statut de l’infrastructure de recharge
• Rapport de consommation final

La progression de la session est signalée au fournisseur de terminal de paiement (mode push) et peut également être récupérée (mode pull).