顾客扫描二维码
提示
此端点会生成一个一次性付款二维码，供商家收款。顾客可以使用支付宝、微信或银联支付提供的扫码功能，扫描该端点生成的商家二维码以发起支付。
工作原理
端点
https://api.iotpaycloud.com/v1/create_order
方法
POST
头部
Content-Type: application/x-www-form-urlencoded
! 提示
在收到访问凭证（商户 ID、登录名、商户密钥）之后， 您可以按照演示统一下单并选择channel WX_NATIVE，ALIPAY_QR或UPI_QR进行测试。 这可能在阅读文档时对您有所帮助。
请求
| 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|
| mchId | y | String(30) | 10000701 | 由 IOTPay 分配 |
| mchOrderNo | y | String(30) | 20160427210604000490 | 由商户分配的订单号（不可重复） |
| jobNo | y | String(50) | 商户的登录名 | |
| currency | y | String(3) | CAD | 三字符货币缩写，仅支持CAD和USD，WX_NATIVE额外支持CNY |
| channelId | y | String(24) | WX_NATIVE | WX_NATIVE, ALIPAY_QR, UPI_QR 此三种频道支持客户扫描二维码 |
| amount | y | int | 100 | 金额，以分为单位 |
| device | n | String(64) | WEB | 设备型号(线下商户如餐厅)，线上商户请用 WEB |
| notifyUrl | y | String(200) | http://xxx.com/notify.php | 支付成功时获取通知 |
| returnUrl | n | String(200) | ALIPAY_PC,ALIPAY_WAP need this | 付款后重定向到此 URL |
| subject | y | String(64) | test product | 商品名 |
| body | y | String(255) | this product is for fun | 商品介绍 |
| extra | y* | String(512) | {"productId":"120989823"} | WX_NATIVE 频道需要由商家分配的商品ID |
| remarks | n | String(200) | 备注 | |
| clientIp | y | String(32) | 210.73.10.148 | 客户端IP地址 |
| sign | y | String(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"}
响应
| 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|
| resCode | y | String | SUCCESS or FAIL | |
| retCode | y | String | SUCCESS or FAIL | |
| retParams | y | String | weixin://wxpay/bizpayurl?pr=nk******zz | 支付宝、微信或银联支付的支付链接 |
| payOrderId | y | String | WN20240101003753223310135049 | IOTPay 生成的订单号 |
| mchOrderNo | y | String | 20160427210604000490 | 由商户分配的订单号 |
| retDetail | y | String | weixin://wxpay/bizpayurl?pr=nk******zz | 支付宝、微信或银联支付的支付链接 |
| codeUrl | n | String | weixin://wxpay/bizpayurl?pr=nk******zz | 微信的支付链接 |
| qr_code | n | String | https://qr.alipayplus.com/28******1j0Zc | 支付宝或银联支付的支付链接 |
| sign | y | String | C380BEC2BFD727A4B6845133519F3AD6 | 签名 响应验证 |
支付结果通知
详情请见异步支付结果通知。