POST https://apiv3.iotpaycloud.com/contract/create_order
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|
| 商户ID | mchId | 是 | String(30) | 10000701 | 支付中心分配的商户号 |
| 商户订单号 | mchOrderNo | 是 | String(30) | 20160427210604000490 | 商户生成的订单号，请保证唯一性 |
| 商户合约号 | mchContractId | 是 | String(128) | 2177aac8-1c3e-4291-97e0-f63f69b34cb6 | 商户生成的合约号，请保证唯一性 |
| 渠道ID | channelId | 是 | String(24) | WX_JSAPI，WX_APP, WX_MWEB | 见支付渠道参数 |
| 币种 | currency | 是 | String(3) | CAD , CNY , USD | 三位货币代码,加币:CAD |
| 支付金额 | amount | 是 | int | 100 | 支付金额,单位分 |
| 客户端IP | clientIp | 否 | String(32) | | |
| 设备 | device | 否 | String(50) | 可选值 IOS,ANDROID | 终端设备号(门店号或收银设备ID)，注意：PC网页或公众号内支付请传"WEB" |
| 结果回调URL | notifyUrl | 是 | String(1000) | https://xxx.com/notify.php | 支付结果回调URL,勿包含？ |
| 商品描述信息 | body | 是 | String(255) | xxpay测试商品描述 | 商品描述信息 |
| 附加参数 | extra | 是 | String(512) | | 微信小程序，WX_APP, WX_MWEB需要 |
| 结束跳转URL | returnUrl | 否 | String(1000) | WX_JSAPI, ALIPAY_PC, ALIPAY_WAP需要 | 支付结束跳转URL，勿包含? |
| 子账号 | jobNo | 是 | String(50) | | 商户登录名 |
| 附言 | remarks | 否 | String(200) | | 商户的附言 |
| 签名 | sign | 是 | String(32) | C380BEC2BF3519F3AD6 | 签名值，详见签名算法 |
不传extra视为H5/公众号
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|
| 附加参数 | extra | 是 | JSON | {"type":"minipay","appId":"xxxxxxxxx"} | type,appId为必填。 |
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|
| 附加参数 | extra | 是 | JSON | {"type":"apppay","appId":"xxxxxxxxx"} | type,appId为必填。 |
| 字段名 | 变量名 | 类型 | 示例值 | 描述 |
|---|
| 返回状态码 | retCode | String(16) | SUCCESS | SUCCESS/FAIL此字段是通信标识，非交易标识，交易是否成功需要查看resCode来判断 |
| 返回信息 | retMsg | String(128) | 签名失败 | 返回信息，如非空，为错误原因 签名失败 参数格式校验错误 |
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|
| 业务结果 | resCode | 是 | String(16) | SUCCESS | SUCCESS/FAIL |
| 错误代码 | errCode | 否 | String(32) | SYSTEMERROR | 错误码 |
| 错误代码描述 | errCodeDes | 否 | String(128) | 系统错误 | 结果信息描述 |
| 字段名 | 变量名 | 类型 | 示例值 | 描述 |
|---|
| 支付订单号 | payOrderId | String(30) | P20160427210604000490 | 支付中心生成的订单号 |
| 商户ID | mchId | String(30) | 20001222 | 支付中心分配的商户号 |
| 商户订单号 | mchOrderNo | String(30) | 20160427210604000490 | 商户生成的订单号 |
| 渠道ID | channelId | String(24) | WX_JSAPI | 见支付渠道参数 |
| 币种 | currency | String(3) | CAD | 三位货币代码,加币:CAD |
| 支付金额 | amount | int | 100 | 支付金额,单位分 |
| 状态 | status | int | 2 | 支付状态, 2 or 3代表成功 |
| 客户端IP | clientIp | String(32) | 210.73.10.148 | 客户端IP地址 |
| 设备 | device | String(64) | WEB | 终端设备号(门店号或收银设备ID)，注意：PC网页或公众号内支付请传”WEB |
| 商品主题 | subject | String(64) | 测试商品 | 商品主题 |
| 商品描述信息 | body | String(256) | 测试商品描述 | 商品描述信息 |
| 渠道订单号 | channelOrderNo | String(64) | wx2016081611532915ae15b00b0167893571 | 三方支付渠道订单号 |
| 扩展参数1 | param1 | String(64) | 支付中心回调时会原样返回（若为微信公众号内部支付，会被替换为"mchOrderId"） | |
| 扩展参数2 | param2 | String(64) | 支付中心回调时会原样返回 | |
| 支付成功时间 | paySuccTime | long | 精确到毫秒 | |
| 通知类型 | backType | int | 1 | 通知类型，1-前台通知，2-后台通知 |
| 签名 | sign | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名值，详见签名算法 |
| 是否签约 | autodebit | String(1) | 1 | 是否签约，1-签约，0-非签约 |
| 商户合约号 | mchContractId | String(128) | b53554e6-edd5-472b-b534-fe137fbbb382 | 商户生成的合约号，请保证唯一性 |
| Iotpay合约号 | iotpayContractId | String(128) | CWJ20250819011704375030054146 | 支付中心分配的合约号 |
| 货币金额 | currencyAmount | String(10) | 77 | 货币金额，单位分。只有currency于商户签约结算货币不同时返回 |
POST https://商户回调URL
| 字段名 | 变量名 | 类型 | 示例值 | 描述 |
|---|
| 支付订单号 | payOrderId | String(30) | P20160427210604000490 | 支付中心生成的订单号 |
| 商户ID | mchId | String(30) | 20001222 | 支付中心分配的商户号 |
| 商户订单号 | mchOrderNo | String(30) | 20160427210604000490 | 商户生成的订单号 |
| 渠道ID | channelId | String(24) | WX_JSAPI | 见支付渠道参数 |
| 币种 | currency | String(3) | CAD | 三位货币代码,加币:CAD |
| 支付金额 | amount | int | 100 | 支付金额,单位分 |
| 状态 | status | int | 2 | 支付状态, 2 or 3代表成功 |
| 客户端IP | clientIp | String(32) | 210.73.10.148 | 客户端IP地址 |
| 设备 | device | String(64) | WEB | 终端设备号(门店号或收银设备ID)，注意：PC网页或公众号内支付请传”WEB |
| 商品主题 | subject | String(64) | 测试商品 | 商品主题 |
| 商品描述信息 | body | String(256) | 测试商品描述 | 商品描述信息 |
| 渠道订单号 | channelOrderNo | String(64) | wx2016081611532915ae15b00b0167893571 | 三方支付渠道订单号 |
| 扩展参数1 | param1 | String(64) | 支付中心回调时会原样返回（若为微信公众号内部支付，会被替换为"mchOrderId"） | |
| 扩展参数2 | param2 | String(64) | 支付中心回调时会原样返回 | |
| 支付成功时间 | paySuccTime | long | 精确到毫秒 | |
| 通知类型 | backType | int | 1 | 通知类型，1-前台通知，2-后台通知 |
| 签名 | sign | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名值，详见签名算法 |
| 是否签约 | autodebit | String(1) | 1 | 是否签约，1-签约，0-非签约 |
| 商户合约号 | mchContractId | String(128) | b53554e6-edd5-472b-b534-fe137fbbb382 | 商户生成的合约号，请保证唯一性 |
| Iotpay合约号 | iotpayContractId | String(128) | CWJ20250819011704375030054146 | 支付中心分配的合约号 |
| 货币金额 | currencyAmount | String(10) | 77 | 货币金额，单位分。只有currency于商户签约结算货币不同时返回 |
业务系统处理后同步返回给支付中心，返回字符串success则表示成功，返回非success则表示处理失败，支付中心会再次通知业务系统。*（通知次数最多4次）
对于没有后台的商家，例如从pos机软件来集成，无法提供notifyUrl来接收订单状态，可以采用主动轮询的方式来查询订单交易是否成功。
查看订单查询接口这里
强烈建议商家选择同时使用notifyUrl和轮询机制（30分钟）来确保能够获取订单交易状态
