Skip to content

接口环境说明

系统提供以下接口,请求参数、签名算法、响应格式完全一致,区别在于是否进行三要素验证。

核心区别

是否在创建订单时执行三要素验证(姓名 + 身份证 + 手机号)。

接口类型路径三要素验证适用场景
真实接口/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 端用户补全三要素后重新建单(详见 买单接口

卖单三要素验证失败将直接返回错误(不触发暂存补全)。