查询订单

接口说明
公共请求参数
业务请求参数
公共请求示例
业务请求示例
公共响应参数
业务响应参数
扩展信息域
公共响应示例
业务响应示例
交易状态码
交易响应码

商户可以通过查询订单接口主动查询订单状态，完成下一步的业务逻辑。

接口说明

测试请求URL：https://test-api.huishouqian.com/api/acquiring

生产请求URL：https://api.huishouqian.com/api/acquiring

请求方式：POST

公共请求参数

变量	参数名	类型[长度限制]	必填	描述
method	方法名	string[1,32]	是	POLYMERIZE_QUERY
version	版本	string[1,16]	是	接口版本：1.0
format	请求格式	string[1,16]	是	业务请求参数格式，支持：JSON
merchantNo	商户号	string[1,16]	是	商户在慧收钱的商户号，由慧收钱生成并下发
signType	加密类型	string[1,16]	是	RSA2:签名机制查看说明
signContent	业务数据	string	是	业务请求参数
sign	签名数据	string[1,128]	否	签名数据

业务请求参数

变量	参数名	类型[长度限制]	必填	描述
transNo	商户订单号	string[1,64]	是	原支付交易对应的商户订单号
queryType	查询类型	string[1,10]	是	类型:2

公共请求示例

{method=POLYMERIZE_QUERY, format=json, signType=RSA2, signContent=【参考业务请求示例】,sign=7ecbad9cb113bd54e6ee45f7fe76883a40428d548b7294ce8f7ba30f211881073820d3ec7a54d3406dcf7a4d3f87f0994c24db54bab430777425147378dbf01afe0491a1c287e5ce380454b0e228a5a20d541874c14addd4100199660e6c4a857fa080ceb4601a0ee21e3fab9d87016198f151a3b16f60a254c1e8b4cd42cdf7
, version=1.0, merchantNo=814000473149}

业务请求示例

{
"transNo":"DD20210812102555029",
"queryType":"1"
}

公共响应参数

变量	参数名	类型[长度限制]	必填	描述
success	响应状态	string[1,32]	是	服务端响应状态，如果为true，则可以调用result；如果为false，则调用errorCode来获取出错信息
errorCode	错误码	string[1,32]	否	响应码
errorMsg	错误描述	string[1,128]	否	响应描述
result	响应内容	string	否	业务响应参数
sign	签名数据	string[1,128]	否	响应验签数据

业务响应参数

变量	参数名	类型[长度限制]	必填	描述
transNo	商户订单号	string[1,64]	是	原支付交易对应的商户订单号
tradeNo	交易订单号	string[1,32]	是	慧收钱系统交易订单号
orderAmt	交易金额	string[1,16]	是	交易金额，单位：分
orderStatus	交易状态	string[1,16]	是	交易状态，详见交易状态码
finishedDate	完成时间	string[1,14]	否	交易完成时间，格式[yyyyMMddHHmmss] 示例：20190101140908
respCode	响应码	string[1,32]	是	详见交易响应码
respMsg	响应描述	string[1,128]	是	详见交易响应码
payType	支付类型	string[1,16]	是	ALI_NATIVE：支付宝 WECHAT_JSAPI：微信 UNION_NATIVE：银联
goodsInfo	商品信息	string[1,128]	否	商品信息
requestDate	请求时间	string[1,14]	是	交易请求时间，格式[yyyyMMddHHmmss] 示例：20190101140908
buyerName	用户账号	string[1,64]	否	支付宝返回支付宝用户账号（脱敏），微信返回用户支付标识（openid）
channelOrderNo	渠道商户订单号	string[1,64]	否	请求渠道商户订单号
payOrderNo	渠道交易单号	string[1,64]	否	支付宝/微信/银联返回的交易号
fundChannel	渠道支付方式	string[1,32]	否	支付宝/微信/银联返回的支付方式，详见支付宝微信
fundBankCode	渠道支付编码	string[1,32]	否	支付宝/微信/银联返回的银行编码/借贷标识，详见支付宝微信
extend	附加字段	string[1,128]	否	附加数据，原样返回
memo	扩展信息域	string[1,512]	否	json格式，将如下参数转json

