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. 分账相关指引

分账订阅-商户使用指引

分账订阅服务 — 商户使用指引#


一、服务简介#

分账订阅服务是为使用分账功能的商户提供的按年/半年订阅的接收方配额管理服务。
开通订阅后,您将获得:
分账接收方配额:根据所选套餐,享有对应数量的分账接收方创建额度
分账功能使用权:在订阅有效期内,正常使用分账相关功能

二、产品套餐介绍#

我们提供多种产品套餐供您选择,不同套餐拥有不同的接收方上限和年费标准。例如:
套餐类别接收方上限年费标准适用场景
A类 基础版较低较低适合小规模分账业务
B类 标准版中等中等适合一般分账业务
C类 专业版较高较高适合中大规模分账业务
D类 企业版最高最高适合大规模分账业务
具体的接收方上限和费用标准以页面实际展示为准。

缴费方式#

年付:按年费标准一次性支付一年费用
半年付:按半年计费,每半年支付一次。半年付费用 = 年费 × 半年付费率(例如年费 1000 元、半年付费率 55%,则每半年需支付 550 元,一年合计 1100 元)
半年付方式按半年结算,灵活性更高,但总费用会略高于年付。如果预算确定,推荐选择年付更划算。

三、如何开通订阅#

操作路径#

进入商户平台 → 分账功能 → 订阅管理 → 我的订阅

开通步骤#

1.
如果您尚未订阅,页面会显示"您还未订阅分账方案"的提示,点击 「选择分账方案」 按钮
2.
进入产品选择页面后,浏览各套餐的接收方上限、年费标准、半年付费用等信息
3.
选择适合您的套餐,点击 「选择此方案」
4.
进入缴费页面,选择缴费方式(年付或半年付),确认费用明细
5.
点击 「确认开通」,费用将从您的手续费钱包中自动扣除
6.
支付成功后,订阅立即生效,页面会显示缴费单号供您留存

余额不足怎么办?#

如果手续费钱包余额不足,系统会提示扣费失败。请先为手续费钱包充值,然后重新操作即可。

四、我的订阅#

开通订阅后,在「我的订阅」页面您可以查看以下信息:

基本信息#

产品类别:您当前订阅的套餐名称
到期时间:订阅的有效截止日期,以及剩余天数(到期前 30 天内会有醒目提醒)
缴费方式:年付 或 半年付
订阅编号:您的订阅唯一编号,如需咨询问题请提供此编号

配额使用情况#

已创建接收方数 / 上限:展示您已使用的接收方数量和最大上限
剩余可创建:还可以新增的接收方数量
进度条:直观展示配额使用比例(使用率较高时会以醒目颜色提示)
如果有临时扩容,会额外显示扩容数量及到期时间

提醒信息#

试用中的商户会看到试用到期时间提醒
临时扩容即将到期时(3 天内)会有警告提示
订阅逾期时会显示逾期天数和欠费金额
有未支付的缴费单时,页面顶部会有醒目的待支付提醒

五、续费#

什么时候续费?#

建议在订阅到期前及时续费,避免因过期影响分账功能的正常使用。

操作步骤#

1.
在「我的订阅」页面,点击 「续费」 按钮
2.
选择缴费方式:年付 或 半年付
3.
确认费用明细(原价、折扣、实付金额)
4.
点击 「确认续费」
5.
费用从手续费钱包自动扣除,订阅有效期自动延长

续费说明#

年付:有效期延长 1 年
半年付:有效期延长 6 个月
续费成功后,系统会显示缴费单号,您可在「缴费历史」中查看记录

六、升级套餐#

什么是升级?#

升级是指从当前套餐更换到接收方上限更高的套餐,例如从 A 类基础版升级到 C 类专业版。

费用说明#

升级需要补缴差价,系统会根据您当前订阅的剩余有效期按比例折算补差金额。
举例:当前使用 A 类(年费 12,000 元),升级到 C 类(年费 25,000 元),剩余有效期 8 个月,则需补差价 = (25,000 - 12,000) ÷ 12 × 8 ≈ 8,666 元。

操作步骤#

1.
在「我的订阅」页面,点击 「升级」 按钮
2.
查看当前套餐信息,选择要升级的目标套餐
3.
系统会展示变更对比:接收方上限变化、年费变化、需补差价金额
4.
确认无误后,点击 「确认升级」
5.
补差价从手续费钱包自动扣除,升级立即生效,接收方上限同步更新

七、降级套餐#

什么是降级?#

降级是指从当前套餐更换到接收方上限更低的套餐,例如从 C 类专业版降级到 A 类基础版。

重要提示#

降级不会立即生效,而是在下一个缴费周期开始时才生效
降级无需额外费用,但当前周期的差额不予退还
仅在订阅到期前 30 天内才可以申请降级
如果您当前的接收方数量已超过目标套餐的上限,需要先处理多余的接收方才能降级

操作步骤#

1.
在「我的订阅」页面,点击 「降级」 按钮
2.
查看当前套餐信息,选择要降级的目标套餐
3.
系统会展示变更对比,以及相关提示信息
4.
确认无误后,点击 「确认降级」
5.
系统提示"降级申请已提交,将于下个续费周期生效"
6.
下次续费时,将自动按新套餐的标准计费

