交易接入 / 操作与配置
易支付上游支付宝:获取上游商户参数并接入
向另一家兼容传统易支付接口的上游申请商户,取得网关、pid、pkey,再让 ZOO 转交 支付宝 订单。它与自己直接申请官方 支付宝 API 参数是两条路径。
01 / 准备条件
02 / 分步操作
03 / 结果检查
使用前准备
- 已选择有权使用并确认兼容协议的上游商户服务。
- 上游已为你的商户开通 支付宝,不是只注册账号。
- 应用允许本教程渠道,上游费用、结算与规则已自行了解。
01从准备到结果确认
查看这段动画的完整步骤
- 区分身份
ZOO / 上游:两套商户凭据不能互换。
上游允许 支付宝,网关/商户/密钥同源。
- 核对开通
上游支付宝:type=alipay。
ZOO 正确应用配置已生效,未接到自己。
- 取得网关
接口根地址:本人上游 HTTPS 网关。
上游 支付宝、ZOO 状态和业务回调已分别验收。
- 取得商户
pid / pkey:同一上游商户资料。
上游 支付宝、ZOO 状态和业务回调已分别验收。
- 填参生效
ZOO 易支付配置:允许 easypay_alipay。
上游 支付宝、ZOO 状态和业务回调已分别验收。
- 单独验收
上游支付宝订单:实际到账与两级回调。
上游 支付宝、ZOO 状态和业务回调已分别验收。
02第一步:区分 ZOO 与上游两套身份
查看这段动画的完整步骤
- 登录你自己的 ZOO 站点
登录你自己的 ZOO 站点。示例为分站 https://s.198600.xyz,示例应用名为 vpnceshi。这里的应用名可以换成你的实际业务名。
上游允许 支付宝,网关/商户/密钥同源。
- 打开左侧“商户应用”
打开左侧“商户应用”,找到 vpnceshi,确认所属商户是自己。检查“默认支付范围”是否包含本教程渠道;管理员可点“编辑”调整,普通商户看不到编辑按钮时联系管理员。
ZOO 正确应用配置已生效,未接到自己。
- 打开左侧“系统设置”
打开左侧“系统设置”。管理员先在“选择商户应用”中选 vpnceshi,不要误选“平台默认配置”。普通商户选择自己的应用,不能配置别人的应用。
上游 支付宝、ZOO 状态和业务回调已分别验收。
- 列表已有“易支付”时点该行“编辑”
列表已有“易支付”时点该行“编辑”;没有时点“新增配置”,在“支付平台”选“易支付”。本教程只处理这一个配置组。
上游 支付宝、ZOO 状态和业务回调已分别验收。
03第二步:在上游后台申请并取得三个参数
查看这段动画的完整步骤
- 打开你所选上游的官方商户入口
打开你所选上游的官方商户入口,按它的规则申请商户、提交资料及完成授权。各家名称和审核流程不同,不能保证任何注册账号都可收款。
上游允许 支付宝,网关/商户/密钥同源。
- 支付宝 的 type 是 alipay
联系上游确认支持传统 submit.php 跳转下单、api.php 查单/退款、MD5 签名,支付宝 的 type 是 alipay。只有 RSA v2/另一种协议的系统不能直接套这三项。
ZOO 正确应用配置已生效,未接到自己。
- 操作 3
在商户后台找到“开发者/API 接口/商户信息/接入信息”,取得 接口根地址(网关)、商户 ID(pid)、商户密钥(key/pkey)。若页面叫 API Key,先请上游确认就是传统易支付商户签名 key,不是登录密码或 token。
上游 支付宝、ZOO 状态和业务回调已分别验收。
- 确认上游已开通 支付宝、商户账户可交易
确认上游已开通 支付宝、商户账户可交易,并了解费率、结算账户及到账周期;这些由上游决定,ZOO 填参不会自动开通。
上游 支付宝、ZOO 状态和业务回调已分别验收。
- 若上游要求回调域名白名单
若上游要求回调域名白名单,按当前 ZOO 回调地址的域名登记。不随便把所有域名放开,也不向客服发送完整 pkey。
上游 支付宝、ZOO 状态和业务回调已分别验收。
04第四步:生效并单独测试上游 支付宝 · 1
查看这段动画的完整步骤
- 按字段表填入自己取得的资料
按字段表填入自己取得的资料。 保存过的私密字段不会回显;编辑时留空保留原值,填写新值会覆盖旧值。不要把星号或示例文字粘进去。
上游允许 支付宝,网关/商户/密钥同源。
- 点击“验证配置”
点击“验证配置”,阅读提示。验证失败时先按本页排错表修正,不要反复点击保存。验证主要检查凭据、格式或接口连通性,不能证明每种支付产品、到账和回调都已完成。
ZOO 正确应用配置已生效,未接到自己。
- 点击“保存草稿”
点击“保存草稿”。若弹出安全确认,按页面要求在自己的浏览器完成邮箱或双因素验证,勿将验证码发给他人。草稿保存后回到配置列表。
上游 支付宝、ZOO 状态和业务回调已分别验收。
- 再点击这一行“生效”
复核当前选中的应用、测试/正式环境和回调地址,再点击这一行“生效”。确认状态变为“已生效”。生效影响该应用之后的支付,请在业务允许的时间操作。
上游 支付宝、ZOO 状态和业务回调已分别验收。
- 从已接入的测试商店或面板生成一笔新订单
从已接入的测试商店或面板生成一笔新订单,选择本教程渠道。不要重新使用过期订单,也不要把“返回成功页面”当成到账。检查 ZOO“支付订单”、服务商交易记录和“商户回调”。
上游 支付宝、ZOO 状态和业务回调已分别验收。
05第四步:生效并单独测试上游 支付宝 · 2
查看这段动画的完整步骤
- 新订单选择“[第三方上游易支付] 支付宝”
新订单选择“[第三方上游易支付] 支付宝”,即 easypay_alipay。ZOO 会按 type=alipay 跳转到上游收银台。
上游允许 支付宝,网关/商户/密钥同源。
- 在上游页面核对收款主体、金额和订单信息
在上游页面核对收款主体、金额和订单信息,再由本人支付。先确认域名属于你配置的上游;页面不能打开时不继续输入账户。
ZOO 正确应用配置已生效,未接到自己。
- 上游交易记录应显示成功
上游交易记录应显示成功;ZOO 订单应更新为 SUCCESS,随后业务商店收到回调。对照三端订单编号,不只看上游返回成功页面。
上游 支付宝、ZOO 状态和业务回调已分别验收。
- 两种易支付渠道虽然共用网关与商户参数
两种易支付渠道虽然共用网关与商户参数,但支付宝和微信要分别验收;一种成功不代表另一种开通。
上游 支付宝、ZOO 状态和业务回调已分别验收。
详细操作与条件
第一步:区分 ZOO 与上游两套身份
- 登录你自己的 ZOO 站点。示例为分站
https://s.198600.xyz,示例应用名为vpnceshi。这里的应用名可以换成你的实际业务名。 - 打开左侧“商户应用”,找到
vpnceshi,确认所属商户是自己。检查“默认支付范围”是否包含本教程渠道;管理员可点“编辑”调整,普通商户看不到编辑按钮时联系管理员。 - 打开左侧“系统设置”。管理员先在“选择商户应用”中选
vpnceshi,不要误选“平台默认配置”。普通商户选择自己的应用,不能配置别人的应用。 - 列表已有“易支付”时点该行“编辑”;没有时点“新增配置”,在“支付平台”选“易支付”。本教程只处理这一个配置组。
这里的“易支付”是 ZOO → 另一家上游。从上游拿 pid/pkey;不要填本应用 ZOO App ID/App Secret,也不要把本分站域名填成上游形成循环。业务商店 → ZOO 的接入参数仍单独使用。
第二步:在上游后台申请并取得三个参数
- 打开你所选上游的官方商户入口,按它的规则申请商户、提交资料及完成授权。各家名称和审核流程不同,不能保证任何注册账号都可收款。
- 联系上游确认支持传统
submit.php跳转下单、api.php查单/退款、MD5签名,支付宝 的 type 是alipay。只有 RSA v2/另一种协议的系统不能直接套这三项。 - 在商户后台找到“开发者/API 接口/商户信息/接入信息”,取得 接口根地址(网关)、商户 ID(pid)、商户密钥(key/pkey)。若页面叫 API Key,先请上游确认就是传统易支付商户签名 key,不是登录密码或 token。
- 确认上游已开通 支付宝、商户账户可交易,并了解费率、结算账户及到账周期;这些由上游决定,ZOO 填参不会自动开通。
- 若上游要求回调域名白名单,按当前 ZOO 回调地址的域名登记。不随便把所有域名放开,也不向客服发送完整 pkey。
第三步:逐项填写 ZOO 易支付配置
| ZOO 字段 | 从哪里取得 | 示例和注意 |
|---|---|---|
| 接口网关 API 地址(EASYPAY_API_URL) | 上游给的公开接口根地址 | 如 https://pay.example.com/,以 / 结尾;不是本 ZOO 地址,也不要把 /submit.php 和查询参数贴进根地址 |
| 商户 ID (pid)(EASYPAY_PID) | 上游商户后台 | 上游 pid,不是 ZOO App ID |
| 商户密钥 (pkey)(EASYPAY_PKEY) | 上游接口接入资料 | 上游签名 key,不是登录密码 |
服务商 → ZOO:在当前应用配置列表复制“回调地址”。分站应用通常为 https://s.198600.xyz/api/v1/notify/easypay/你的ZOO应用ID;平台默认地址没有应用 ID 后缀。以后台生成地址为准,不照抄占位文本。
ZOO → 你的商店:在商店插件或面板设置 ZOO 的商户回调地址,应用“回调 Origin 白名单”仅填写它的 https://域名(不含路径)。这两个方向不能互换。
第四步:生效并单独测试上游 支付宝
- 按字段表填入自己取得的资料。 保存过的私密字段不会回显;编辑时留空保留原值,填写新值会覆盖旧值。不要把星号或示例文字粘进去。
- 点击“验证配置”,阅读提示。验证失败时先按本页排错表修正,不要反复点击保存。验证主要检查凭据、格式或接口连通性,不能证明每种支付产品、到账和回调都已完成。
- 点击“保存草稿”。若弹出安全确认,按页面要求在自己的浏览器完成邮箱或双因素验证,勿将验证码发给他人。草稿保存后回到配置列表。
- 复核当前选中的应用、测试/正式环境和回调地址,再点击这一行“生效”。确认状态变为“已生效”。生效影响该应用之后的支付,请在业务允许的时间操作。
- 从已接入的测试商店或面板生成一笔新订单,选择本教程渠道。不要重新使用过期订单,也不要把“返回成功页面”当成到账。检查 ZOO“支付订单”、服务商交易记录和“商户回调”。
- 新订单选择“[第三方上游易支付] 支付宝”,即
easypay_alipay。ZOO 会按type=alipay跳转到上游收银台。 - 在上游页面核对收款主体、金额和订单信息,再由本人支付。先确认域名属于你配置的上游;页面不能打开时不继续输入账户。
- 上游交易记录应显示成功;ZOO 订单应更新为 SUCCESS,随后业务商店收到回调。对照三端订单编号,不只看上游返回成功页面。
- 两种易支付渠道虽然共用网关与商户参数,但支付宝和微信要分别验收;一种成功不代表另一种开通。
当前易支付适配器未提供完整的上游在线凭据验证。界面若提示仅检查配置/暂不支持在线验证,不代表渠道无法保存,也不代表已经可收款;按页面流程保存并在安全业务环境用新订单验收。
常见问题排查
| 现象 | 检查 |
|---|---|
| 跳转到自己或不停循环 | 上游根地址是否误填本 ZOO 地址 |
| 签名错误/pid 无效 | 网关、pid、pkey 是否同商户同环境;协议是否传统 MD5 |
| 上游提示 支付宝 未开通 | 请求 type=alipay 的渠道是否已授权给该 pid |
| 地址打不开或路径重复 | 根地址带结尾 /,去掉 submit.php、API 方法及 query 部分 |
| 上游成功但 ZOO 未成功 | 上游 → ZOO 回调是否正确、可达、签名匹配;保留两边订单号联系管理员 |
| ZOO 成功但商店没到账 | 检查 ZOO → 商店的商户回调和业务处理,这与上游回调方向不同 |
资料从哪里确认
易支付不是一个统一官方账号平台,教程不能替你指定或担保某家上游。请以所选上游商户后台的“API 文档/接入说明”为准,核对上述传统协议;复制文章中的虚构网关不能收款。
资料核对:2026-10-03。本文按 ZOO 当前字段整理,未复制真实账号凭据。服务商的资格、费率和审核结果由服务商决定。
操作结果确认
- 上游允许 支付宝,网关/商户/密钥同源。
- ZOO 正确应用配置已生效,未接到自己。
- 上游 支付宝、ZOO 状态和业务回调已分别验收。
本页操作视频
与本页主动画使用同一分镜。视频按 1.5× 导出,32 秒;付款与凭据操作由本人完成。
常见问题
上游就是另一套 ZOO 可以吗?
要先确认它对你提供兼容的传统易支付商户接口及独立商户凭据,不能直接把另一套后台的 App ID/App Secret 当 pid/pkey。
为什么不知道上游的界面按钮?
每家上游后台不同。找 API 接入资料和同一商户的三个值,找不到请上游提供接入文档,不猜字段。
保存之后怎么还是旧配置?
保存草稿不会启用新配置;确认选对应用,再点对应行“生效”,用新订单测试。
编辑时密钥输入框空着,是不是丢了?
私密字段保存后不会回显。已配置字段留空保留原值;重新输入会覆盖。首次新增仍需填写必要参数。
我没有申请到官方账号,可以先照抄教程参数吗?
不能。示例和图中的值都不可用于支付。必须取得自己有权使用的账户和参数;未开通的产品先不要启用。