Integrações de Terminal de Pagamento

Tópicos neste documento:

• Introdução
• Configuração
  • Configurar Provedor de Terminal de Pagamento
  • Configuração da Infraestrutura de Carregamento
  • Tarifas de Roaming
• Controle da Sessão de Carregamento

Introdução

Este documento descreve os requisitos de configuração para a integração do terminal de pagamento (POS (Point of Sale)) pelos protocolos de comunicação OCPI (Open Charge Point Interface) ou OICP (Open InterCharge Protocol) no Tridens EV Charge.

A integração envolve Payment Terminal Providers (PTP (Payment Terminal Provider)) comunicando-se com a infraestrutura de carregamento dos operadores de pontos de carregamento (CPO (Charge Point Operator)). Neste documento, o termo provedor de terminal de pagamento é usado como um termo técnico e é considerado um sinônimo para o termo menos técnico provedor de POS. O Payment Terminal Provider atua como um gateway para a infraestrutura de carregamento via protocolos OCPI (Open Charge Point Interface) ou OICP (Open InterCharge Protocol) para o controle da sessão de carregamento e transferência de dados relacionados. O protocolo OCPI oferece suporte oficial a terminais de pagamento. Para o OICP, um conceito híbrido pode ser utilizado.

Figura 1: Topologia de comunicação OCPI para provedores de terminais de pagamento.

Configuração

Os provedores de terminais de pagamento podem ser configurados nos ambientes de locatários do Tridens EV Charge para CPOs. As instruções a seguir focam no protocolo OCPI, pois ele define oficialmente a configuração e a comunicação do terminal de pagamento (padronizado desde o OCPI 2.2.1).

Configurar Provedor de Terminal de Pagamento

Para configurar o ambiente para um provedor de terminal de pagamento (PTP (Payment Terminal Provider)) em roaming:

1. Navegar para Roaming:

   • Vá para a seção Roaming no menu lateral esquerdo do painel do Tridens EV Charge.
   • O Roaming Profile neste caso representa o ambiente como o operador da infraestrutura de carregamento (carregadores) na rede de roaming.
   • A Roaming Platform aqui representa o provedor de terminal de pagamento de terceiros.
   • Envie a configuração.

2. Criar Perfil de Roaming (CPO):

   • Na aba Roaming Profiles, crie um novo perfil ou use um existente.
   • Name & Code: Atribua um nome e um código para identificar o perfil de roaming.
   • Type: Selecione CPO (Charge Point Operator).
   • Protocol: Selecione OCPI.
   • Roaming ID: Identificador de três letras maiúsculas que representará o CPO no roaming.
   • Envie a configuração.