八、临时扩容#

什么是临时扩容?#

当您的接收方配额临时不够用时,可以申请临时扩容,在一定时间内增加额外的接收方配额。

费用说明#

临时扩容费用 = 扩容数量 × 单位价格 × 扩容月数
举例:扩容 50 个接收方,单价 300 元/个/月,扩容 2 个月,则费用 = 50 × 300 × 2 = 30,000 元。
如果您之前有未过期的扩容,系统会自动计算旧扩容的剩余价值并进行抵扣,实际只需补缴差额。

限制说明#

单次扩容数量有上限(具体以页面提示为准)
扩容月数有上限(具体以页面提示为准)
同一商户每次扩容需间隔一定天数(冷却期),冷却期内无法再次操作

操作步骤#

1.
在「我的订阅」页面,点击 「临时扩容」 按钮
2.
在弹窗中输入扩容数量,选择扩容月数
3.
系统实时计算并展示费用明细(含旧扩容抵扣信息)
4.
确认后,费用从手续费钱包自动扣除,扩容立即生效

扩容到期说明#

临时扩容到期后,已有的接收方不受影响,但无法新增超出基础配额的接收方
如需继续使用额外配额,请重新申请扩容

九、申请试用#

试用资格#

每个商户可免费试用一次分账订阅服务。如果您从未开通过订阅,可以先申请试用体验。

试用说明#

试用时长:3 天
试用费用:免费
试用套餐:A 类基础版
试用权限:试用期间享有与正式订阅相同的功能权限

如何申请#

1.
进入产品选择页面(「我的订阅」→「选择分账方案」)
2.
在页面底部点击 「申请免费试用」
3.
申请成功后,自动跳转到「我的订阅」页面,即可开始使用

试用到期#

试用到期后,分账功能将无法继续使用
不会自动扣费,您需要手动选择套餐开通正式订阅
建议在试用期间评估业务需求,提前选择合适的套餐

十、缴费历史#

在哪里查看?#

在「我的订阅」页面,点击 「缴费历史」 按钮,即可查看所有缴费记录。

记录内容#

每条缴费记录包含以下信息:
缴费单号
缴费类型(新开通、续费、升级、降级、临时扩容)
缴费方式(年付 / 半年付)
应缴金额、实缴金额
折扣信息
缴费周期
支付时间
退费金额、退费时间(如已退费)

缴费状态说明#

状态含义
待支付缴费单已创建,等待系统处理(正常情况不会出现,如遇到请联系客服)
已支付费用已扣除,对应的订阅变更已生效
已退款费用已退回手续费钱包
已取消缴费单已取消,未产生扣费

取消缴费#

如果有状态为「待支付」的异常缴费单,您可以点击 「取消缴费」 进行取消,或联系客服协助处理。

十一、常见问题#

Q:手续费钱包余额不足怎么办?
当余额不足时,系统会直接拦截操作并提示具体的余额和需支付金额。请先为手续费钱包充值,充值到账后重新操作即可,系统会自动扣费并生效。
Q:提示"已有待支付缴费订单"怎么办?
正常情况下不会出现此问题(费用扣除和生效都是自动完成的)。若遇到此提示,请联系客服处理历史异常遗留的待支付缴费单。
Q:订阅到期了怎么办?
请及时续费。订阅过期后可能影响分账功能的正常使用,建议在到期前完成续费操作。
Q:如何查看我的配额使用情况?
在「我的订阅」页面即可查看配额使用情况,包括已创建数量、上限、剩余可创建数量及进度条。
Q:降级后什么时候生效?
降级不会立即生效,会在下一个缴费周期开始时自动生效。在当前周期内,您仍然享有原套餐的配额。
Q:试用到期后会自动扣费吗?
不会。试用到期后需要您手动选择套餐并开通正式订阅,系统不会自动收取任何费用。
Q:升级后原来的有效期会变吗?
不会。升级仅更换套餐类别和接收方上限,到期时间保持不变。补差价是按剩余有效期折算的。
Q:临时扩容到期后已有的接收方会被删除吗?
不会。临时扩容到期后,已添加的接收方仍然保留,但无法新增超出基础配额的接收方。如需继续使用额外配额,请重新申请扩容。
Q:什么情况下可以退费?
仅限新开通的订阅,在开通后 30 天内可以申请退费。续费、升级、降级、扩容的缴费单不支持退费。
Q:退费金额怎么算?
退费时会扣除 1 个月的使用费用后退回。例如年付实缴 12000 元,退费金额为 12000 - 1000 = 11000 元;半年付实缴 6600 元,退费金额为 6600 - 1100 = 5500 元。
Q:退费的钱退到哪里?
自动退回您的手续费钱包,无需额外操作。
Q:退费后订阅会怎样?
退费后订阅将自动终止,分账功能将不可用。如需再次使用分账服务,需重新开通订阅。

如有其他疑问,请联系客服获取帮助。
上一页
准入可信降打扰(新增客户)
下一页
公共请求参数
Built with