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版本)
  • 代扣

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

异步支付结果通知

支付成功后,系统会对notifyUrl发出通知,收到通知后,商户业务系统可以更新内部订单状态和其它业务相关的操作。

接口链接

该链接是通过统一下单接口提交的参数notifyUrl设置,如果无法访问链接,业务系统将无法接收到支付中心的通知。

通知参数

字段名变量名类型示例值描述
支付订单号payOrderIdString(30)P20160427210604000490支付中心生成的订单号
商户IDmchIdString(30)20001222支付中心分配的商户号
商户订单号mchOrderNoString(30)20160427210604000490商户生成的订单号
渠道IDchannelIdString(24)WX_JSAPI见支付渠道参数
币种currencyString(3)CAD三位货币代码,加币:CAD
支付金额amountint100支付金额,单位分
状态statusint2支付状态, 目前只有一个status:2-支付成功
客户端IPclientIpString(32)210.73.10.148客户端IP地址
设备deviceString(64)WEB终端设备号(门店号或收银设备ID),注意:PC网页或公众号内支付请传”WEB
商品主题subjectString(64)测试商品商品主题
商品描述信息bodyString(256)测试商品描述商品描述信息
渠道订单号channelOrderNoString(64)wx2016081611532915ae15b00b0167893571三方支付渠道订单号
扩展参数1param1String(64)支付中心回调时会原样返回(若为微信公众号内部支付,会被替换为"mchOrderId")
扩展参数2param2String(64)支付中心回调时会原样返回
支付成功时间paySuccTimelong精确到毫秒
通知类型backTypeint1通知类型,1-前台通知,2-后台通知
签名signString(32)C380BEC2BFD727A4B6845133519F3AD6签名值,详见签名算法

返回结果

业务系统处理后同步返回给支付中心,返回字符串success则表示成功,返回非success则表示处理失败,支付中心会再次通知业务系统。*(通知次数最多4次)

主动轮询订单状态

对于没有后台的商家,例如从pos机软件来集成,无法提供notifyUrl来接收订单状态,可以采用主动轮询的方式来查询订单交易是否成功。
查看订单查询接口这里

双保险获取订单状态

商家可以选择同时使用notifyUrl和轮询机制来确保能够获取订单交易状态

上次更新: 2025/8/20 17:19
Prev
查询订单接口
Next
获取clientIP