交易接入 / 操作与配置
11 个支付渠道:从选应用到收款验收
以 vpnceshi 为例,先分清商户应用与支付参数,再进入每个渠道的图文教程。只配置你实际需要且具备条件的渠道。
01 / 准备条件
02 / 分步操作
03 / 结果检查
使用前准备
- 已能登录自己的 ZOO 站点。
- 知道自己的应用名称及所属商户。
- 先选一种收款方式完成,再扩展其他渠道。
01从准备到结果确认
查看这段动画的完整步骤
- 确认业务
所需渠道:只选有资格使用的收款方式。
能在商户应用找到自己的业务应用。
- 创建应用
允许支付渠道:勾选渠道不等于官方开通。
已选中正确应用,而不是误改平台默认。
- 选对范围
系统设置:本人应用 / 平台默认须区分。
每个计划启用渠道都有对应配置和验收记录。
- 准备参数
对应配置组:11 个渠道对应 7 组配置。
业务端回调/发货或充值也经过验证。
- 保存生效
验证 → 草稿 → 生效:凭据与环境成套使用。
业务端回调/发货或充值也经过验证。
- 收款验收
实际账户与业务:到账、ZOO 订单、业务回调。
业务端回调/发货或充值也经过验证。
02第二步:把 vpnceshi 选对
查看这段动画的完整步骤
- 登录你自己的 ZOO 站点
登录你自己的 ZOO 站点。示例为分站 https://s.198600.xyz,示例应用名为 vpnceshi。这里的应用名可以换成你的实际业务名。
能在商户应用找到自己的业务应用。
- 打开左侧“商户应用”
打开左侧“商户应用”,找到 vpnceshi,确认所属商户是自己。检查“默认支付范围”是否包含本教程渠道;管理员可点“编辑”调整,普通商户看不到编辑按钮时联系管理员。
已选中正确应用,而不是误改平台默认。
- 打开左侧“系统设置”
打开左侧“系统设置”。管理员先在“选择商户应用”中选 vpnceshi,不要误选“平台默认配置”。普通商户选择自己的应用,不能配置别人的应用。
每个计划启用渠道都有对应配置和验收记录。
- 列表已有“所需支付平台”时点该行“编辑”
列表已有“所需支付平台”时点该行“编辑”;没有时点“新增配置”,在“支付平台”选“所需支付平台”。本教程只处理这一个配置组。
业务端回调/发货或充值也经过验证。
03第四步:通用保存与验收顺序
查看这段动画的完整步骤
- 按字段表填入自己取得的资料
按字段表填入自己取得的资料。 保存过的私密字段不会回显;编辑时留空保留原值,填写新值会覆盖旧值。不要把星号或示例文字粘进去。
能在商户应用找到自己的业务应用。
- 点击“验证配置”
点击“验证配置”,阅读提示。验证失败时先按本页排错表修正,不要反复点击保存。验证主要检查凭据、格式或接口连通性,不能证明每种支付产品、到账和回调都已完成。
已选中正确应用,而不是误改平台默认。
- 点击“保存草稿”
点击“保存草稿”。若弹出安全确认,按页面要求在自己的浏览器完成邮箱或双因素验证,勿将验证码发给他人。草稿保存后回到配置列表。
每个计划启用渠道都有对应配置和验收记录。
- 再点击这一行“生效”
复核当前选中的应用、测试/正式环境和回调地址,再点击这一行“生效”。确认状态变为“已生效”。生效影响该应用之后的支付,请在业务允许的时间操作。
业务端回调/发货或充值也经过验证。
- 从已接入的测试商店或面板生成一笔新订单
从已接入的测试商店或面板生成一笔新订单,选择本教程渠道。不要重新使用过期订单,也不要把“返回成功页面”当成到账。检查 ZOO“支付订单”、服务商交易记录和“商户回调”。
业务端回调/发货或充值也经过验证。
详细操作与条件
第一步:先理解这三个地方
| 位置 | 你在这里做什么 | 容易混淆的地方 |
|---|---|---|
| 商户应用 | 建立业务身份,保存 ZOO App ID/App Secret,选择允许使用的渠道 | 勾选 11 个渠道不代表官方已开通或已经能收款 |
| 系统设置 → 选择商户应用 | 给指定应用填写支付宝、微信、Stripe 等收款参数 | ZOO App Secret 不等于支付宝私钥或 Stripe Secret Key |
| 官方/上游后台 | 申请收款资格、开通产品,取得 API 参数,查看实际收款 | ZOO 不能代替官方审核、银行卡开通或上游授权 |
第二步:把 vpnceshi 选对
- 登录你自己的 ZOO 站点。示例为分站
https://s.198600.xyz,示例应用名为vpnceshi。这里的应用名可以换成你的实际业务名。 - 打开左侧“商户应用”,找到
vpnceshi,确认所属商户是自己。检查“默认支付范围”是否包含本教程渠道;管理员可点“编辑”调整,普通商户看不到编辑按钮时联系管理员。 - 打开左侧“系统设置”。管理员先在“选择商户应用”中选
vpnceshi,不要误选“平台默认配置”。普通商户选择自己的应用,不能配置别人的应用。 - 列表已有“所需支付平台”时点该行“编辑”;没有时点“新增配置”,在“支付平台”选“所需支付平台”。本教程只处理这一个配置组。
管理员的“平台默认配置”会被尚未单独配置的应用继承。为 vpnceshi 保存独立配置时,只作用于所选应用;编辑前先检查是否已有继承配置。普通商户只能管理本人应用允许的配置组。页面是否显示某个渠道还受权限、订阅、参数完整性和设备状态影响。
第三步:11 个渠道逐一对应教程
11 个渠道对应 7 个支付配置组。支付宝 3 种共用一组参数;个人支付宝/微信共用个人码配置组;上游易支付支付宝/微信共用一组参数。点击下面与你需要的渠道对应的教程。
| 渠道 | 系统设置选择 | 先准备 | 当前能力 |
|---|---|---|---|
| 支付宝扫码 ↗ | 支付宝 | 官方当面付/扫码能力 | 对应产品开通后可接入 |
| 支付宝电脑网站支付 ↗ | 支付宝 | 电脑网站支付 | 对应产品开通后可接入 |
| 支付宝手机网站支付 ↗ | 支付宝 | 手机网站支付 | 对应产品开通后可接入 |
| 微信扫码(Native) ↗ | 微信支付 | 微信支付商户号及绑定 AppID | Native 接口可接入 |
| Stripe Checkout ↗ | Stripe | 可用的 Stripe 收款账户 | 托管 Checkout 可接入 |
| PayPal Checkout ↗ | PayPal | 开发者应用 Client ID/Secret | 以本站实际接入路径和开放情况为准 |
| 个人支付宝收款码 ↗ | 个人收款码 | 本人收款码、在线 Android 设备 | 有匹配到账证据才自动确认 |
| 个人微信收款码 ↗ | 个人收款码 | 本人收款码、在线 Android 设备 | 有匹配到账证据才自动确认 |
| 上游易支付支付宝 ↗ | 易支付 | 另一家兼容易支付上游的商户资料 | 取决于上游是否开通支付宝 |
| 上游易支付微信 ↗ | 易支付 | 另一家兼容易支付上游的商户资料 | 取决于上游是否开通微信 |
| 数字货币收款 ↗ | 数字货币支付 | 已启用钱包或应用专属 BSC-USDT 目标 | 只显示实际可用币种及网络 |
PayPal 请核对本站实际接入路径、环境和开放情况;保存参数不等于通道已开放或订单已到账。微信 JSAPI 属于未开放接入位,不在这 11 个已登记渠道的配置教程内。
第四步:通用保存与验收顺序
- 按字段表填入自己取得的资料。 保存过的私密字段不会回显;编辑时留空保留原值,填写新值会覆盖旧值。不要把星号或示例文字粘进去。
- 点击“验证配置”,阅读提示。验证失败时先按本页排错表修正,不要反复点击保存。验证主要检查凭据、格式或接口连通性,不能证明每种支付产品、到账和回调都已完成。
- 点击“保存草稿”。若弹出安全确认,按页面要求在自己的浏览器完成邮箱或双因素验证,勿将验证码发给他人。草稿保存后回到配置列表。
- 复核当前选中的应用、测试/正式环境和回调地址,再点击这一行“生效”。确认状态变为“已生效”。生效影响该应用之后的支付,请在业务允许的时间操作。
- 从已接入的测试商店或面板生成一笔新订单,选择本教程渠道。不要重新使用过期订单,也不要把“返回成功页面”当成到账。检查 ZOO“支付订单”、服务商交易记录和“商户回调”。
| 你看到的结果 | 说明 | 下一步 |
|---|---|---|
| 验证配置通过 | 凭据/格式/部分接口探针通过 | 仍要保存草稿、生效,并测实际订单 |
| 已生效 | 配置已被采用 | 确认应用渠道允许且新订单可打开 |
| 支付订单 SUCCESS | ZOO 已确认该订单成功 | 核对服务商实际收款,再检查商店回调及发货/充值 |
| 付款后只返回商店页面 | 页面跳转不等于到账 | 继续核对订单、到账和回调,避免重复付款 |
第五步:参数、账户和截图怎么保管
- 自己在官方后台登录、生成或查看密钥,只填进自己的 ZOO 配置页面;不要发到聊天、工单或公开截图。
- 使用密码管理器保管完整密钥。教程里的例子全部为占位内容,不能直接用于收款。
- 如果官方密钥遗失或泄露,按官方流程重新生成,再在 ZOO 的正确应用中替换、验证、生效。
- 支付宝、Stripe 等沙箱与正式环境的账号、密钥、回调必须成套使用。正式环境验收使用服务商允许的小额,支付由你本人确认。
- 没有创建测试订单按钮时,从你已接入的业务端产生订单;商户应用页面本身不是一个测试商品商店。
遇到问题先看这里
| 问题 | 先检查什么 |
|---|---|
| 看不到某个配置组 | 应用是否选对、账号权限及订阅是否满足;PayPal 当前不可用 |
| 新增弹窗找不到已配置平台 | 该组已存在时回列表点“编辑”,不要重复新增 |
| 配置生效后渠道没出现 | 应用允许渠道、对应官方产品开通情况、该组配置与设备/钱包状态 |
| 官方显示支付成功,业务端没充值 | ZOO 订单是否 SUCCESS;商户回调是否投递成功、业务端是否验签并处理 |
| 个人码设备离线 | 联系设备管理员恢复在线,再让用户重新发起新订单;不要只凭截图人工确认 |
| 数字货币付款成功但没入账 | 订单对应币种、网络、地址、金额和链上确认;保留交易哈希联系站点管理员 |
操作结果确认
- 能在商户应用找到自己的业务应用。
- 已选中正确应用,而不是误改平台默认。
- 每个计划启用渠道都有对应配置和验收记录。
- 业务端回调/发货或充值也经过验证。
本页操作视频
与本页主动画使用同一分镜。视频按 1.5× 导出,32 秒;付款与凭据操作由本人完成。
常见问题
是否必须把 11 个都配置完?
不需要。按业务和收款资格启用需要的渠道;未开通和预留渠道不要承诺给顾客。
保存之后怎么还是旧配置?
保存草稿不会启用新配置;确认选对应用,再点对应行“生效”,用新订单测试。
编辑时密钥输入框空着,是不是丢了?
私密字段保存后不会回显。已配置字段留空保留原值;重新输入会覆盖。首次新增仍需填写必要参数。
我没有申请到官方账号,可以先照抄教程参数吗?
不能。示例和图中的值都不可用于支付。必须取得自己有权使用的账户和参数;未开通的产品先不要启用。