IOTPay 技术接入文档IOTPay 技术接入文档
  • 介绍
  • 签名
  • 统一下单
  • 商户扫码收款
  • 顾客扫描二维码
  • 微信JSAPI支付集成(mobile web)
  • 微信JSAPI支付集成(微信小程序)
  • 线上安全支付
  • 商户App集成IOTPay
  • 查询订单接口
  • 异步支付结果通知
  • 获取clientIP
  • 退款接口
  • 退款查询接口
  • POS 半集成
  • WordPress WooCommerce 插件
  • V3

    • 介绍
    • 重定向集成
    • 重定向集成(支持3DS与AVS)
    • 嵌入式集成
    • 直接支付
    • 查询卡信息
    • 使用令牌进行购买
    • 数字钱包支付
    • 撤销交易
    • 退款交易
    • 查询交易
    • 银联 ExpressPay API
  • V2

    • Credit Card API V2(不建议使用,请对接V3版本)
  • 介绍
  • 签约
  • 支付
  • 查询订单接口
  • 回调
  • English
  • 简体中文
  • 介绍
  • 签名
  • 统一下单
  • 商户扫码收款
  • 顾客扫描二维码
  • 微信JSAPI支付集成(mobile web)
  • 微信JSAPI支付集成(微信小程序)
  • 线上安全支付
  • 商户App集成IOTPay
  • 查询订单接口
  • 异步支付结果通知
  • 获取clientIP
  • 退款接口
  • 退款查询接口
  • POS 半集成
  • WordPress WooCommerce 插件
  • V3

    • 介绍
    • 重定向集成
    • 重定向集成(支持3DS与AVS)
    • 嵌入式集成
    • 直接支付
    • 查询卡信息
    • 使用令牌进行购买
    • 数字钱包支付
    • 撤销交易
    • 退款交易
    • 查询交易
    • 银联 ExpressPay API
  • V2

    • Credit Card API V2(不建议使用,请对接V3版本)
  • 介绍
  • 签约
  • 支付
  • 查询订单接口
  • 回调
  • English
  • 简体中文
  • 指南

    • 介绍
    • 签名
    • 统一下单
    • 商户扫码收款
    • 顾客扫描二维码
    • 微信JSAPI支付集成(mobile web)
    • 微信JSAPI支付集成(微信小程序)
    • 线上安全支付
    • 商户App集成IOTPay
    • 查询订单接口
    • 异步支付结果通知
    • 获取clientIP
    • 退款接口
    • 退款查询接口
    • POS 半集成
    • WordPress WooCommerce 插件
  • 信用卡

    • V3

      • 介绍
      • 重定向集成
      • 重定向集成(支持3DS与AVS)
      • 嵌入式集成
      • 直接支付
      • 查询卡信息
      • 使用令牌进行购买
      • 数字钱包支付
      • 撤销交易
      • 退款交易
      • 查询交易
      • 银联 ExpressPay API
    • Credit Card API V2(不建议使用,请对接V3版本)
  • 代扣

    • 介绍
    • 签约
    • 支付
    • 查询订单接口
    • 回调

微信JSAPI支付集成(微信小程序)

此文档适用于在微信小程序发起支付。特别注意,小程序要接入海外支付,必须主体是海外公司,例如公司收加币,就需要主体是加拿大公司。 中国境内公司申请的小程序无法接入海外支付。

API 请求

端点

https://api.iotpaycloud.com/v1/create_order

方法

POST

头部

Content-Type: application/x-www-form-urlencoded

参数说明

字段名变量名必填类型示例值描述
商户IDmchId是String(30)20001222支付中心分配的商户号
商户订单号mchOrderNo是String(30)20160427210604000490商户生成的订单号,请保证唯一性
渠道IDchannelId是String(24)WX_JSAPI小程序接口
币种currency是String(3)CAD三位货币代码,加币:CAD
支付金额amount是int100支付金额,单位分
客户端IPclientIp是String(32)210.73.10.148客户端IP地址
设备device否String(64)WEB终端设备号(门店号或收银设备ID),注意:PC网页或公众号内支付请传"WEB
支付结果回调URLnotifyUrl是String(200)http://xxx.com/notify.php支付结果回调URL
商品主题subject是String(64)测试商品商品主题
商品描述信息body是String(255)xxpay测试商品描述商品描述信息
扩展参数1param1否String(64)支付中心回调时会原样返回
扩展参数2param2否String(64)支付中心回调时会原样返回
附加参数extra是String(512){"openId":"o2RvowBf7sOVJf8kJksUEMceaDqo", "type":"minipay","appId":"xxxxxxxxx"}
子账号jobNo是String(50)商户登录名
附言remarks否String(200)商户的附言
签名sign是String(32)C380BEC2BFD727A4B6845133519F3AD6签名值,详见签名算法

当小程序后端接收到返回值后,将返回值传回小程序前端并调用wx.requestPayment,将以下参数填入进行发起支付:

wx.requestPayment({
  appId: res.data.payParams.appId,
  timeStamp: res.data.payParams.timeStamp,
  nonceStr: res.data.payParams.nonceStr,
  package: res.data.payParams.package,
  signType: res.data.payParams.signType,
  paySign: res.data.payParams.paySign,
  success(res) {
    console.log(res)
    wx.navigateTo({
      url: '',
    })
  },
  fail(res) {
    console.log(res)
    wx.navigateTo({
      url: '',
    })
  },
})

支付完成后,商家后台系统仍需根据notify判断是否支付成功或失败

返回结果

字段名变量名必填类型示例值描述
返回状态码retCode是String(16)SUCCESSSUCCESS/FAIL此字段是通信标识,非交易标识,交易是否成功需要查看resCode来判断
返回信息retMsg否String(128)签名失败返回信息,如非空,为错误原因 签名失败 参数格式校验错误

以下字段在retCode和resCode都为SUCCESS的时候有返回

字段名变量名必填类型示例值描述
支付订单号payOrderId是String支付订单号
支付参数payParams是Array小程序调用支付需要的参数
签名sign是String签名值

返回错误

更多返回错误代码请看这里

JSAPI 小程序集成部分源码示例

源码下载 点击这里

上次更新: 2024/4/1 17:41
Prev
微信JSAPI支付集成(mobile web)
Next
线上安全支付