用途与准备
安装中转插件，购买精确域名授权，连接上游面板和 ZOO 商户应用。
操作前准备
- WordPress 站点已启用 HTTPS，并可安装插件。
- 已在 ZOO 创建商户应用并开通实际需要的支付渠道。
- 上游系统支持易支付兼容请求。
先看完整流程
流程动效只用于提示步骤顺序；所有信息均在图下注明。可使用页头按钮暂停，系统开启“减少动态效果”时会自动停止。
插件负责什么
插件接收上游系统的易支付兼容请求，校验后向 ZOO 创建支付订单，再把收银台地址返回给用户。支付完成后，插件验证 ZOO 回调并通知上游系统。插件不会替代 ZOO 商户应用、支付渠道或 WordPress 本身的安全管理。
安装和授权
- 在 WordPress 后台上传并启用官方提供的插件安装包。升级前备份 WordPress 文件和数据库。
- 进入 ZOO 后台“独立部署”中的“ZOO 中转插件授权”，输入安装插件的精确域名。不要包含协议、路径或端口。
- 完成支付后，在授权订单中取得激活码。授权价格和状态以后台实时显示为准。
- 回到 WordPress 的 ZOO 插件设置页，输入激活码并绑定当前域名。插件授权与 ZOO 独立部署源码授权不能互相替代。
基础配置
| 方向 | 需要配置 | 注意事项 |
|---|---|---|
| 上游系统 | 商户 PID、KEY 和网关入口 | 与上游易支付驱动完全一致 |
| ZOO | API 根地址、App ID、App Secret | Secret 只保存在服务器端 |
| 支付范围 | 实际开通的支付渠道 | 留空或填写方式以插件当前说明为准 |
| 订单 | 真实商品或服务名称 | 不得使用虚假描述掩盖交易用途 |
上线前测试
- 使用小额测试订单验证下单、跳转、支付、ZOO 回调和上游订单更新。
- 重复发送同一回调，确认上游不会重复激活或重复入账。
- 检查失败重试和日志时对 App Secret、KEY 与用户信息做脱敏。
- 确认退款、客服和订单查询入口与实际业务一致。
操作结果确认
- 插件授权对当前精确域名有效。
- 测试订单完成从上游到 ZOO 再回到上游的闭环。
- 重复回调不会重复执行业务。
常见问题
访问地址出现 404 或参数丢失怎么办？
先检查上游驱动是否重复拼接入口文件或查询参数，并按插件当前设置页提供的网关格式重新核对。
支付成功但上游没有更新怎么办？
依次检查 ZOO 回调是否到达插件、验签是否通过、上游通知地址是否可访问，以及上游是否返回成功结果。