主题
接口环境说明
系统提供以下接口,请求参数、签名算法、响应格式完全一致,区别在于是否进行三要素验证。
核心区别
是否在创建订单时执行三要素验证(姓名 + 身份证 + 手机号)。
| 接口类型 | 路径 | 三要素验证 | 适用场景 |
|---|---|---|---|
| 真实接口 | /addons/huanyu/merchant/createOrder | ✔ 执行 | 生产环境(默认,需实名) |
| 真实接口(免三要素版) | /addons/huanyu/merchant/createOrderSimple | ✘ 跳过 | 已与平台约定不校验实名的合作方 |
| 测试接口 | /addons/huanyu/test/createOrder | ✘ 跳过 | 联调测试(不建议在生产使用) |
接口对照
- 创建订单(含三要素):
/addons/huanyu/merchant/createOrder - 创建订单(免三要素):
/addons/huanyu/merchant/createOrderSimple - 创建订单(测试):
/addons/huanyu/test/createOrder - 上传支付凭证:真实
/addons/huanyu/merchant/uploadPaymentProof→ 测试/addons/huanyu/test/uploadPaymentProof
签名规则
所有接口的签名算法(api_key + 签名校验)完全相同,切换时无需修改签名生成逻辑,只需替换请求路径即可。
createOrderSimple 说明
走与 createOrder 完全一致的真实建单流程(api_key + 签名校验、黑白名单风控、买单交易员预检查、匹配交易员、冻结、分润等),唯一区别是不进行三要素验证,因此不会触发三要素失败暂存 / H5 补全流程,买单卖单均可直接建单。