1. 产品手册
3ypay产品接口文档
  • 1.总体介绍
    • 1.1 阅读人员
    • 1.2 名词解释
    • 1.3 调试工具说明
  • 2.接口规范
    • 2.1 接口格式定义
    • 2.2 加签验签说明
    • 2.3 参数说明
    • 2.5 内部测试版sdk
  • 3.统一交易类
    • 3.1 统一交易类指引
      • 3.1.1【微信】 扫码交易指引
      • 3.1.3【微信】小程序交易指引
      • 3.1.4【微信】JSAPI交易指引
      • 3.1.5【微信】APP交易指引
      • 3.1.6【微信】H5交易指引
      • 3.1.7【微信】资金管控业务说明
      • 3.1.8【抖音】APP交易指引
      • 3.1.9【抖音】H5交易指引
    • 3.2 统一交易类接口
      • 3.2.1 统一支付接口
      • 3.2.2 统一交易查询
      • 3.2.3 统一交易通知
      • 3.2.4 统一退款接口
      • 3.2.5 统一退款查询
      • 3.2.6 统一退款通知
  • 4.支付宝产品类
    • 4.1 安全发接口
      • 4.1.1 安全发指引
      • 4.1.2 安全发API接口
        • 4.1.2.1 单笔转账接口
        • 4.1.2.2 单笔转账查询
        • 4.1.2.3 转账异步通知
        • 4.1.2.4 转账回单申请
        • 4.1.2.5 转账回单下载
    • 4.2 直付通接口
      • 4.2.1 直付通指引
      • 4.2.2 直付通API接口
        • 4.2.2.1 统一支付接口
        • 4.2.2.2 统一交易查询
        • 4.2.2.3 统一交易通知
        • 4.2.2.4 统一交易退款
        • 4.2.2.5 统一退款查询
        • 4.2.2.6 统一退款通知
      • 4.2.3 支付宝商家转账(定制)
        • 4.2.3.1 支付宝商家转账
  • 5.订单分账类
    • 5.1 订单分账指引
      • 5.1.1 控台分账指引
        • 5.1.1.1 控台自动分账指引
        • 5.1.1.2 控台手动分账指引
      • 5.1.2 接口分账指引
    • 5.2 订单分账接口
      • 5.2.1 请求分账
      • 5.2.2 分账查询
      • 5.2.3 分账完结
      • 5.2.4 分账退款
      • 5.2.5 分账退款查询
      • 5.2.6 分账结果通知
      • 5.2.7 分账退款通知
  • 6.余额分账类
    • 6.1 余额分账指引
    • 6.2 余额分账接口
      • 6.2.1 余额分账申请
      • 6.2.2 余额分账查询
      • 6.2.3 余额分账退款
      • 6.2.4 余额退款查询
      • 6.2.5 余额分账异步通知
      • 6.2.6 余额退款异步通知
  • 7.风控管理类
    • 7.1 投诉管理类
    • 7.2 风险管理类
  • 8.商户管理类
    • 8.1 商户进件类
      • 8.1.1 进件文件上传
      • 8.1.2 商户入网申请
      • 8.1.3 商户入网信息查询
      • 8.1.4 商户结算信息变更
      • 8.1.5 商户产品信息变更
      • 8.1.6 商户信息变更查询
      • 8.1.7 进件状态通知
      • 8.1.8 变更状态通知
    • 8.2 微信支付宝管理类
      • 8.2.1 商户AUT报备查询
      • 8.2.2 微信支付配置
      • 8.2.3 微信支付配置查询
      • 8.2.4 商户AUT拆分
    • 8.3 分账接收方管理类
      • 分账接收方录入
      • 分账接收方查询
      • 分账接收方变更
      • 分账变更查询
      • 分账关系绑定
      • 分账关系解绑
      • 分账关系更新
      • 分账关系查询
      • 入网报备通知
      • 结算变更通知
  • 9. 先享后付类
    • 9.1 微信支付分
    • 9.2 支付宝先享后付
  • 10.账户管理类
    • 10.1.分账提现管理类
      • 10.1.1 分账提现申请
      • 10.1.2 分账提现查询
      • 10.1.3 提现结果通知
  • 产品手册
    • AI智能路由指引-内测
    • 商户控台操作手册
    • AT投诉渠道配置
      • 微信投诉风险渠道配置
    • AT风险处理指引
      • 微信风控处理指引
    • 抖音支付申请指引
      • 抖音支付合作商家政策
      • 抖音支付申请材料
    • 支付宝可信商户报备
      • 可信降打扰权益服务介绍
      • 商户可信降打扰(存量客户)
      • 准入可信降打扰(新增客户)
    • 分账相关指引
      • 分账订阅-商户使用指引
  • 回收站
  • 数据模型
    • 公共请求参数
    • 公共返回参数
    • 公共响应结构
    • 商户入网材料
    • 业务请求参数
    • 营业执照信息
    • 文件上传请求
    • 法人证件信息
    • 商户入网请求
    • 结算卡信息
    • 进件标识查询请求
    • 入网查询请求
    • 结算卡变更请求
    • 产品变更请求
    • 结算卡更新信息
    • 变更查询请求
    • AUT查询请求
    • 分账关系绑定请求
    • AUT微信配置请求
    • 分账关系解绑请求
    • AUT配置详情查询请求
    • 分账关系更新请求
    • 微信支付配置响应
    • 分账关系查询请求
    • 授权目录配置状态
    • 商户入网响应
    • AppId配置状态
    • 商户变更响应
    • AUT拆分请求
    • 变更审核状态响应
    • 商户基本信息
    • 分账关系响应
    • 人员证件信息
    • 余额分账申请请求
    • 商户营业执照信息
    • 余额分账明细请求
    • 商户经营信息
    • 分账查询请求
    • 经营场景信息
    • 分账退款申请请求
    • 经营资质信息
    • 分账退款明细请求
    • 商户结算卡信息
    • 分账退款查询请求
    • 对公卡信息
    • 余额分账响应
    • 签约信息
    • 分账明细响应
    • 产品开通信息
    • 余额分账退款响应
    • 产品配置详情
    • 分账退款明细响应
    • AUT查询响应
    • 提现申请请求
    • 异步通知响应结构
    • 提现查询请求
    • 进件状态通知数据
    • 提现响应数据
    • 变更状态通知数据
    • 入网报备通知数据
    • 余额分账通知数据
    • 分账明细通知
    • 余额退款通知数据
    • 提现通知数据
    • 退款明细通知
  1. 产品手册

