测试单（联调用）

平台支持测试单机制，用于商户对接联调：测试单会走完整下单流程（建单 → 匹配交易员 → 收款 → 确认 → 结算 → 回调），但只会匹配给测试交易员，不会打扰真实交易员；同时正式订单也不会匹配给测试交易员（双向隔离），双方的订单与资金互不干扰。

如何发起测试单

下单接口（买入订单、卖出订单）增加可选参数 is_test：

参数	类型	必填	说明
is_test	int	否	0=正式单（默认，不传等同 0）；1=测试单

• 参数参与签名（与其他非空参数一样参与 签名算法 计算），不传时不影响签名结果。
• 买单、卖单均支持；createOrder 与兼容端点 createOrderSimple 均支持。

{
  "order_type": 1,
  "cny_amount": 500.00,
  "is_test": 1
}

匹配规则

订单	匹配的交易员
测试单（is_test=1）	仅测试交易员
正式单（is_test=0）	仅正式交易员

• 交易员的"正式 / 测试"身份由平台后台配置，商户无需关心具体是哪些交易员。
• 若当前没有可用的测试交易员（如均暂停接单），测试单会像正常单一样返回匹配失败错误，可稍后重试。

测试单的行为说明

• 流程与正式单完全一致：金额计算、费率、状态流转、回调通知均照常执行，可用于全链路联调与回调验收。
• 回调报文结构与正式单一致（is_test 不出现在回调报文中），商户按现有逻辑处理即可。
• 测试单同样支持商户单号（merchant_order_no）与单级回调地址（callback_url）。
• 联调完成后正常下单（不传 is_test 或传 0）即恢复正式流程，无需任何额外操作。

建议

联调时固定使用同一套商户单号前缀（如 TEST-）便于在订单列表中筛选区分测试单。