Integraciones de terminales de pago

Temas en este documento:

• Introducción
• Configuración
  • Configurar el proveedor de terminales de pago
  • Configuración de la infraestructura de carga
  • Tarifas de roaming
• Control de sesiones de carga

Introducción

Este documento describe los requisitos de configuración para la integración de terminales de pago POS (Point of Sale) mediante protocolos de comunicación OCPI (Open Charge Point Interface) o OICP (Open InterCharge Protocol) en Tridens EV Charge.

La integración implica que los PTP (Payment Terminal Providers) se comuniquen con la infraestructura de carga de los operadores de puntos de carga CPO (Charge Point Operator). En este documento, el término proveedor de terminales de pago se utiliza como un término técnico y se considera un sinónimo del término menos técnico proveedor de POS. El proveedor de terminales de pago actúa como una pasarela a la infraestructura de carga a través de los protocolos OCPI o OICP para el control de la sesión de carga y la transferencia de datos relacionados. El protocolo OCPI ofrece soporte oficial para terminales de pago. Para OICP, se puede utilizar un concepto híbrido.

Figura 1: Topología de comunicación OCPI para proveedores de terminales de pago.

Configuración

Los proveedores de terminales de pago se pueden configurar en los entornos de inquilinos de Tridens EV Charge para los CPOs. Las siguientes instrucciones se centran en el protocolo OCPI, ya que define oficialmente la configuración y comunicación de los terminales de pago (estandarizado desde OCPI 2.2.1).

Configurar el proveedor de terminales de pago

Para configurar el entorno para un proveedor de terminales de pago (PTP) de roaming:

1. Navegar a Roaming:

   • Vaya a la sección Roaming en el menú de la izquierda del panel de control de Tridens EV Charge.
   • El Roaming Profile en este caso representa el entorno como el operador de la infraestructura de carga (cargadores) en la red de roaming.
   • La Roaming Platform aquí representa al proveedor de terminales de pago de terceros.
   • Envíe la configuración.

2. Crear Roaming Profile (CPO):

   • En la pestaña Roaming Profiles, cree un nuevo perfil o utilice uno existente.
   • Name & Code: Asigne un nombre y un código para identificar el perfil de roaming.
   • Type: Seleccione CPO (charge point operator).
   • Protocol: Seleccione OCPI.
   • Roaming ID: Identificador de tres letras mayúsculas que representará al CPO en el roaming.
   • Envíe la configuración.