商户控台操作手册

版本创建者创建日期
V3.0技术支持部2025-12-18
📋 免责声明:本手册中涉及的人名、公司名、品牌及产品名均为虚构示例,如与实际商业主体相似,纯属巧合。

目录#

1. 业务中心
1.1 进件列表
1.2 商户应用
1.3 应用通道
1.4 业务申请单
1.5 AUT 通道
2. 订单管理
2.1 交易订单
2.2 退款订单
2.3 通知订单
3. 财务管理
3.1 账单流水
4. 商户中心
4.1 商户信息
4.2 账号设置
4.3 权限管理
5. 安全发
5.1 发起报备
5.2 单笔下发
5.3 批量下发

1. 业务中心#

业务中心是完成商户入驻(进件)和配置支付能力的核心模块,涵盖进件申请、应用管理、通道配置等全流程操作。

1.1 进件列表#

🏷️ 功能概述:完成商户资质提交、审核、签约的全过程,是开通支付服务的第一步。
完整流程:
发起进件  →  填写并提交资料  →  等待审核  →  驳回整改(如有)  →  渠道签约  →  进件成功

步骤一:发起进件#

登录系统后台,依次点击 业务中心 > 进件列表 > 发起进件。
发起进件入口

步骤二:选择服务商与进件渠道#

在弹出页面中,选择对应的服务商和进件渠道后继续。
选择服务商和渠道

步骤三:填写进件信息#

按页面引导,依次完整填写以下四类信息,确认无误后提交:
商户信息
经营信息
结算与签约信息
产品开通信息
填写进件信息

步骤四:查看审核状态#

提交后,在列表中跟踪对应进件的审核状态。若状态显示为驳回,点击 查看详情 了解具体驳回原因。
查看审核状态

步骤五:处理驳回(如有)#

进入详情页,查看驳回原因,根据提示整改后按以下步骤重新提交:
1.
点击右上角 编辑 按钮,修改对应信息后保存;
2.
点击 重新报备,等待新一轮审核结果。
处理驳回

步骤六:渠道签约#

当状态变更为 "渠道签约中" 时,表示审核已通过,需完成签约:
1.
点击 查看详情,进入详情页;
2.
点击 立即签约,按各渠道提示完成操作。
⚠️ 注意:不同渠道的签约方式不同,请按照页面提示逐步操作,商户需自行配合完成。
渠道签约入口
签约操作页面

