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. 产品手册

AI智能路由指引-内测

AI 智能支付路由系统 — 产品能力说明--内测产品#

版本:v2.0 · 更新时间:2026-03-15
适用对象:商户、运营、产品团队

一、这套系统是做什么的?#

每笔支付订单发起时,系统需要在多条支付通道中选出一条来处理。传统做法是人工配置固定规则,"按权重轮流用"或"哪个好用用哪个",无法感知通道实时状态。
AI 智能路由的核心价值是:
实时感知:持续监控每条通道的成功率、失败率、稳定趋势、风控感知,每60秒刷新一次评分
智能决策:每笔订单下单前,在毫秒内选出当前综合表现最优的通道
自动保护:通道质量异常时自动熔断隔离,恢复后自动重新纳入
持续学习:每笔支付结果都作为训练数据,权重模型每小时自动优化
风控结合:根据AI风控系统强大感知能力,实时提前感知AT渠道侧风险进行预警,在AT风险之前进行感知,有效提高通道可用性,接收到风控系统预警后系统将自动隔离该通道进行熔断隔离,风控系统感知可用后会向AI智能路由系统发送解除通知,接收后自动重置AI总体评分
最终效果是:商户无感知,支付成功率持续提升,异常通道自动规避。

二、整体决策流程#

每笔订单的路由决策分两个阶段串行执行:
订单进来
    │
    ▼
┌─────────────────────────────────────┐
│  第一阶段:规则引擎                  │
│  按业务规则过滤明显不合适的通道       │
│  结果:得到一个"候选通道池"           │
└────────────────┬────────────────────┘
                 │
                 ▼
┌─────────────────────────────────────┐
│  第二阶段:AI 决策引擎               │
│  对候选通道池进行 AI 评分和融合打分   │
│  结果:选出当前最优通道              │
└────────────────┬────────────────────┘
                 │
                 ▼
            返回最优通道,发起支付
两个阶段各司其职:规则引擎负责"排除不行的",AI 引擎负责"从剩下的里选最好的"。

三、规则引擎详解#

3.1 规则引擎的作用#

规则引擎是第一道过滤关,用于解决明确的业务约束,例如:
这笔订单是微信支付,某条通道不支持微信,直接排除
这条通道最近5分钟成功率只有30%,明显在抖动,排除
大额订单(≥5000元)必须走指定的高质量专属通道
夜间时段某些通道表现历史性偏差,夜间自动绕开
根据历史订单AI模型自动判定该通道可能触碰到AUT渠道风险阈值,自动排除
规则引擎的优点是可配置、可即时生效、逻辑透明,运营人员可以随时添加、修改、禁用规则,无需发版。

3.2 规则触发逻辑#

每条规则由三部分组成:条件 + 逻辑 + 动作。
条件:检查通道的某个指标是否满足阈值
逻辑:多个条件之间是 AND(全部满足)还是 OR(任一满足)
动作:满足条件时对通道做什么处理
条件逻辑
逻辑类型说明典型场景
AND 全部满足所有条件都成立,规则才触发"成功率低 且 响应慢"才过滤,避免误伤
OR 任一满足任意一个条件成立,规则即触发"成功率低 或 AI分低"就过滤,更宽松

3.3 可配置的条件字段(14个)后续将增加更多,也可进行定制化新增#

规则条件支持以下14个字段,覆盖通道实时指标、AI评分、通道属性、订单维度四个维度:

实时成功率(7个时间窗口)#

这是规则引擎最核心的条件字段,反映通道在不同时间窗口内的历史支付成功率:
字段时间窗口数据来源推荐场景
success_rate_1m近 1 分钟实时滑动窗口计算紧急异常快速响应,敏感度最高
success_rate_5m近 5 分钟实时滑动窗口计算日常首选,兼顾实时性与稳定性
success_rate_10m近 10 分钟实时滑动窗口计算中等敏感度规则
success_rate_30m近 30 分钟实时滑动窗口计算持续性低成功率检测
success_rate_1h近 1 小时数据库聚合统计综合评估,AI评分的核心输入
success_rate_6h近 6 小时数据库聚合统计夜间等周期性规则
success_rate_24h近 24 小时数据库聚合统计长期稳定性基准
成功率值范围 0~1,支持百分比写法,"80%" 与 "0.8" 等效。

AI 综合评分#

字段说明
ai_scoreAI 综合评分(0~100分),由 AI 引擎每60秒计算一次

通道自身属性#

字段说明
channel_status通道状态:1=启用,0=停用
weight商户对该通道设置的权重(1~100)
pay_way_code通道支持的支付方式列表

当次订单维度#

字段说明
order_amount本笔订单金额(单位:元)
order_hour当前小时(0~23),支持跨零点时间段

3.4 规则动作(3种)#

动作说明典型使用场景
过滤(exclude)将命中条件的通道从候选池移除成功率过低、不支持该支付方式
白名单路由(include_only)只允许指定通道参与决策,其余全部排除大额订单走专属VIP通道
轮询切换(rotation)按金额或失败次数阈值在通道间轮流切换平衡多通道流量分配、规避单通道限额

