交易接入 / 操作与配置

商户应用:创建并保存接入凭据

创建业务应用,选择支付渠道和回调来源,并安全保存 App ID 与 App Secret。

本篇操作教程02 个章节

01 / 准备条件

02 / 分步操作

03 / 结果检查

适用角色
商户用户、平台管理员
操作动画
2 段 · 可播放与逐步查看
内容核验
2026-09-23
使用前准备
  • 账号具备创建商户应用的权限和有效订阅。
  • 已确定应用名称、计划使用的支付渠道,以及接收回调的 HTTPS Origin。
让 AI 陪你按步骤操作

完整步骤、条件与验收要求。填入自己的业务目标,不要在聊天中粘贴密钥。

查看 / 手动复制完整提示词

关联阅读:11 个支付渠道 · 系统设置 · 商户回调

01

从准备到结果确认

查看这段动画的完整步骤
  1. 新建应用

    入口:商户应用 → 新建应用。

    应用出现在列表中,状态和允许渠道正确。

  2. 填写名称

    应用名称:本人的业务应用。

    App ID 已保存,App Secret 已存入可信的服务端配置。

  3. 选择渠道

    允许支付渠道:至少一种,需有收款资格。

    回调 Origin 与业务系统实际使用的域名一致。

  4. 填写 Origin

    回调 Origin 白名单:https://merchant.example.com。

    回调 Origin 与业务系统实际使用的域名一致。

  5. 提交应用

    所属商户:管理员复核归属 / 商户限本人。

    回调 Origin 与业务系统实际使用的域名一致。

  6. 保管凭据

    App ID / App Secret:Secret 只存可信服务端。

    回调 Origin 与业务系统实际使用的域名一致。

02

创建应用

查看这段动画的完整步骤
  1. 打开“商户应用”

    打开“商户应用”,点击“新建应用”。

    应用出现在列表中,状态和允许渠道正确。

  2. 填写应用名称

    填写应用名称。平台管理员还需选择或填写应用所属商户。

    App ID 已保存,App Secret 已存入可信的服务端配置。

  3. 至少选择一个支付渠道

    至少选择一个支付渠道。这里只决定应用允许使用的范围,渠道本身仍需在“系统设置”中完成配置。

    回调 Origin 与业务系统实际使用的域名一致。

  4. 按需填写“回调 Origin 白名单”

    按需填写“回调 Origin 白名单”。格式应为完整 Origin,例如 https://merchant.example.com,不要包含路径。

    回调 Origin 与业务系统实际使用的域名一致。

  5. 操作 5

    提交后立即保存 App ID 与 App Secret。系统自动生成 App Secret,页面不承诺固定字符位数。

    回调 Origin 与业务系统实际使用的域名一致。

详细操作与条件

应用可自行维护

普通商户可编辑本人应用名称、授权范围内的通道和回调 Origin,并启用/停用应用;停用后可归档,历史订单保留。不能更改商户归属或修改他人应用。账户和权限问题可从在线客服与帮助求助。

第一次配置?按 11 个渠道逐项操作

勾选支付渠道只是允许该应用使用,实际收款还要从官方或上游取得参数,在正确应用的系统设置中验证、保存草稿并生效。

打开 11 个渠道配置图文教程目录 ↗:按你的渠道查看申请条件、参数获取、ZOO 字段对照、操作配图和到账回调验收。

创建应用
  1. 打开“商户应用”,点击“新建应用”。
  2. 填写应用名称。平台管理员还需选择或填写应用所属商户。
  3. 至少选择一个支付渠道。这里只决定应用允许使用的范围,渠道本身仍需在“系统设置”中完成配置。
  4. 按需填写“回调 Origin 白名单”。格式应为完整 Origin,例如 https://merchant.example.com,不要包含路径。
  5. 提交后立即保存 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 忘记保存怎么办?

按后台当前提供的“复制密钥”能力重新获取;不要通过聊天、邮件正文或公开日志传递密钥。