步骤七:确认进件成功#

完成签约后等待状态更新(通常需几分钟),状态变为 "审核成功" 即代表进件完成。
进件成功
💡 轮询功能说明:如需使用轮询,重复上述进件流程,每次选择不同的渠道。注意:相同主体进件次数不得超过 2 次。

1.2 商户应用#

🏷️ 功能概述:商户进件成功后,系统自动生成一个默认应用,对应唯一的 APPID。此 APPID 是后续与技术团队进行 API 接口对接的唯一标识,请妥善保管。
商户应用页面

1.3 应用通道#

🏷️ 功能概述:管理已成功进件的各个支付渠道,支持配置轮询策略、调整支付方式及管理通道启用状态。
进件审核成功后,系统自动生成对应的应用通道。如需启用轮询,可通过不同主体多次进件(每次选择不同渠道),然后在应用通道列表中将对应通道的启用开关打开。
应用通道列表
停用通道:若某通道因投诉被停用,可在应用通道列表中手动关闭其启用状态。
关闭通道
修改轮询权重 / 支付方式:点击 编辑 可直接修改支付方式和轮询权重。
💡 权重说明:轮询权重数值越大,该通道在轮询中的优先级越高。
编辑轮询权重
轮询权重设置

1.4 业务申请单#

🏷️ 功能概述:查看费率等业务信息的变更记录,记录所有产品调整历史。
如需调整费率,请联系销售人员说明需求;调整完成后,可在业务申请单中看到一条 "产品变更" 记录。
业务申请单列表
点击 详情 可查看具体变更内容,通过对比 "业务变更前" 和 "业务变更后" 两列数据,清晰了解调整内容。
业务变更详情

1.5 AUT 通道#

🏷️ 功能概述:AUT 通道用于管理微信、支付宝、云闪付三种主流支付方式的认证状态。
根据进件时所开通的支付产品,AUT 通道会展示对应支付方式的认证情况。
AUT 通道列表
情况一:审核驳回
查看驳回原因,根据原因重新整改进件后再次提交。
驳回原因
情况二:待确认联系信息
需要法人或负责人扫描页面右侧二维码,完成身份验证后方可继续。
扫码验证

2. 订单管理#

⚠️ 重要提示:进件资料全部提交且审核成功后,须联系技术人员完成与我司的接口对接,对接完成后方可正常发起交易。

2.1 交易订单#

2.1.1 交易查询#

进入 交易订单 页面,可查看每日交易记录。如需精准筛选,可在页面顶部筛选栏中设置查询条件(如时间范围、订单号、支付方式等)。
交易订单列表

2.1.2 查看交易明细#

点击目标交易右侧的 详情 按钮,可查看该笔交易的完整数据信息。失败订单可在详情中查看失败原因。
交易详情入口
交易详情内容

2.1.3 退款操作#

⚠️ 注意:仅状态为 "成功" 的交易才能发起退款操作。
操作步骤:
1.
在交易列表中找到目标交易,点击 退款 按钮;
退款按钮
2.
在弹窗中填写退款金额、交易密码和退款原因,确认后提交,退款即完成。
填写退款信息

2.2 退款订单#

🏷️ 功能概述:集中查询所有退款操作的记录,支持查看退款状态和退款详情。
在退款订单页面可查看退款记录列表,点击 详情 可查看每笔退款的具体信息。
退款订单列表
退款详情

2.3 通知订单#

🏷️ 功能概述:每笔交易产生后,系统会自动向商户预设的异步推送地址发送一条通知消息,此处可查看所有通知的推送记录与状态。
通知订单列表
若通知推送失败,点击 详情 查看详细信息,重点核查异步推送地址配置是否正确。
通知详情

3. 财务管理#

3.1 账单流水#

🏷️ 功能概述:查询所有资金变动记录,包括外扣手续费充值、手动扣款等,可清晰查看每笔操作的变动前余额、变动金额和变动后余额。

3.1.1 查询账单流水#

进入 财务管理 > 账单流水,即可查询全部资金变动记录,支持按时间、类型等条件筛选。
账单流水列表

3.1.2 核对钱包余额#

余额发生变动后,可进入 商户中心 > 商户信息 > 我的钱包 查看当前余额,核对是否与充值或扣款金额一致。
我的钱包

4. 商户中心#

