支付终端集成
类别:
本文档的主题:
## 介绍
本文档描述了Tridens EV Charge上通过 OCPI或OICP通信协议 进行支付终端 (POS) 集成的设置要求。
集成涉及支付终端提供商 (PTP) 与充电点运营商 (CPO) 的充电基础设施进行通信。 在本文档中,术语“支付终端提供商”用作技术术语,并被视为技术性较低的术语“POS 提供商”的同义词。 支付终端提供商通过OCPI或OICP协议充当充电基础设施的网关,用于充电会话控制和相关数据传输。 OCPI协议提供官方支付终端支持。对于OICP,可以利用混合概念。
Notes:
支付终端提供商可以添加到Tridens EV Charge环境中。
支付终端提供商的充电会话存储在Tridens EV Charge中,作为远程充电基础设施网络的一部分,没有已知的客户/司机参考。
-W当支付终端提供商充电会话用于作为Tridens EV Charge一部分的相关CPO充电基础设施时,此类会话将显示为该CPO的家庭充电基础设施网络的一部分。
- 会话是Tridens EV Charge中CPO报告的一部分。

图 1: 支付终端提供商的OCPI通信拓扑。
## 配置
可以在CPO的Tridens EV Charge租户环境中配置支付终端提供商。以下说明重点介绍OCPI协议,因为它正式定义了支付终端设置和通信(自OCPI2.2.1 起标准化)。
配置支付终端提供商
要配置漫游支付终端提供商 (PTP) 的环境:
- 导航至漫游:
- 转到Tridens EV Charge仪表板左侧菜单上的 漫游 部分。
- 本例中的漫游配置文件代表漫游网络中充电基础设施(充电器)运营商的环境。
- 这里的漫游平台代表第三方支付终端提供商。
- 提交配置。
- 创建漫游配置文件(CPO):
- 在 漫游配置文件 选项卡上,创建一个新的配置文件或使用现有的配置文件。
- 名称和代码:A分配名称和代码以识别漫游配置文件。
- 类型:选择CPO(充电点运营商)。
- 协议:选择OCPI。
- 漫游ID:三个大写字母标识符,表示漫游中的CPO。
- 提交配置。
- 创建漫游平台(PTP):
- 创建一个新的漫游平台:
- 名称和代码:Assign 值来识别平台。
- 类型:选择支付终端提供商 (PTP)。
- URL:输入支付终端提供商的后台服务器URL(例如
https://your-pos-provider.com/api/ocpi)。 - 国家:选择支付终端提供商的来源国家/地区。
- 连接启动:选择哪一方将使用注册令牌启动OCPI连接。
- 凭证交换(令牌):
- 如果 PTP 提供令牌:选择“我将使用漫游合作伙伴提供的令牌”并在字段中输入令牌。
- 如果 CPO提供令牌:选择“我将向我的漫游伙伴提供令牌”,然后单击 生成。与支付终端提供商共享生成的令牌和您的连接URL。
- 注册:
- 沟通必须通过注册发起。
- 注册凭据
- 如果您使用合作伙伴的令牌,请在所选漫游平台上单击“注册凭据”。
- 如果您提供了令牌,支付终端提供商必须启动注册。
- 更新凭证:如果需要,使用“更新凭证”重新协商凭证。
- 使凭证无效:使用“使凭证无效”来停止通信/集成。

图 2: OCPI通信序列。
充电基础设施设置
一旦CPO和 PTP 进行通信,支付终端提供商就可以获取CPO的充电基础设施(位置、EVSE、连接器)。CPO必须填充特定的漫游属性以公开基础设施:
- Area:使用唯一标识符和
phone number填充roaming id。 - 充电器:使用唯一标识符填充
roaming id,并将roaming属性标记为 启用。 - 连接器:使用唯一标识符填充
roaming id。
位置和充电基础设施会报告给支付终端提供商(推送模式),也可以获取(拉取模式)。
漫游资费
A作为充电点运营商,您可能希望指定漫游资费来表示支付终端提供商 (PTP) 发起的会话的价格。 设置漫游费率,用于临时付款,并提供所需的能源和时间价格(包括税费)。 关税还包含最高限额。充电会话的支付授权金额。
重要说明:
- 漫游资费计算支付终端提供商必须向充电点运营商支付的费用。
- 这些价格不一定是最终客户(电动汽车驾驶员)支付的价格。
配置指南:
- 创建漫游资费:
- 导航至 漫游 -> 漫游资费。 -Add 具有名称和代码的新费率。
- 将状态设置为Aactive并定义有效时间范围。
- 提交以创建关税定义。
- Add 资费详情:
- 在关税内,添加关税详细信息。
- 重复:选择一次性或每日重复。
- 优先级:如果时间范围重叠,较高优先级的详细信息将覆盖较低优先级的详细信息。
- 时间范围:确定包含开始日期时间和不包含停止日期时间。选择费率详细信息适用的日期。
- 定价:设置评级指标的价格和 VAT 百分比(能源、充电时间、停车时间、平价、预订时间等)。空字段被视为零。
- 提交配置。
- Assign漫游平台资费(PTP):
- Assign 充电基础设施资费:
- 导航到具有会话设置(也称为会话评级配置文件)的任何充电基础设施级别,该级别被分配给不同级别的充电基础设施。 -A签署所需范围级别的 漫游资费:
- 地点
- 操作员
- 充电器
- 提交配置。
配置完成后,与该支付终端提供商相关的新计费会话将根据这些设置计算费用。资费报告给支付终端提供商(推送模式),也可以获取(拉动模式)。
充电会话控制
支付终端提供商可以请求Tridens EV Charge的充电点运营商管理充电会话的操作:
- 远程会话启动
- 远程会话停止
结果和中间计费会话操作由API转发回支付终端提供商:
- 会话开始
- 会话更新
- 会议结束
- 充电基础设施状态变化
- 最终消耗报告
会话进度会报告给支付终端提供商(推送模式),也可以获取(拉取模式)。