联调现场
没有真实通道凭据,先被卡在联调
支付链路的分支与边界,不该等通道开通后才验证
真实通道还没就绪
进件审核、签约与生产环境就绪前,支付链路无法完整演练
异常场景难复现
失败、超时、延迟到账、掉回调等分支,靠真实通道碰运气
对账差异难构造
长款、短款、状态不一致等对账场景,手工造数成本高
核心能力
四项能力,覆盖联调全流程
全链路模拟
支付、关单、同步、退款、分账、接收方绑定、对账单下载与回调解析等通道端点齐备
场景规则引擎
按金额个位、金额区间、单号后缀命中;支持即时成功/失败/关闭、延迟到账、概率失败与每 N 笔失败
可视管理台
支付/退款/分账订单、对账造数、主体档案、场景规则与运行设置等多个视图,订单结果可在管理台人工覆盖
自动回调引擎
按配置自动发送支付/退款回调,支持重试、二维码订单自动推进与重启恢复,无需手工逐笔确认
工作方式
三步接上,与真实通道同一套接入流程
主应用与子应用走和真实通道完全一致的下单、回调、查询与对账契约
创建通道商户
在主应用通道商户管理里选择模拟通道建档,支持直连与服务商两种产品形态
发起支付 / 退款
按 unipay 正常流程下单:二维码订单挂起等待确认,付款码即时出结果
确认或自动回调
打开收款确认页手动完成,或按场景规则自动回调;查询、退款、分账与对账走同一链路
模拟通道与真实通道共用同一套编排与策略:切换通道时,业务代码与接入流程不需要改动。
技术形态与安全
独立子应用,数据与主应用隔离
独立子应用部署,订单与配置落在自己的单文件数据库里,与主应用业务库、Redis 和消息队列完全隔离;请求加密沿用通道子应用同一套 AES-GCM 传输层。
部署与隔离
独立进程,不侵入主应用
- 运行形态
- 独立 Spring Boot 子应用,单文件 SQLite 存储订单与配置,不连接主应用数据库、Redis 与消息队列
- 传输加密
- 与真实通道子应用一致的 AES-GCM 请求加密,响应恒 HTTP 200,业务错误在密文内返回
- 生产防线
- 按部署模式条件装配:生产环境整模块不注册,不会出现模拟通道入口
接口与形态
与真实通道契约同构
- 产品形态
- 直连与服务商两种产品,能力对齐扫码与付款码支付方式
- 通道端点
- 支付、关单、同步、退款、分账、接收方绑定、回调解析与对账单下载等端点
- 对账造数
- 按规则制造长款、短款与状态不一致,用于对账与差异处理链路演练
模拟通道用于开发联调,不承载真实资金;生产部署按部署模式自动关闭模块,商户对接真实通道前可先用模拟通道把全链路跑通。
常见问题
常见问题解答
怎么获取?收费吗?
开源产品线基础版起、商业版基本版起均赠送,源码交付,不单独收费,随对应版本源码一并交付。
生产环境会不会误用?
不会。模拟通道模块按部署模式条件装配,生产环境整模块不注册,支付路由中不会出现模拟通道策略。
能模拟哪些异常?
支付、退款、分账可即时成功、失败或关闭,也可延迟到账;支持按概率失败、每 N 笔失败、无回调成功,以及按金额个位、金额区间、单号后缀命中规则;订单结果还可在管理台人工覆盖。
和平台沙箱有什么区别?
沙箱是部署级的环境隔离(生产与沙箱环境切换);模拟通道是联调用的通道本体,在没有真实通道凭据时把下单、回调、退款、分账与对账整条链路跑通,两者互补。