扩展信息域

变量	参数名	类型[长度限制]	必填	描述
paylimit	限制卡类型	string[1,128]	否	限制不能使用的支付类型微信：no_credit–指定不能使用信用卡支付支付宝：查看详情
timeExpire	交易结束时间	string[1,14]	否	订单失效时间，格式[yyyyMMddHHmmss] 示例：20190101140908
openid	用户标识	string[1,64]	否	用户在appid下的唯一标识
appid	应用ID	string[1,64]	否	公众号/小程序的appid
spbillCreateIp	终端用户IP	string[1,32]	否	用户端IP，支持ipv4、ipv6格式示例：123.12.12.123
longitude	经度	string[1,32]	否	消费者交易所在地经度
latitude	纬度	string[1,32]	否	消费者交易所在地纬度
areaInfo	区域信息	string[1,7]	否	银联选填，区域信息，长度固定7
appVersion	应用程序版本	string[1,8]	否	银联选填，固定8位，长度不足右补空格
deviceType	设备类型	string[1,8]	否	银联选填终端设备类型，取值如下： 01：自动柜员机（含 ATM 和 CDM）和多媒体自助终端 02：传统 POS 03：mPOS 04：智能 POS 05：II型固定电话
deviceNo	终端设备号	string[1,50]	否	银联选填，终端设备的硬件序列号

公共响应示例

{
"success":true,
"result":"【业务响应示例】",
"errorCode":null,
"errorMsg":null,
"sign":"88faca1f2511cc194367ffd96aa78a4cdf25a8284b0cd74b75e331b37c642b26aaeb46f2e4be38080eeb2b78575abd715d58fd30bbf59e167d64d0b714487f9462381e499a48524b1704694f256fa8f6e917d33cd413e365872ef2c7eede37ab4b23f67dcf6f34ec0daf65a34502123f792a646bea6447c126a612087825b17b91e585f74e56220328b198982e62a734387cd8556927e6881878b821969b6e784a20771cf55fad70a4368b8650c0ece0a7903678e1ad6134f6c711329a3e3e456c28ffbfc607fa6bf1f969a4d38b35ca3bf9ad81f71b2d2ad816502d579c0c4fc1f1fccec74a861c4679c5217be0176bf1eebcb57aea381f922fcf920aa471198be972f0c4f9fab10f7885b9c09eda977351b40e9058247ec30da55dd4c0be4a9de7d996e186e9f9ff2693f564f0eaddca9d7ff9f3b813d0c70bdba75b2a1bf9bd4ddf28ff66c45d6ce31e188d8606c82078d842008a9a1b4c1b64b7b2d3632087e46bbc4322181a9832cecd852682fdb72d336b32512bde94e81ba322fe9d2d"
}

业务响应示例

{
"buyerName":"159****2272",
"channelOrderNo":"18000020210812102438004012382161",
"extend":"",
"finishedDate":"20210812102632",
"fundChannel":"buyerName",
"goodsInfo":"测试",
"memo":"{\"timeExpire\":\"\",\"timeStart\":\"20210812102555\",\"openid\":\"2088302324135742\",\"appid\":\"2021001155671536\", \"latitude\": \"39.916527\", \"paylimit\": \"credit_group\", \"spbillCreateIp\": \"172.22.11.2\", \"longitude\": \"116.397128\" }",
"orderAmt":"1",
"orderStatus":"SUCCESS",
"payOrderNo":"2021081222001451461401893655",
"payType":"ALI_JSAPI",
"requestDate":"20210812102555",
"respCode":"000000",
"respMsg":"交易成功",
"tradeNo":"18000020210812102438004012382161",
"transNo":"DD20210812102555029"
}

交易状态码

状态码	描述
INIT	初始化
PROCESSING	处理中
SUCCESS	成功
FAIL	失败

交易响应码

响应码	描述	解决方案
200004	订单不存在
200007	查询成功
200008	查询失败
200009	查询结果集为空
200021	订单号有误或超过查询期限!

作者：xiaochen 创建时间：2023-05-15 11:05
最后编辑：xiaochen 更新时间：2024-10-21 15:45