中国银联开放平台

文档中心

接口列表

综合支付平台

银联人脸支付申请退款

支付宝服务窗统一下单

微信公众号&小程序初始化请求

微信APP原生态预下单

关闭订单

统一下单

授权码查询

退款查询

申请退款

撤销订单

查询订单

提交刷卡支付

获取token

综合支付平台

查看产品

更新时间：2022-02-17

查询订单

接口描述

根据商户订单号或者平台订单号查询平台的具体订单信息。

请求方式

POST

生产调用地址

https://openapi.unionpay.com/upapi/unifiedTrade/query?token=[token]&sign=[sign]&ts=[ts]

测试调用地址

https://openapi.unionpay.com/upapi/unifiedTradeTest/query?token=[token]&sign=[sign]&ts=[ts]

URL请求参数

中文名称	英文名称	域类型	请求要求	备注
时间戳	ts	long	M-必填	单位毫秒，对于Java一般使用System.currentTimeMillis()获取
签名信息	sign	string	M-必填	详细签名算法可参考附录“签名样例代码”部分或参考网站“技术指南”板块第3条。
产品token	token	string	M-必填

请求报文体参数

中文名称	英文名称	域类型	域长度	默认值	请求要求	备注
签名	sign	string	32		M-必填	MD5签名结果
随机字符串	nonce_str	string	32		M-必填	随机字符串，不长于32位, 必填
平台订单号	transaction_id	string	32		O-选填	平台交易号out_trade_no和transaction_id至少一个必填，同时存在时transaction_id优先，非必填
商户订单号	out_trade_no	string	32		O-选填	商户系统内部订单号,out_trade_no和transaction_id至少一个必填，同时存在时transaction_id优先，非必填
业务类型	buss_type	string	2	00	O-选填	非必填
门店编号	op_shop_id	string	16		M-必填	必填
品牌号	brand_id	string	16		M-必填	由平台分配，必填
签名方式	sign_type	string	8	MD5	O-选填	签名类型，非必填
字符集	charset	string	8	UTF-8	O-选填	可选值UTF-8，非必填
版本号	version	string	8	2.0	O-选填	非必填
接口类型	service	string	32	unified.trade.query	M-必填	必填

同步应答参数

中文名称	英文名称	域类型	域长度	请求要求	备注
应答报文	data	map		M-必填	应答报文
应答消息	respMsg	string		M-必填	应答消息
应答码	respCd	string	4	M-必填	应答码

示例代码

请求样例报文
应答样例报文

{
"charset":"UTF-8",
   "buss_type":"00",
   "nonce_str":"SF88d5c8986bd0deb6423c92c948",
   "out_trade_no":"UP497116GZJ05",
   "service":"unified.trade.query",
   "sign":"F53145E553092CE52E4CAA4D2B49A91C",
   "op_shop_id":"sfstore1",
   "version":"2.0",
   "sign_type":"MD5",
   "brand_id":"sfbrand1"
}

复制

提示信息

提示