3. Crear Roaming Platform (PTP):

   • Cree una nueva Roaming Platform:
   • Name & Code: Asigne valores para identificar la plataforma.
   • Type: Seleccione Payment Terminal Provider (PTP).
   • URL: Introduzca la URL del servidor back-office del proveedor de terminales de pago (por ejemplo, https://your-pos-provider.com/api/ocpi).
   • Country: Seleccione el país de origen del proveedor de terminales de pago.
   • Connection Initiation: Seleccione qué lado iniciará la conexión OCPI utilizando el token de registro.
   • Credentials Exchange (Token):
     • Si el PTP proporciona el token: Seleccione “I will use token provided by my roaming partner” e introduzca el token en el campo.
     • Si el CPO proporciona el token: Seleccione “I will provide token to my roaming partner” y haga clic en Generate. Comparta el token generado y su URL de conexión con el proveedor de terminales de pago.

4. Registration:

   • La comunicación debe iniciarse mediante el registro.
   • Register credentials
     • Si utilizó el token del socio, haga clic en Register credentials en la Roaming Platform seleccionada.
     • Si usted proporcionó el token, el proveedor de terminales de pago debe iniciar el registro.
   • Update Credentials: Utilice Update credentials para renegociar las credenciales si es necesario.
   • Invalidate Credentials: Utilice Invalidate credentials para detener la comunicación/integración.

Figura 2: Secuencia de comunicación OCPI.

Configuración de la infraestructura de carga

Una vez que el CPO y el PTP se están comunicando, el proveedor de terminales de pago puede obtener la infraestructura de carga del CPO (Locations, EVSEs (Electric Vehicle Supply Equipment), Connectors). El CPO debe rellenar atributos de roaming específicos para exponer la infraestructura:

• Area: Rellene el roaming id con un identificador único y el phone number.
• Charger: Rellene el roaming id con un identificador único y marque el atributo roaming como enabled.
• Connector: Rellene el roaming id con un identificador único.

Las ubicaciones y la infraestructura de carga se informan al proveedor de terminales de pago (modo push) y también se pueden obtener (modo pull).

Tarifas de roaming

Como operador del punto de carga, es posible que desee asignar tarifas de roaming para representar los precios de las sesiones iniciadas por los proveedores de terminales de pago (PTP). Configure la Roaming Tariff para pagos ad-hoc con los precios deseados para energía y tiempo, incluyendo impuestos. La tarifa también contiene la cantidad máxima para la autorización de pago de la sesión de carga.

Notas importantes:

• Las tarifas de roaming calculan los gastos que el proveedor de terminales de pago debe pagar al operador del punto de carga.
• Estos precios no son necesariamente los que paga el cliente final (conductor de EV).

Pautas de configuración:

1. Crear Roaming Tariff:

   • Navegue a Roaming -> Roaming Tariffs.
   • Añada una nueva tarifa con un Name y Code.
   • Establezca el Status en Active y defina el rango de tiempo de validez.
   • Envíe para crear la definición de la tarifa.

2. Añadir Tariff Details:

   • Dentro de la tarifa, añada Tariff Details.
   • Recurrency: Seleccione One-time o recurrencia Daily.
   • Priority: Los detalles de mayor prioridad anulan a los de menor prioridad si los marcos de tiempo se solapan.
   • Time Frame: Determine la fecha-hora de inicio inclusiva y la fecha-hora de fin exclusiva. Seleccione en qué días se aplica el Tariff Detail.
   • Pricing: Establezca el precio y el porcentaje de IVA para las métricas de tarificación (energía, tiempo de carga, tiempo de estacionamiento, fijo, tiempo de reserva, etc.). Los campos vacíos se tratan como cero.
   • Envíe la configuración.

3. Asignar tarifa a la Roaming Platform (PTP):

   • Vuelva a Roaming -> Roaming Platforms.
   • Edite la Roaming Platform específica para el proveedor de terminales de pago configurada anteriormente.
   • En el asistente de configuración (normalmente el Paso 1), asigne la Roaming Tariff.
   • Envíe la configuración.

4. Asignar tarifa a la infraestructura de carga:

   • Navegue a cualquier nivel de infraestructura de carga que tenga los Session Settings (también conocidos como Session Rating Profile), que se asignan a la infraestructura de carga en diferentes niveles.
   • Asigne la Roaming Tariff para el nivel de ámbito deseado:
     • Site
     • Operator
     • Charger
   • Envíe la configuración.

Una vez configurado, las nuevas sesiones de carga relacionadas con este proveedor de terminales de pago tendrán costes calculados basados en estos ajustes. Las tarifas se informan al proveedor de terminales de pago (modo push) y también se pueden obtener (modo pull).

Control de sesiones de carga

Operaciones mediante las cuales el proveedor de terminales de pago puede solicitar al operador del punto de carga de Tridens EV Charge gestionar la sesión de carga:

• Inicio remoto de sesión
• Parada remota de sesión

Las acciones resultantes e intermedias de la sesión de carga se reenvían al proveedor de terminales de pago por API (Application Programming Interface):

• Inicio de sesión
• Actualización de sesión
• Fin de sesión
• Cambios de estado de la infraestructura de carga
• Informe final de consumo

El progreso de la sesión se informa al proveedor de terminales de pago (modo push) y también se puede obtener (modo pull).