中国银联开放平台

文档中心

接口列表

综合支付平台

银联人脸支付申请退款

支付宝服务窗统一下单

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

微信APP原生态预下单

关闭订单

统一下单

授权码查询

退款查询

申请退款

撤销订单

查询订单

提交刷卡支付

获取token

综合支付平台

查看产品

更新时间：2022-02-17

退款查询

接口描述

提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，请在3个工作日后重新查询退款状态。

请求方式

POST

生产调用地址

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

测试调用地址

https://openapi.unionpay.com/upapi/unifiedTradeTest/refundquery?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位，必填
平台退款单号	refund_id	string	32		O-选填	refund_id、out_refund_no、out_trade_no、transaction_id四个参数必填一个，如果同时存在优先级为：refund_id>out_refund_no>transaction_id>out_trade_no，特殊说明：如果是银联、支付宝，refund_id、out_refund_no必填其中一个
商户退款单号	out_refund_no	string	32		O-选填	商户退款单号，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.refundquery	M-必填	必填

同步应答参数

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

示例代码

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

{
"charset":"UTF-8",
   "nonce_str":"SF88d5c8986bd0deb6423c92c948",
   "out_trade_no":"UP097116GZJ55",
   "out_refund_no":"Tui6375457899689",
   "service":"unified.trade.refundquery",
   "sign":"F53145E553092CE52E4CAA4D2B49A91C",
   "op_shop_id":"sfstore1",
   "version":"2.0",
   "sign_type":"MD5",
   "brand_id":"sfbrand1"
}

复制

提示信息

提示