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

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

顾客扫描二维码

提示

此端点会生成一个一次性付款二维码,供商家收款。顾客可以使用支付宝、微信或银联支付提供的扫码功能,扫描该端点生成的商家二维码以发起支付。

工作原理

端点

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

方法

POST

头部

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

! 提示

在收到访问凭证(商户 ID、登录名、商户密钥)之后, 您可以按照演示统一下单并选择channel WX_NATIVE,ALIPAY_QR或UPI_QR进行测试。 这可能在阅读文档时对您有所帮助。

请求
变量名必填类型示例值描述
mchIdyString(30)10000701由 IOTPay 分配
mchOrderNoyString(30)20160427210604000490由商户分配的订单号(不可重复)
jobNoyString(50)商户的登录名
currencyyString(3)CAD三字符货币缩写,仅支持CAD和USD,WX_NATIVE额外支持CNY
channelIdyString(24)WX_NATIVEWX_NATIVE, ALIPAY_QR, UPI_QR 此三种频道支持客户扫描二维码
amountyint100金额,以分为单位
devicenString(64)WEB设备型号(线下商户如餐厅),线上商户请用 WEB
notifyUrlyString(200)http://xxx.com/notify.php支付成功时获取通知
returnUrlnString(200)ALIPAY_PC,ALIPAY_WAP need this付款后重定向到此 URL
subjectyString(64)test product商品名
bodyyString(255)this product is for fun商品介绍
extray*String(512){"productId":"120989823"}WX_NATIVE 频道需要由商家分配的商品ID
remarksnString(200)备注
clientIpyString(32)210.73.10.148客户端IP地址
signyString(32)C380BEC2BFD727A4B6845133519F3AD6签名算法

提示

由于兼容性要求,我们要求参数被包装如下:

params={"amount":1,"mchId":"10000000","mchOrderNo":"9af01329f1ec4c4694631b077a0e8573","subject":"product title","sign":"F64C43C1487C7C0DA93DA93DD2961FA2","body":"product desc","clientIp":"127.0.0.1","extra":"{\"productId\":\"productTest001\"}","notifyUrl":"http://ngrok.4jicao.com/goods/payNotify","currency":"CAD","device":"WEB","channelId":"WX_NATIVE"}
响应
变量名必填类型示例值描述
resCodeyStringSUCCESS or FAIL
retCodeyStringSUCCESS or FAIL
retParamsyStringweixin://wxpay/bizpayurl?pr=nk******zz支付宝、微信或银联支付的支付链接
payOrderIdyStringWN20240101003753223310135049IOTPay 生成的订单号
mchOrderNoyString20160427210604000490由商户分配的订单号
retDetailyStringweixin://wxpay/bizpayurl?pr=nk******zz支付宝、微信或银联支付的支付链接
codeUrlnStringweixin://wxpay/bizpayurl?pr=nk******zz微信的支付链接
qr_codenStringhttps://qr.alipayplus.com/28******1j0Zc支付宝或银联支付的支付链接
signyStringC380BEC2BFD727A4B6845133519F3AD6签名 响应验证

支付结果通知

详情请见异步支付结果通知。

上次更新: 2025/8/20 17:19
Prev
商户扫码收款
Next
微信JSAPI支付集成(mobile web)