4.1 商户信息#

🏷️ 功能概述:集中查看进件时提交的全部资料,包括开通产品、费率、结算信息等。

4.1.1 基础信息#

查看进件签约的基础资料,包括:所属服务商、所属渠道、外扣费率、超管账号、超管姓名、超管邮箱等。
基础信息

4.1.2 商户信息#

查看进件主体的基本工商资料信息。
商户信息

4.1.3 经营信息详情#

查看进件主体的经营场所、经营范围等相关资料。
经营信息

4.1.4 签约信息详情#

查看进件主体的结算账户及签约相关信息。
签约信息

4.1.5 产品开通信息详情#

查看已开通的支付产品及其费率、结算产品及其费率等信息。
📌 说明:页面内数据均为示例,不作为实际参考依据。
产品开通信息

4.1.6 AUT 信息详情#

查看已开通的支付方式(微信、支付宝、云闪付)及各方式的开通状态。
AUT 信息

4.1.7 安全发#

查看安全发产品的相关信息。若未开通安全发业务,此处信息为空。
安全发信息

4.1.8 我的钱包#

查看当前钱包余额,支持自行充值。
📌 说明:此账户为外扣手续费账户,专用于交易时产生的手续费扣款。充值记录可在 财务管理 > 账单流水 中查看。
我的钱包

4.2 账号设置#

🏷️ 功能概述:管理账户安全信息,包括登录密码、绑定手机号和交易密码的修改。
进入 商户中心 > 账号设置,可进行以下操作:
账号设置入口

4.2.1 修改登录密码#

按以下顺序操作:输入新密码 → 确认新密码 → 输入验证码
📌 验证码将发送至进件时填写的超管手机号。
修改登录密码

4.2.2 修改手机号#

按以下顺序操作:输入旧手机号 → 获取并填写验证码 → 输入新手机号 → 获取并填写新手机验证码 → 提交修改
修改手机号

4.2.3 修改交易密码#

按以下顺序操作:输入新密码 → 确认新密码 → 输入验证码
修改完成后,转账和资金下发等操作均需使用新的交易密码。
⚠️ 重要提示:登录密码用于系统登录,交易密码用于资金操作,二者相互独立,请勿混淆。
修改交易密码

4.3 权限管理#

🏷️ 功能概述:支持为不同部门或职责的员工创建角色并分配差异化权限,实现精细化权限管控。

4.3.1 角色管理#

角色是权限的载体,创建角色后可为其分配系统功能权限,再将角色绑定到具体用户。
创建角色#
1.
进入 商户中心 > 权限管理 > 角色管理,点击 新增;
角色管理入口
2.
上级角色选择 商户管理员(拥有最高权限,可管理所有角色及功能),填写角色名称(例如:市场部);
填写角色信息
3.
创建成功后,点击 设置后台管理系统,进入权限分配页面;
📌 说明:安全发控台权限配置功能暂未开放,后续将陆续支持。
选择权限系统
4.
在权限分配页面,勾选该角色所需的功能模块权限,保存即可生效。
分配功能权限

创建子角色#
子角色是在已有角色下进一步细分的下级角色,其权限不得超过上级角色。
1.
在已有角色(如市场部)的列表中,点击 新增;
新增子角色
2.
上级角色选择 市场部,填写子角色名称(例如:市场 1 部),提交;
填写子角色信息
3.
选择 市场 1 部 > 页面管理 > 后台管理系统,进入权限调整页面;
进入子角色权限设置
4.
为市场 1 部勾选合适的功能权限(权限范围限于市场部已有权限之内)。
子角色权限分配
💡 按照上述方法,可依次创建其他部门及分部门,并为每个角色分配合适的权限。

4.3.2 用户管理#

用户管理用于为具体员工创建账号,并绑定对应角色,员工登录后即可使用该角色的全部权限。
创建用户#
1.
在用户列表页面,点击左上角 新增;
新增用户
2.
按要求填写用户的完整信息,在 默认角色 中选择合适的角色(如:市场部),提交;
填写用户信息
3.
用户创建完成,该用户自动获得所绑定角色的全部权限,后续可使用账号密码登录系统。
用户创建成功

为用户分配多个角色#
若某员工需跨部门使用多个角色的权限,可在用户信息中同时选中多个角色,该用户将拥有所选全部角色的权限。
多角色分配
多角色效果展示
💡 也可单独为该员工创建一个专属角色,将所需权限全部勾取后赋予该用户,操作步骤同上。

