Skip to content

接口环境说明

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

核心区别

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

接口类型路径三要素验证适用场景
真实接口/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 补全流程,买单卖单均可直接建单。