3. Criar Plataforma de Roaming (PTP):

   • Crie uma nova Roaming Platform:
   • Name & Code: Atribua valores para identificar a plataforma.
   • Type: Selecione Payment Terminal Provider (PTP).
   • URL: Insira a URL do servidor de back-office do provedor do terminal de pagamento (ex: https://your-pos-provider.com/api/ocpi).
   • Country: Selecione o país de origem do provedor do terminal de pagamento.
   • Connection Initiation: Selecione qual lado iniciará a conexão OCPI usando o token de registro.
   • Credentials Exchange (Token):
     • Se o PTP fornecer o token: Selecione “I will use token provided by my roaming partner” e insira o token no campo.
     • Se o CPO fornecer o token: Selecione “I will provide token to my roaming partner” e clique em Generate. Compartilhe o token gerado e sua URL de conexão com o provedor do terminal de pagamento.

4. Registro:

   • A comunicação deve ser iniciada via registro.
   • Register credentials
     • Se você usou o token do parceiro, clique em “Register credentials” na Roaming Platform selecionada.
     • Se você forneceu o token, o provedor do terminal de pagamento deve iniciar o registro.
   • Update Credentials: Use “Update credentials” para renegociar as credenciais, se necessário.
   • Invalidate Credentials: Use “Invalidate credentials” para interromper a comunicação/integração.

Figura 2: Sequência de comunicação OCPI.

Configuração da Infraestrutura de Carregamento

Uma vez que o CPO e o PTP estão se comunicando, o provedor do terminal de pagamento pode buscar a infraestrutura de carregamento do CPO (Locais, EVSEs (Electric Vehicle Supply Equipment), Conectores). O CPO deve preencher atributos específicos de roaming para expor a infraestrutura:

• Area: Preencha o roaming id com um identificador exclusivo e o phone number.
• Charger: Preencha o roaming id com um identificador exclusivo e marque o atributo roaming como enabled.
• Connector: Preencha o roaming id com um identificador exclusivo.

Os locais e a infraestrutura de carregamento são relatados ao provedor do terminal de pagamento (modo push) e também podem ser buscados (modo pull).

Tarifas de Roaming

Como operador de ponto de carregamento, você pode querer atribuir tarifas de roaming para representar os preços das sessões iniciadas por provedores de terminais de pagamento (PTP). Configure a Roaming Tariff para pagamentos ad-hoc com os preços desejados para energia e tempo, incluindo impostos. A tarifa também contém o valor máximo para autorização de pagamento da sessão de carregamento.

Notas Importantes:

• As tarifas de roaming calculam as despesas que o provedor do terminal de pagamento deve pagar ao operador do ponto de carregamento.
• Estes preços não são necessariamente o que o cliente final (motorista de EV) paga.

Diretrizes de Configuração:

1. Criar Tarifa de Roaming:

   • Navegue até Roaming -> Roaming Tariffs.
   • Adicione uma nova tarifa com um Name e Code.
   • Defina o Status como Active e defina o intervalo de tempo de validade.
   • Envie para criar a definição da tarifa.

2. Adicionar Detalhes da Tarifa:

   • Dentro da tarifa, adicione Tariff Details (Detalhes da Tarifa).
   • Recurrency (Recorrência): Selecione One-time (Única vez) ou Daily (Diário) recorrente.
   • Priority (Prioridade): Detalhes com prioridade mais alta substituem os de prioridade mais baixa se os períodos de tempo se sobrepuserem.
   • Time Frame (Período de Tempo): Determine a data e hora de início inclusiva e a data e hora de término exclusiva. Selecione em quais dias o Detalhe da Tarifa se aplica.
   • Pricing (Preço): Defina o preço e a porcentagem de IVA para as métricas de classificação (energia, tempo de carga, tempo de estacionamento, flat, tempo de reserva, etc.). Campos vazios são tratados como zero.
   • Envie a configuração.

3. Atribuir Tarifa à Roaming Platform (PTP):

   • Navegue de volta para Roaming -> Roaming Platforms.
   • Edite a Roaming Platform específica para o provedor de terminal de pagamento configurado anteriormente.
   • No assistente de configuração (geralmente Passo 1), atribua a Roaming Tariff.
   • Envie a configuração.

4. Atribuir Tarifa à Infraestrutura de Carregamento:

   • Navegue para qualquer nível de infraestrutura de carregamento que tenha as Session Settings (também referido como Session Rating Profile), que é atribuído à infraestrutura de carregamento em different levels.
   • Atribua a Roaming Tariff para o nível de escopo desejado:
     • Site
     • Operator
     • Charger
   • Envie a configuração.

Uma vez configuradas, as novas sessões de carregamento relacionadas a este provedor de terminal de pagamento terão os custos calculados com base nestas configurações. As tarifas são relatadas ao provedor do terminal de pagamento (modo push) e também podem ser buscadas (modo pull).

Controle da Sessão de Carregamento

Operações pelas quais o provedor do terminal de pagamento pode solicitar ao operador do ponto de carregamento do Tridens EV Charge para gerenciar a sessão de carregamento:

• Início de sessão remota
• Parada de sessão remota

As ações resultantes e intermediárias da sessão de carregamento são encaminhadas de volta ao provedor do terminal de pagamento por API:

• Início da sessão
• Atualização da sessão
• Fim da sessão
• Alterações no status da infraestrutura de carregamento
• Relatório final de consumo

O progresso da sessão é relatado ao provedor do terminal de pagamento (modo push) e também pode ser buscado (modo pull).