3.5 规则执行顺序#

① 平台全局规则(对所有商户生效)优先执行
   ↓
② 商户专属规则(仅对指定商户生效)后执行
   ↓
③ 同类规则内按优先级从高到低执行
   ↓
④ 前一条规则已过滤的通道,不会被后续规则重复处理

3.6 规则配置示例#

示例1:近5分钟成功率低于80%,自动过滤该通道
条件:success_rate_5m < 80%
逻辑:AND
动作:过滤
说明:5分钟内成功率低于80%说明通道正在抖动,直接移出候选池
示例2:大额订单(≥5000元)强制走VIP专属通道
条件:order_amount ≥ 5000
逻辑:AND
动作:白名单路由 → 指定 VIP通道A、VIP通道B
说明:大额资金对稳定性要求更高,强制走高质量专属通道
示例3:夜间(22:00-次日06:00)AI评分低于50分的通道过滤
条件:success_rate_1h < 85% AND ai_score < 50
时间:22:00 ~ 06:00,每天生效
动作:过滤
说明:夜间运营人员值守少,加强过滤条件,减少人工干预需求
示例4:成功率5分钟OR1小时任一过低都过滤(双窗口保险)
条件:success_rate_5m < 50% OR success_rate_1h < 70%
逻辑:OR(任一满足即触发)
动作:过滤
说明:短期急剧恶化(5min)或长期持续差(1h)都会被识别并过滤
示例5:按日累计金额轮询切换通道(超10万换下一个)
条件:(无条件,持续生效)
动作:轮询切换
轮询类型:当日累计金额超过 10万元 时切换到下一条通道
冷却时间:5分钟内不重复触发切换
说明:避免单通道承载过多金额,规避限额和风控

四、AI 决策引擎详解#

4.1 AI 引擎的作用#

规则引擎过滤后,剩余的候选通道都是"符合基本条件的",但质量仍有高低之分。AI 决策引擎的任务是:在候选通道里,选出当前综合表现最优的那一条。
AI 引擎不依赖人工配置规则,而是从历史支付数据中自动学习,识别每条通道的真实能力。

4.2 AI 评分模型:四维评分#

每条通道都有一个 0~100 分的 AI 综合评分,由四个维度加权计算:
AI评分 =
    成功率得分  × 50%    ← 最重要:通道的支付成功率
  + 响应速度得分 × 25%   ← 付款有多快
  + 稳定性趋势得分 × 15% ← 近期是在变好还是变差
  + 近期活跃度得分 × 10% ← 是否有足够的样本支撑评估
  - 连续失败惩罚(最高扣15分)
  - P95高延迟惩罚(最高扣10分)
  - 风控系统推送可能会存在异常的通道(最高扣80分)
权重含义说明:
成功率占比最高(50%),因为支付的首要目标是"成功";响应速度次之(25%),影响用户体验;稳定性趋势(15%)识别通道是否在恶化;活跃度(10%)保证评分有足够样本支撑。

4.3 各维度评分算法#

维度一:成功率得分#

不是单纯用一个时间窗口,而是三个窗口加权,近期数据权重更高,避免历史残留数据遮盖当前真实状态:
时间窗口权重
近 1 小时50%
近 6 小时25%
近 24 小时15%
兜底基准值10%
同时有低样本保护:当某窗口内订单数不足5笔时,该窗口权重自动缩小,避免"1笔失败 → 成功率0% → 评分崩溃"的误判。

维度二:响应速度得分#

折线插值,越快分越高:
平均响应时间得分
0 ~ 300ms100分(优秀)
300 ~ 800ms85 ~ 100分
800 ~ 1500ms70 ~ 85分
1500 ~ 3000ms45 ~ 70分
3000 ~ 5000ms20 ~ 45分
> 5000ms0分(不可接受)

维度三:稳定性趋势得分#

识别通道是在变好还是在变差:
近1小时成功率 ≥ 近24小时成功率 → 100分(近期表现更好,趋势向好)
近1小时成功率 < 近24小时成功率 → 按差值线性扣分,最低保底20分(近期在变差)
这个维度能识别出"表面上平均成功率还行,但实际上正在走下坡路"的通道,提前降低其优先级。

维度四:近期活跃度得分#

样本越多,评分越可信:
近1小时订单数 ≥ 5笔 → 按对数曲线计算活跃度得分(0~100)
近1小时订单数 < 5笔 → 固定50分(中等水平,不惩罚新通道)

额外惩罚项#

连续失败惩罚:近1小时失败笔数超过20笔后,每多失败1笔扣0.5分,上限扣15分
P95高延迟惩罚:P95响应时间超过3000ms后,超出越多扣分越多,上限扣10分
风控系统推送惩罚:将于风控系统联合,当风控系统推送可能会被AT渠道风险的通道将会进行预警,并且返回惩罚评分,最高80分

4.4 最终融合评分#