5. 安全发#

⚠️ 使用前提:使用安全发功能前,需已开通"安全发"业务,否则相关入口不可用。

5.1 发起报备#

5.1.1 进入安全发控台#

在平台右上角点击 安全发控台,系统将直接跳转至安全发控台。
安全发控台入口

5.1.2 发起报备#

进入安全发控台后,依次点击 报备管理 > 报备列表 > 发起报备。
发起报备

5.1.3 填写并提交报备信息#

按页面提示完整填写所有报备信息,确认无误后点击 提交报备。
填写报备信息

5.1.4 等待审核,确认激活#

提交报备后等待审核,当签约状态变为 "正常" 时,即可开始使用安全发功能。
报备审核状态

5.1.5 首次使用:充值记账本#

首次使用安全发前,需先进行充值(充值额度即为可用下发额度):
1.
在报备列表中,点击对应记录的 详情;
进入详情充值
2.
选择 记账本信息余额 > 支付宝充值,填写充值金额,完成支付。
支付宝充值
充值确认

5.2 单笔下发#

5.2.1 进入单笔下发页面#

在安全发控台中,点击 资金管理 > 单笔下发。
单笔下发入口

5.2.2 选择记账本账户并输入金额#

选择报备时创建的记账本账户,输入本次下发的转账金额。
选择账户填写金额

5.2.3 选择收款方账户类型#

根据收款方实际情况,选择下发目标类型(默认推荐转至支付宝账户):
转账类型所需填写信息说明
支付宝账户收款方支付宝账号、收款人姓名最常用,推荐优先选择
银行账户对公 / 对私、银行卡号、收款人姓名适用于对公或对私银行卡转账
他人记账本账号对方记账本账户、收款人姓名较少使用
选择产品类型

5.2.4 提交下发#

将所有下发信息完整填写后,点击 提交下发。
📌 付款方别名:可根据业务需求,选择是否在下发时展示付款方名称。
提交下发

5.2.5 查看下发结果#

提交后在转账列表中查看下发记录,等待三方渠道审核。状态变为 "成功" 时,表示下发完成。
下发结果

5.3 批量下发#

批量下发支持两种操作方式,可按实际情况选择:
方式适用场景
方式一:逐步录入人员较少,逐一操作
方式二:模板导入人员较多,批量处理,效率更高

方式一:逐步录入方式#

第一步:录入下发人员
进入 项目与人员 > 人员管理 > 新增,依次录入以下信息后提交:
姓名、身份证号、手机号
结算类型:选择支付宝账户或银行账户
收款账号:填写对应账号
签约类型:默认选择电子协议
人�员管理入口
录入人员信息
提交后,在人员列表中确认人员信息已正确录入。
人员列表确认

第二步:创建下发项目
在 项目管理 中点击 新增,填写项目名称(如:2025年12月工资下发),状态选择 启用,提交。
新增项目入口
填写项目信息

第三步:绑定人员至项目
1.
在项目列表中,点击项目右侧的 绑定;
绑定入口
2.
进入绑定页面,点击 新增绑定人员,选择已录入的人员;
新增绑定人员
3.
人员出现在列表中后,点击底部 提交 完成绑定。
绑定完成提交

第四步:创建付款单
进入 付款单管理 > 付款单列表 > 新增。
新增付款单

第五步:导入人员并填写下发金额
选择对应的记账本和项目,点击 导入项目人员,已绑定人员将自动出现,在每位人员后填写本次下发金额,确认无误后提交。
导入人员填写金额

第六步:查看批量下发结果
提交后在付款单列表中查看状态,等待状态变为 "成功",批量下发完成。
付款单结果

方式二:模板导入方式#

💡 适用场景:下发人员较多时推荐使用,操作效率更高。使用前需先完成方式一的第一步(录入人员信息)。
第一步:下载模板
进入 付款单管理 > 付款单列表 > 新增,点击页面中的下载模板按钮。
下载模板

第二步:填写模板并保存
在下载好的模板文件中,逐行填写下发人员信息和对应的下发金额,填写完成后保存文件。
填写模板

第三步:上传并提交
点击 上传付款单,导入填好的文件;导入后核对数据无误,确认后提交。
上传付款单

— 文档结束 —
如在使用过程中遇到任何问题,请联系技术支持部获取协助。
上一页
AI智能路由指引-内测
下一页
微信投诉风险渠道配置
Built with