线上安全支付
Note
此端点将根据提供的渠道ID生成一个第三方支付页面的跳转链接。
工作原理
相关渠道ID
| 渠道ID | 渠道简介 |
|---|---|
| ALIPAY_WAP | 支付宝WAP（移动端）支付 |
| ALIPAY_PC | 支付宝PC支付 |
| UPI_SEQ | 银联卡在线安全支付（跳转到银联网页） |
API 请求
端点
https://api.iotpaycloud.com/v1/create_order
方法
POST
头部
Content-Type: application/x-www-form-urlencoded
! 提示
在收到访问凭证（商户 ID、登录名、商户密钥）之后， 您可以按照演示统一下单并选择channel ALIPAY_PC, ALIPAY_WAP, 或UPI_SEQ进行测试。 这可能在阅读文档时对您有所帮助。
参数说明
| 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|
| mchId | y | String(30) | 10000701 | 由 IOTPay 分配 |
| mchOrderNo | y | String(30) | 20160427210604000490 | 由商户分配的订单号（不可重复） |
| jobNo | y | String(50) | 商户的登录名 | |
| currency | y | String(3) | CAD | 三字符货币缩写，支持CAD和USD |
| channelId | y | String(24) | ALIPAY_PC | ALIPAY_PC，ALIPAY_WAP或UPI_SEQ |
| 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 | 商品介绍 |
| remarks | n | String(200) | 备注 | |
| clientIp | y | String(32) | 210.73.10.148 | 客户端IP地址 |
| sign | y | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名算法 |
响应
| 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|
| resCode | y | String | SUCCESS or FAIL | |
| retCode | y | String | SUCCESS or FAIL | |
| retParams | y | String | {"alipayUrl": "https://...."} | 包含跳转链接的对象 |
| payOrderId | y | String | WN20240101003753223310135049 | IOTPay 生成的订单号 |
| mchOrderNo | y | String | 20160427210604000490 | 由商户分配的订单号（不可重复） |
| retDetail | y | String | 订单信息 | |
| payUrl | n | String | 跳转到此地址，直接echo该参数，或者redirect到扩展参数中的url | |
| sign | y | String | C380BEC2BFD727A4B6845133519F3AD6 | 签名 响应验证 |
retParams 中可能会返回的参数
| 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|
| alipayUrl | y* | String | https://.... | 若渠道为ALIPAY_PC或ALIPAY_WAP，此变量为跳转链接 |
| orderStr | y* | String | _input_charset=utf-&... | 若渠道为ALIPAY_WAP, 将会返回此变量，其内包含订单信息 |
| unionpayUrl | y* | String | https://.... | 若渠道为UPI_SEQ，此变量为跳转链接 |
支付结果通知
详情请见异步支付结果通知。