AI 评分只是输入之一,最终决策依据是融合了多个维度的综合分:
最终融合评分 =
    AI评分     × 60%   ← 核心,反映通道实时质量
  + 通道权重得分 × 20%  ← 商户对各通道的偏好配置
  + 费率得分   × 10%   ← 费率越低得分越高(成本优化)
  + 随机扰动   × 10%   ← 防止流量完全集中到同一通道
随机扰动的必要性:如果没有扰动,所有流量会持续打到当前最高分通道,导致其他通道因无流量而无法积累数据,形成"马太效应"。适当的随机扰动让每条通道都能持续获得流量和反馈,保持评分的有效性。

4.5 特殊决策策略#

大额订单保护#

订单金额 ≥ 5000 元时,系统自动收紧决策:
随机扰动从 10% 缩小至 2%(大额资金不能赌运气)
AI 评分权重从 60% 提升至 68%(更依赖数据,减少随机性)
决策日志中标注 大额保护 模式

冷启动均匀分流#

新上线的通道没有历史数据,无法计算评分。系统为其分配默认 60分(中等水平),并启用 Round-Robin 均匀轮询:在所有无历史数据的新通道之间轮流分配流量,快速积累真实数据,让 AI 尽早接管决策。

降级兜底保障#

无论规则过滤得多严格,系统保证永远返回一个可用通道:
正常情况     → AI决策最优通道
所有通道被过滤 → 从未熔断通道中随机兜底(标注降级标志)
所有通道熔断  → 从全部通道中随机兜底(标注降级标志)

4.6 权重自动训练#

AI 四维权重不是固定写死的,系统每小时自动执行一次梯度下降训练:
收集近1小时全部路由结果数据
    ↓
计算当前权重下的预测误差(实际成功率 vs 目标95%)
    ↓
沿误差梯度方向微调四维权重
    ↓
归一化确保四维之和 = 1.0,写入 Redis 并持久化历史
    ↓
下一轮评分计算使用新权重
保护机制:每个维度的权重范围约束在 [0.05, 0.80],防止某一维度过度主导导致评分失衡。训练样本不足100笔时自动跳过本轮训练,避免小样本带来噪声。

五、熔断保护机制#

熔断是对通道质量的自动兜底保护,独立于规则引擎和 AI 引擎运行。

5.1 自动触发条件#

满足任意一条即触发熔断,该通道从所有商户的路由候选池中移除:
触发条件默认阈值说明
近5分钟成功率过低< 30%(且样本 ≥ 10笔)通道正在大量失败
近1小时平均响应超限> 5000ms通道严重超时
近1小时P95延迟超限> 8000ms尾延迟过高,体验差

5.2 熔断时长指数退避#

同一通道频繁熔断时,每次熔断时长自动翻倍,防止反复"熔断-恢复-熔断"抖动:
24小时内第几次熔断熔断时长
第 1 次10 分钟
第 2 次20 分钟
第 3 次40 分钟
第 4 次及以上2 小时(上限)

5.3 半开自动恢复#

熔断到期后,不是直接恢复,而是先进入半开状态进行试探:
熔断到期
    ↓
进入半开状态,接入少量真实流量试探
    ├── 连续 3 笔支付成功 → 完全恢复,重新纳入正常路由
    └── 任意 1 笔支付失败 → 立即重新熔断(熔断次数继续累加)
这样可以避免"通道刚恢复就立刻承接大量流量,结果又挂掉"的情况。

六、数据闭环:AI 如何持续学习#

① 每笔订单路由到某通道,发起支付
       ↓
② 支付完成后,结果(成功/失败/超时关单)回写给系统
       ↓
③ 成功/失败结果进入 Redis 实时滑动窗口,立即影响成功率指标
       ↓
④ 每60秒,AI 引擎重新计算所有通道评分,写入 Redis
       ↓
⑤ 每小时,梯度下降训练优化四维权重
       ↓
⑥ 下一笔订单路由时,使用最新评分做决策
特别说明:超时关单不污染 AI 数据
扫码支付等场景下,用户扫码后可能长时间未确认付款,系统超时主动关单。这是用户行为,与通道质量无关。系统专门区分了这类状态,超时关单只记录日志,不计入通道的成功或失败统计,不影响 AI 评分,避免因用户行为导致好通道被误降级。

七、核心指标与预期效果#

指标说明
路由决策延迟每笔订单路由耗时 ≤ 10ms,对支付链路无感知
评分刷新频率每60秒全量刷新所有通道评分
实时成功率感知最短1分钟内感知通道质量变化
熔断响应时间5分钟内自动识别并隔离异常通道
权重优化周期每1小时自动完成一轮梯度下降训练
决策可追溯性每笔路由决策全量记录:命中规则、AI分、候选通道数、降级原因

八、兜底策略#

当系统误判某个应用通道可能存在异常被AI决策影响导致不可用,出现以上情况可后台一键重置该应用通道总体评分,让该通道等同于新上线的应用通道
文档版本 v2.0 · 如有问题请联系后端开发团队
上一页
10.1.3 提现结果通知
下一页
商户控台操作手册
Built with