易支付插件
易支付插件让系统兼容易支付(EPay)协议:存量易支付对接的业务系统不改代码,改个地址即可切到本平台收款。菜单路径:扩展插件 → 易支付。
配置按应用维度:在应用工作台 → 支付配置 → 易支付配置开启并配密钥;本篇的订单页则是易支付协议订单的查询与处置入口。
启用与密钥配置
应用工作台 → 易支付配置,三个分区:
基础对接
| 项 | 说明 |
|---|---|
| 启用 | 总开关,关闭后该应用拒绝一切易支付协议请求 |
| 易支付商户号(PID) | 系统按应用自动分配,只读 |
| V1 / V2 对接地址 | 只读,给对接方替换原易支付地址用 |
V1 协议:开启后配置 MD5 密钥(对应易支付传统的 KEY 签名)。
V2 协议(默认开启):默认使用系统密钥(复用应用已有的签名体系,推荐);关闭「使用系统密钥」后改为独立 RSA 密钥对(平台公钥只读展示,商户公钥可在线生成,私钥仅展示一次)。
当前版本不回调
本期易支付协议不发送异步通知,对接方需用查询接口轮询订单状态——迁移文档里要明确告知。
易支付订单
菜单路径:扩展插件 → 易支付 → 订单。面向协议侧的订单视图:
- 查询:商户订单号、平台业务单号、商品名称、协议状态(待支付 / 已支付)、支付方式、创建时间;
- 详情:订单信息、时间信息、应用与协议(PID、应用 ID、协议版本、PC 调用方式)、支付与回调(支付用户标识、支付链接、通知与跳转地址、扩展参数);
- 操作:
- 同步状态:主动向支付通道查询该订单最新状态(长时间停在「待支付」时用);
- 关闭订单:仅待支付状态可关,关闭后不可继续支付。
易支付退款订单
同路径下的退款单视图:
- 查询:平台退款单号、商户退款单号、商户订单号、平台业务单号、退款状态(处理中 / 退款成功)、创建时间;
- 详情:退款信息、应用与协议、时间信息;
- 操作:同步状态(对处理中的退款主动查询通道结果)。
与普通订单的区别
| 维度 | 易支付订单 | 普通支付订单 |
|---|---|---|
| 视角 | 易支付协议字段(PID、协议版本、商户订单号) | 平台统一订单模型(三层订单) |
| 状态 | 协议二态:待支付 / 已支付 | 完整支付状态机与资金状态 |
| 金额单位 | 元 | 元(数据库内部为分) |
| 用途 | 迁移期排查对接方请求 | 日常交易查询与处置主入口 |
易支付订单最终也映射为平台支付单;资金层面的对账与退款处理以支付订单为准。