交易接入 / 操作与配置
支付宝手机网站支付:申请参数与逐项配置
手机浏览器跳转支付宝网页或拉起支付宝 App,适合手机网站。微信内置浏览器可能限制拉起外部 App。
01 / 准备条件
02 / 分步操作
03 / 结果检查
使用前准备
- 已创建自己的 ZOO 应用,并有权限管理它。
- 在商户应用允许“[官方] 支付宝手机网站支付”。
- 支付宝应用开通手机网站支付;ZOO 对应“手机网站支付(WAP)”产品。
01从准备到结果确认
查看这段动画的完整步骤
- 确认条件
收款资格:创建网页应用,保存 APPID。
ZOO 应用允许此渠道,支付宝同一 APPID 的对应产品已开通。
- 准备参数
官方 / 上游:签约手机网站支付。
整套参数环境一致,所选应用配置显示已生效。
- 选择应用
配置范围:本人应用,核对商户归属。
本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
- 填写配置
接入方式:与官方模式一致。
本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
- 验证生效
操作顺序:验证配置 → 保存草稿 → 生效。
本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
- 完整验收
真实结果:实际到账 + ZOO 订单 + 商户回调。
本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
02密钥模式:区分两种公钥
03证书模式:三份证书各填其位
04第一步:选对应用与官方渠道
查看这段动画的完整步骤
- 登录你自己的 ZOO 站点
登录你自己的 ZOO 站点。示例为分站 https://s.198600.xyz,示例应用名为 vpnceshi。这里的应用名可以换成你的实际业务名。
ZOO 应用允许此渠道,支付宝同一 APPID 的对应产品已开通。
- 打开左侧“商户应用”
打开左侧“商户应用”,找到 vpnceshi,确认所属商户是自己。检查“默认支付范围”是否包含本教程渠道;管理员可点“编辑”调整,普通商户看不到编辑按钮时联系管理员。
整套参数环境一致,所选应用配置显示已生效。
- 打开左侧“系统设置”
打开左侧“系统设置”。管理员先在“选择商户应用”中选 vpnceshi,不要误选“平台默认配置”。普通商户选择自己的应用,不能配置别人的应用。
本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
- 列表已有“支付宝”时点该行“编辑”
列表已有“支付宝”时点该行“编辑”;没有时点“新增配置”,在“支付平台”选“支付宝”。本教程只处理这一个配置组。
本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
05第二步:从支付宝取得 APPID 和签约产品
查看这段动画的完整步骤
- 打开 支付宝开放平台 ↗
打开 支付宝开放平台 ↗,用收款主体的账号登录并完成开发者/主体认证。准备官方当前要求的营业执照、负责人信息、结算账户和业务网站资料;个人账号能登录不代表已经具有正式支付产品资格。
ZOO 应用允许此渠道,支付宝同一 APPID 的对应产品已开通。
- 创建用于自己网站收款的应用
在“控制台/开发者中心”找到“网页/移动应用”或类似应用管理入口,创建用于自己网站收款的应用;填写名称、业务说明与网站资料,按官方要求提交审核。选择普通自用收款应用,不要把服务商代接入或小程序教程直接套过来。
整套参数环境一致,所选应用配置显示已生效。
- 进入这个应用的详情
进入这个应用的详情,记录 APPID。以后取密钥、产品和证书都在这个应用中操作,不从另一个应用复制。
本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
- 按平台要求签约和提交资料
在“产品绑定/添加能力/功能包”中找到“手机网站支付”,按平台要求签约和提交资料,等状态已开通/生效。找不到产品或审核未通过时先询问支付宝官方客服,不是在 ZOO 勾选一下就能解决。
本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
- 测试阶段可使用支付宝开放平台沙箱
测试阶段可使用支付宝开放平台沙箱。沙箱 APPID、密钥、网关和测试付款工具要成套;正式阶段重新用真实应用与正式参数配置。
本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
06第三步:获取密钥,密钥模式与证书模式二选一
查看这段动画的完整步骤
- 打开官方 密钥工具说明 ↗
打开官方 密钥工具说明 ↗,从官方链接下载安装,选择 RSA2 生成一对应用公钥/应用私钥。私钥留在自己的电脑,上传的是公钥。不要用不明网站在线生成私钥。
ZOO 应用允许此渠道,支付宝同一 APPID 的对应产品已开通。
- 按页面要求上传或粘贴应用公钥并保存
在应用详情的“开发设置/接口加签方式”选公钥(密钥)模式,按页面要求上传或粘贴应用公钥并保存。
整套参数环境一致,所选应用配置显示已生效。
- 设置完成后
设置完成后,在同一应用查看支付宝公钥,复制并留存。ZOO“应用私钥”填写你生成的私钥,“支付宝公钥”填写支付宝给的公钥,不能互换。
本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
- 在官方应用的接口加签设置选择公钥证书模式
在官方应用的接口加签设置选择公钥证书模式,使用官方工具生成应用公钥/私钥并提交应用公钥,按页面要求生成/上传证书申请资料。保留与申请时公钥匹配的应用私钥。
本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
- 从该应用下载三份
从该应用下载三份:应用公钥证书、支付宝公钥证书、支付宝根证书。文件名可能包含 APPID 或版本后缀,按证书的用途对应 ZOO 字段。
本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
- 用本地文本编辑器打开私钥/CRT 文件
用本地文本编辑器打开私钥/CRT 文件,复制完整文本,包括 BEGIN/END 行和换行。新手优先直接粘贴内容;不要填写你电脑的 C 盘路径,因为 ZOO 服务器读不到它。
本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
07第五步:验证、保存、生效
查看这段动画的完整步骤
- 按字段表填入自己取得的资料
按字段表填入自己取得的资料。“已开通产品”选“手机网站支付”;其它产品确实开通后再勾选。 保存过的私密字段不会回显;编辑时留空保留原值,填写新值会覆盖旧值。不要把星号或示例文字粘进去。
ZOO 应用允许此渠道,支付宝同一 APPID 的对应产品已开通。
- 点击“验证配置”
点击“验证配置”,阅读提示。验证失败时先按本页排错表修正,不要反复点击保存。验证主要检查凭据、格式或接口连通性,不能证明每种支付产品、到账和回调都已完成。
整套参数环境一致,所选应用配置显示已生效。
- 点击“保存草稿”
点击“保存草稿”。若弹出安全确认,按页面要求在自己的浏览器完成邮箱或双因素验证,勿将验证码发给他人。草稿保存后回到配置列表。
本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
- 再点击这一行“生效”
复核当前选中的应用、测试/正式环境和回调地址,再点击这一行“生效”。确认状态变为“已生效”。生效影响该应用之后的支付,请在业务允许的时间操作。
本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
- 从已接入的测试商店或面板生成一笔新订单
从已接入的测试商店或面板生成一笔新订单,选择本教程渠道。不要重新使用过期订单,也不要把“返回成功页面”当成到账。检查 ZOO“支付订单”、服务商交易记录和“商户回调”。
本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
详细操作与条件
第一步:选对应用与官方渠道
- 登录你自己的 ZOO 站点。示例为分站
https://s.198600.xyz,示例应用名为vpnceshi。这里的应用名可以换成你的实际业务名。 - 打开左侧“商户应用”,找到
vpnceshi,确认所属商户是自己。检查“默认支付范围”是否包含本教程渠道;管理员可点“编辑”调整,普通商户看不到编辑按钮时联系管理员。 - 打开左侧“系统设置”。管理员先在“选择商户应用”中选
vpnceshi,不要误选“平台默认配置”。普通商户选择自己的应用,不能配置别人的应用。 - 列表已有“支付宝”时点该行“编辑”;没有时点“新增配置”,在“支付平台”选“支付宝”。本教程只处理这一个配置组。
alipay_wap;三种支付宝渠道共用一组收款密钥。本页以“手机网站支付”说明产品开通与验收,已有同一应用正确参数可以复用,不需要再新增第二组支付宝配置。
第二步:从支付宝取得 APPID 和签约产品
- 打开 支付宝开放平台 ↗,用收款主体的账号登录并完成开发者/主体认证。准备官方当前要求的营业执照、负责人信息、结算账户和业务网站资料;个人账号能登录不代表已经具有正式支付产品资格。
- 在“控制台/开发者中心”找到“网页/移动应用”或类似应用管理入口,创建用于自己网站收款的应用;填写名称、业务说明与网站资料,按官方要求提交审核。选择普通自用收款应用,不要把服务商代接入或小程序教程直接套过来。
- 进入这个应用的详情,记录 APPID。以后取密钥、产品和证书都在这个应用中操作,不从另一个应用复制。
- 在“产品绑定/添加能力/功能包”中找到“手机网站支付”,按平台要求签约和提交资料,等状态已开通/生效。找不到产品或审核未通过时先询问支付宝官方客服,不是在 ZOO 勾选一下就能解决。
- 测试阶段可使用支付宝开放平台沙箱。沙箱 APPID、密钥、网关和测试付款工具要成套;正式阶段重新用真实应用与正式参数配置。
第三步:获取密钥,密钥模式与证书模式二选一
已有密钥模式的应用
- 打开官方 密钥工具说明 ↗,从官方链接下载安装,选择 RSA2 生成一对应用公钥/应用私钥。私钥留在自己的电脑,上传的是公钥。不要用不明网站在线生成私钥。
- 在应用详情的“开发设置/接口加签方式”选公钥(密钥)模式,按页面要求上传或粘贴应用公钥并保存。
- 设置完成后,在同一应用查看支付宝公钥,复制并留存。ZOO“应用私钥”填写你生成的私钥,“支付宝公钥”填写支付宝给的公钥,不能互换。
官方应用使用证书模式时
- 在官方应用的接口加签设置选择公钥证书模式,使用官方工具生成应用公钥/私钥并提交应用公钥,按页面要求生成/上传证书申请资料。保留与申请时公钥匹配的应用私钥。
- 从该应用下载三份:应用公钥证书、支付宝公钥证书、支付宝根证书。文件名可能包含 APPID 或版本后缀,按证书的用途对应 ZOO 字段。
- 用本地文本编辑器打开私钥/CRT 文件,复制完整文本,包括 BEGIN/END 行和换行。新手优先直接粘贴内容;不要填写你电脑的 C 盘路径,因为 ZOO 服务器读不到它。
ZOO 支持 PEM 私钥及 CRT 证书文本。优先保留完整文件格式;遇到解析错误时查看官方工具的格式转换说明,保留原文件再转换。公钥上传和证书下载必须属于同一个 APPID;更换密钥后旧参数不会自动变成新参数。
第四步:在 ZOO 逐项填写
| ZOO 字段 | 配置键 | 从哪里拿 | 填写提醒 |
|---|---|---|---|
| 接入方式 | KEY / CERT | 与支付宝应用的接口加签方式一致 | 密钥模式或证书模式 |
| 已开通产品 | ALIPAY_PRODUCT_CAPABILITIES | 仅勾选当前支付宝应用已签约、已生效的产品 | 手机网站支付 |
| 应用 ID | ALIPAY_APP_ID | 开放平台 → 当前应用详情 → APPID | 支付宝 APPID,不是 ZOO App ID |
| 应用私钥 | ALIPAY_PRIVATE_KEY | 在自己电脑上用官方密钥工具生成并保管 | 完整私钥内容;不是应用公钥 |
| 支付宝公钥(密钥模式) | ALIPAY_PUBLIC_KEY | 上传应用公钥后,在该应用加签设置查看支付宝公钥 | 不是你生成的应用公钥 |
| 应用公钥证书(证书模式) | ALIPAY_APP_CERT | 证书加签设置下载的 appCertPublicKey 文件 | 完整 CRT 文本 |
| 支付宝公钥证书(证书模式) | ALIPAY_PUBLIC_CERT | 同一应用证书加签设置下载的支付宝 RSA2 公钥证书 | 完整 CRT 文本 |
| 支付宝根证书(证书模式) | ALIPAY_ROOT_CERT | 官方证书设置提供的 alipayRootCert 文件 | 完整 CRT 文本 |
| 网关地址 | ALIPAY_GATEWAY | ZOO 下拉选项 | 沙箱测试或正式生产,与整套参数一致 |
服务商 → ZOO:在当前应用配置列表复制“回调地址”。分站应用通常为 https://s.198600.xyz/api/v1/notify/alipay/你的ZOO应用ID;平台默认地址没有应用 ID 后缀。以后台生成地址为准,不照抄占位文本。
ZOO → 你的商店:在商店插件或面板设置 ZOO 的商户回调地址,应用“回调 Origin 白名单”仅填写它的 https://域名(不含路径)。这两个方向不能互换。
第五步:验证、保存、生效
- 按字段表填入自己取得的资料。“已开通产品”选“手机网站支付”;其它产品确实开通后再勾选。 保存过的私密字段不会回显;编辑时留空保留原值,填写新值会覆盖旧值。不要把星号或示例文字粘进去。
- 点击“验证配置”,阅读提示。验证失败时先按本页排错表修正,不要反复点击保存。验证主要检查凭据、格式或接口连通性,不能证明每种支付产品、到账和回调都已完成。
- 点击“保存草稿”。若弹出安全确认,按页面要求在自己的浏览器完成邮箱或双因素验证,勿将验证码发给他人。草稿保存后回到配置列表。
- 复核当前选中的应用、测试/正式环境和回调地址,再点击这一行“生效”。确认状态变为“已生效”。生效影响该应用之后的支付,请在业务允许的时间操作。
- 从已接入的测试商店或面板生成一笔新订单,选择本教程渠道。不要重新使用过期订单,也不要把“返回成功页面”当成到账。检查 ZOO“支付订单”、服务商交易记录和“商户回调”。
ZOO 下单时会把当前应用对应的 notify_url 传给支付宝,通常不需要你另写通知代码。若支付宝控制台或你的业务接入要求填写通知地址,用 ZOO 当前应用显示的“回调地址”;不要填写 ZOO“系统设置”的网页 URL。
第六步:按这个渠道测试
- 使用手机系统浏览器打开新订单,选择“[官方] 支付宝手机网站支付”。
- 应打开支付宝支付页或拉起支付宝 App;先检查金额与收款主体。微信内无法唤起时复制订单链接到系统浏览器打开,勿重复创建多笔付款。
- 支付后回到订单页,并分别核对支付宝交易、ZOO SUCCESS 与业务回调。不要只验证电脑端就宣布 WAP 通过。
| 现象 | 处理办法 |
|---|---|
| 验证通过但支付时报产品未开通 | 在支付宝同一个 APPID 核对当前产品生效状态;只勾选真实开通产品 |
| 沙箱能打开,正式打不开 | 正式 APPID/密钥/证书/网关是否成套,正式应用是否审核完成 |
| 支付成功但业务端未收到 | 先看 ZOO 是否 SUCCESS,再看商户回调投递与业务端验签处理 |
| 私钥/公钥不能解析 | 直接粘贴本地文件完整内容,检查换行及格式;不要用本机路径或星号 |
官方资料与延伸阅读
资料核对:2026-10-03。本文按 ZOO 当前字段整理,未复制真实账号凭据。服务商的资格、费率和审核结果由服务商决定。
操作结果确认
- ZOO 应用允许此渠道,支付宝同一 APPID 的对应产品已开通。
- 整套参数环境一致,所选应用配置显示已生效。
- 本渠道新订单的真实到账、ZOO 状态及业务端回调均已核对。
本页操作视频
与本页主动画使用同一分镜。视频按 1.5× 导出,32 秒;付款与凭据操作由本人完成。
常见问题
公钥和私钥怎么区分?
应用私钥只由你保管,填入 ZOO 私钥栏;应用公钥提交给支付宝;支付宝公钥从官方后台取得,填入 ZOO 公钥栏。三者不能互换。
已经有扫码支付,电脑/手机支付也一定能用吗?
不一定。三个支付产品分别开通;ZOO 的应用渠道、配置中已开通产品及支付宝实际签约必须一致。
提示权限不足或产品未开通怎么办?
检查当前 APPID 及产品签约状态。验证通过不能代替正式产品开通,正式新订单才是该产品的验收。
签名错误/证书解析错误怎么办?
检查环境与 APPID、私钥对应的公钥是否已上传、是否把应用公钥当成支付宝公钥、是否漏了 BEGIN/END 和换行。证书模式核对三份文件用途。
保存之后怎么还是旧配置?
保存草稿不会启用新配置;确认选对应用,再点对应行“生效”,用新订单测试。
编辑时密钥输入框空着,是不是丢了?
私密字段保存后不会回显。已配置字段留空保留原值;重新输入会覆盖。首次新增仍需填写必要参数。
我没有申请到官方账号,可以先照抄教程参数吗?
不能。示例和图中的值都不可用于支付。必须取得自己有权使用的账户和参数;未开通的产品先不要启用。