主题
接口环境说明
系统提供以下接口,请求参数、签名算法、响应格式完全一致,区别在于是否进行三要素验证。
核心区别
是否在创建订单时执行三要素验证(姓名 + 身份证 + 手机号)。
| 接口类型 | 路径 | 三要素验证 | 适用场景 |
|---|---|---|---|
| 真实接口 | /addons/huanyu/merchant/createOrder | ✔ 执行 | 生产环境(默认,需实名) |
| 测试接口 | /addons/huanyu/test/createOrder | ✘ 跳过 | 联调测试(不建议在生产使用) |
接口对照
- 创建订单(含三要素):
/addons/huanyu/merchant/createOrder - 创建订单(测试):
/addons/huanyu/test/createOrder - 上传支付凭证:真实
/addons/huanyu/merchant/uploadPaymentProof→ 测试/addons/huanyu/test/uploadPaymentProof
签名规则
所有接口的签名算法(api_key + 签名校验)完全相同,切换时无需修改签名生成逻辑,只需替换请求路径即可。
三要素验证与暂存补全流程
真实接口 createOrder 在创建买单时会执行三要素(姓名 + 身份证 + 手机号)实名验证:
- 验证通过: 正常匹配交易员并建单
- 验证失败: 订单暂存,返回 H5 补全链接,由 C 端用户补全三要素后重新建单(详见 买单接口)
卖单三要素验证失败将直接返回错误(不触发暂存补全)。
