查询订单接口

本接口只用于微信支付,支付宝支付和银联支付。

API 请求

端点

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

方法

POST

头部

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

! 提示

在收到访问凭证(商户 ID、登录名、商户密钥)之后, 您可以按照演示查询订单在新窗口打开进行测试。 这可能在阅读文档时对您有所帮助。

请求参数

字段名变量名必填类型示例值描述
商户IDmchIdString(30)1000000010支付中心分配的商户号
支付订单号payOrderId是*String(30)P20160427210604000490支付中心生成的订单号
商户订单号mchOrderNo是*String(30)20160427210604000490商户生成的订单号
签名signString(32)C380BEC2BFD727A4B6845133519F3AD6签名值,详见签名算法

提示

请求参数中只需包含payOrderIdmchOrderNo其一即可。

返回结果

字段名变量名类型示例值描述
返回状态码retCodeString(16)SUCCESSSUCCESS/FAIL此字段是通信标识,非交易标识,交易是否成功需要查看resCode来判断
返回信息retMsgString(128)签名失败返回信息,如非空,为错误原因 签名失败 参数格式校验错误

以下字段在retCodeSUCCESS的时候有返回

字段名变量名必填类型示例值描述
业务结果resCodeString(16)SUCCESSSUCCESS/FAIL
错误代码errCodeString(32)SYSTEMERROR错误码
错误代码描述errCodeDesString(128)系统错误结果信息描述

以下字段在retCoderesCode都为SUCCESS的时候有返回

字段名变量名必填类型示例值描述
商户IDmchIdString(30)20001222支付中心分配的商户号
商户订单号mchOrderNoString(30)20160427210604000490商户生成的订单号
渠道IDchannelIdString(24)WX_JSAPI支付渠道参数
币种currencyString(3)CAD三位货币代码,加币:CAD
支付金额amountint100支付金额,单位分
客户端IPclientIpString(32)210.73.10.148客户端IP地址
设备deviceString(64)WEB终端设备号(门店号或收银设备ID),
注意:PC网页或公众号内支付请传”WEB
支付结果回调URLnotifyUrlString(200)http://xxx.com/notify.php支付结果回调URL
商品主题subjectString(64)测试商品商品主题
商品描述信息bodyString(256)测试商品描述商品描述信息
扩展参数1param1String(64)支付中心回调时会原样返回
扩展参数2param2String(64)支付中心回调时会原样返回
附加参数extraString(512){“openId”:”o2RvowBf7sOVJf8kJksUEMceaDqo”}特定渠道发起时额外参数,见下面说明
支付成功时间paySuccTimeLong1505049094262支付成功时间
渠道订单号channelOrderNoStringwx20170910211043fb206e92260071822007对应的第三方支付订单号
订单状态statusint2 or 32 or 3代表成功

订单状态列表

状态码简介
0创建成功但未付款
1用户正在付款界面, 如用户正在输入密码
2已支付成功
3已支付成功并且已通知商家
4被系统取消
9被用户取消

提示

轮询订单状态时,仅当状态码为2或3时代表订单成功,若状态码大于3,此订单将再无成功可能,此时可停止轮询。

返回错误

更多返回错误代码请看这里

上次更新: