交易接入 / 操作与配置
商户应用:创建并保存接入凭据
创建业务应用,选择支付渠道和回调来源,并安全保存 App ID 与 App Secret。
01 / 准备条件
02 / 分步操作
03 / 结果检查
使用前准备
- 账号具备创建商户应用的权限和有效订阅。
- 已确定应用名称、计划使用的支付渠道,以及接收回调的 HTTPS Origin。
01从准备到结果确认
查看这段动画的完整步骤
- 新建应用
入口:商户应用 → 新建应用。
应用出现在列表中,状态和允许渠道正确。
- 填写名称
应用名称:本人的业务应用。
App ID 已保存,App Secret 已存入可信的服务端配置。
- 选择渠道
允许支付渠道:至少一种,需有收款资格。
回调 Origin 与业务系统实际使用的域名一致。
- 填写 Origin
回调 Origin 白名单:https://merchant.example.com。
回调 Origin 与业务系统实际使用的域名一致。
- 提交应用
所属商户:管理员复核归属 / 商户限本人。
回调 Origin 与业务系统实际使用的域名一致。
- 保管凭据
App ID / App Secret:Secret 只存可信服务端。
回调 Origin 与业务系统实际使用的域名一致。
02创建应用
查看这段动画的完整步骤
- 打开“商户应用”
打开“商户应用”,点击“新建应用”。
应用出现在列表中,状态和允许渠道正确。
- 填写应用名称
填写应用名称。平台管理员还需选择或填写应用所属商户。
App ID 已保存,App Secret 已存入可信的服务端配置。
- 至少选择一个支付渠道
至少选择一个支付渠道。这里只决定应用允许使用的范围,渠道本身仍需在“系统设置”中完成配置。
回调 Origin 与业务系统实际使用的域名一致。
- 按需填写“回调 Origin 白名单”
按需填写“回调 Origin 白名单”。格式应为完整 Origin,例如 https://merchant.example.com,不要包含路径。
回调 Origin 与业务系统实际使用的域名一致。
- 操作 5
提交后立即保存 App ID 与 App Secret。系统自动生成 App Secret,页面不承诺固定字符位数。
回调 Origin 与业务系统实际使用的域名一致。
详细操作与条件
应用可自行维护
普通商户可编辑本人应用名称、授权范围内的通道和回调 Origin,并启用/停用应用;停用后可归档,历史订单保留。不能更改商户归属或修改他人应用。账户和权限问题可从在线客服与帮助求助。
第一次配置?按 11 个渠道逐项操作
勾选支付渠道只是允许该应用使用,实际收款还要从官方或上游取得参数,在正确应用的系统设置中验证、保存草稿并生效。
打开 11 个渠道配置图文教程目录 ↗:按你的渠道查看申请条件、参数获取、ZOO 字段对照、操作配图和到账回调验收。
创建应用
- 打开“商户应用”,点击“新建应用”。
- 填写应用名称。平台管理员还需选择或填写应用所属商户。
- 至少选择一个支付渠道。这里只决定应用允许使用的范围,渠道本身仍需在“系统设置”中完成配置。
- 按需填写“回调 Origin 白名单”。格式应为完整 Origin,例如
https://merchant.example.com,不要包含路径。 - 提交后立即保存 App ID 与 App Secret。系统自动生成 App Secret,页面不承诺固定字符位数。
创建后可以做什么
| 项目 | 用途 | 注意事项 |
|---|---|---|
| App ID | 标识当前业务应用 | 可在列表中复制 |
| App Secret | 用于服务端请求认证 | 只保存在可信服务端,不放入网页、截图或工单 |
| Merchant API 根地址 | 进入商户 API | 以后台“接入地址”显示为准 |
| Swagger | 查看当前接口定义 | 开发前以在线定义核对字段 |
| 托管收银台入口 | 打开 ZOO 托管的支付页面 | 实际订单应使用接口返回的收银台地址 |
不同角色的操作范围
商户用户可创建、编辑、启用、停用和归档自己的应用,并复制本人接入凭据;归档保留历史订单。平台管理员维护商户归属,普通商户不能修改他人应用。
操作结果确认
- 应用出现在列表中,状态和允许渠道正确。
- App ID 已保存,App Secret 已存入可信的服务端配置。
- 回调 Origin 与业务系统实际使用的域名一致。
本页操作视频
与本页主动画使用同一分镜。视频按 1.5× 导出,32 秒;付款与凭据操作由本人完成。
常见问题
为什么没有编辑或停用按钮?
先确认当前应用属于本人、订阅权限有效并已更新到当前版本。商户可维护本人应用,商户归属由平台管理员维护。
App Secret 忘记保存怎么办?
按后台当前提供的“复制密钥”能力重新获取;不要通过聊天、邮件正文或公开日志传递密钥。