支付宝查询退款接口（统一收单交易退款查询）

àì夳堔傛蜴生んèń 2022-06-05 00:25 244阅读 0赞

alipay.trade.fastpay.refund.query

支付宝返回码官方文档：

[https://doc.open.alipay.com/doc2/detail.htm?treeId=200&articleId=105351&docType=1\#][https_doc.open.alipay.com_doc2_detail.htm_treeId_200_articleId_105351_docType_1]

退款查询API官方文档：

[https://doc.open.alipay.com/docs/api.htm?spm=a219a.7386797.0.0.89T9QM&docType=4&apiId=1049][https_doc.open.alipay.com_docs_api.htm_spm_a219a.7386797.0.0.89T9QM_docType_4_apiId_1049]

获取公私钥方法：

[https://doc.open.alipay.com/docs/doc.htm?spm=a219a.7629140.0.0.ITH10h&treeId=58&articleId=103578&docType=1][https_doc.open.alipay.com_docs_doc.htm_spm_a219a.7629140.0.0.ITH10h_treeId_58_articleId_103578_docType_1]

*  步骤：
 *  1. 本接口加密验签方式使用RSA，生成公私钥并上传公钥到支付宝后台
 *  2. 对各请求参数进行签名处理，生成URL
 *  3.调用此URL，跳转到对应请求页面
 *  4.同步回调返回【查询结果】

一.配置公私钥

生成公私钥：[点击下载][Link 1]http://download.csdn.net/detail/ty\_hf/9626153

配置公私钥流程：

![Center][]

二.请求参数

参数的形式与格式如下，模仿即可。注意除了$sign，其他参数都是要参与验签的，也就是都要rsa加密(详细见下方demo)

\[php\] [ view plain][view plain] [ copy][view plain]

1.  https://openapi.alipay.com/gateway.do?
2.  timestamp=2013-01-01 08:08:08 
3.  &method=alipay.trade.fastpay.refund.query 
4.  &app\_id=1175 
5.  &sign\_type=RSA 
6.  &sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE 
7.  &version=1.0 
8.  &biz\_content= 
9.   \{ 
10. "trade\_no":"20150320010101001", 
11. "out\_trade\_no":"2014112611001004680073956707", 
12. "out\_request\_no":"2014112611001004680073956707"
13.  \}

三.回调参数

查询成功后，系统同步会返回如下的结果

成功回调举例：

\[php\] [ view plain][view plain] [ copy][view plain]

1.  \{ 
2.  "alipay\_trade\_fastpay\_refund\_query\_response":\{ 
3.  "code":"10000", 
4.  "msg":"Success", 
5.  "out\_request\_no":"20150320010101001", 
6.  "out\_trade\_no":"20150320010101001", 
7.  "refund\_amount":12.33, 
8.  "refund\_reason":"用户退款请求", 
9.  "total\_amount":100.20, 
10. "trade\_no":"2014112611001004680073956707"
11.  \} 
12. \}

异常回调举例：

\[php\] [ view plain][view plain] [ copy][view plain]

1. 成功回调举例：\{ 
2. "alipay\_trade\_fastpay\_refund\_query\_response":\{ 
3. "code":"20000", 
4. "msg":"Service Currently Unavailable", 
5. "sub\_code":"isp.unknow-error", 
6. "sub\_msg":"系统繁忙"
7. \} 
8. \}

四.注意问题

1.在RSA签名时，需要私钥和公钥一起参与签名。私钥与公钥都是商户通过OPENSSL来生成得出的。商户把生成出的公钥与支付宝技术人员配置好的支付宝公钥做交换。在签名时，商户要用到的是商户的私钥和支付宝的公钥。

2.本验签方式仅支持RSA加密

五.局部代码

下边代码是来自不同文件所用到的函数代码，完整的流程已经如下，少部分衔接按照逻辑加入自己系统即可

\[php\] [ view plain][view plain] [ copy][view plain]

1. /\*\* 支付宝退款查询
2. \* @param $order\_info
3. \*/
4. **private** **function** alipayRefundQuery($order\_info,$payment\_info)\{ 
5. $api\_file = BASE\_PATH.DS.'api'.DS.'refund'.DS.'alipay'.DS.'alipay.class.php'; 
6. **include** $api\_file; 
7. $payment\_config = $payment\_info\['payment\_config'\]; 
8. $alipay\_config = **array**(); 
9. $alipay\_config\['seller\_email'\] = $payment\_config\['alipay\_account'\];//账户
10. $alipay\_config\['partner'\] = $payment\_config\['alipay\_partner'\];//partner,合作者身份ID
11. $alipay\_config\['key'\] = $payment\_config\['alipay\_key'\];//自己的KEY
12. 
13. $alipaySubmit = **new** AlipaySubmit($alipay\_config); 
14. $parameter\['app\_id'\] = 'your\_app\_id'; //app\_id
15. $parameter\['method'\] = 'alipay.trade.fastpay.refund.query';//调用的接口
16. $parameter\['charset'\] = 'utf-8'; //字符集
17. $parameter\['sign\_type'\] = 'RSA'; //加密方式
18. $parameter\['timestamp'\] = date('Y-m-d H:i:s'); //时间
19. $parameter\['version'\] = '1.0'; //版本
20. 
21. $arr=**array**( 
22. 'out\_trade\_no'=>$order\_info\['trade\_no'\], 
23. 'out\_request\_no'=>$order\_info\['trade\_no'\], 
24. ); 
25. 
26. $parameter\['biz\_content'\] = json\_encode($arr);//除了公共参数的其他参数存储
27. 
28. $pay\_url = $alipaySubmit\->buildRequestParaToString($parameter); 
29. 
30. $re = file\_get\_contents($pay\_url); 
31. 
32. $re = json\_decode($re)->alipay\_trade\_fastpay\_refund\_query\_response; 
33. **if**($re\->code == "10000")\{ 
34. $result\['state'\] = true; 
35. $result\['msg'\] = $re\->msg; 
36. $result\['to\_where'\] = ''; 
37. \}**else**\{ 
38. $result\['state'\] = false; 
39. $result\['msg'\] = $re\->msg; 
40. \} 
41. **return** $result; 
42. \} 
43. 
44. 
45. 
46. /\*\*
47. \* 生成要请求给支付宝的参数数组
48. \* @param $para\_temp 请求前的参数数组
49. \* @return 要请求的参数数组字符串
50. \*/
51. **function** buildRequestParaToString($para\_temp) \{ 
52. //待请求参数数组
53. $para = $this\->buildRequestPara($para\_temp); 
54. 
55. //把参数组中所有元素，按照“参数=参数值”的模式用“&”字符拼接成字符串，并对字符串做urlencode编码
56. $request\_data = $this\->alipay\_gateway\_new.createLinkstringUrlencode($para); 
57. 
58. **return** $request\_data; 
59. \} 
60. 
61. /\*\*
62. \* 生成要请求给支付宝的参数数组
63. \* @param $para\_temp 请求前的参数数组
64. \* @return 要请求的参数数组
65. \*/
66. **function** buildRequestPara($para\_temp) \{ 
67. **if**(!empty($para\_temp\['sign\_type'\])) $this\->alipay\_config\['sign\_type'\] = strtoupper(trim($para\_temp\['sign\_type'\])); 
68. //除去待签名参数数组中的空值和签名参数
69. $para\_filter = paraFilter($para\_temp); 
70. 
71. //对待签名参数数组排序
72. $para\_sort = argSort($para\_filter); 
73. 
74. //生成签名结果
75. $mysign = $this\->buildRequestMysign($para\_sort); 
76. 
77. //签名结果与签名方式加入请求提交参数组中
78. $para\_sort\['sign'\] = $mysign; 
79. $para\_sort\['sign\_type'\] = strtoupper(trim($this\->alipay\_config\['sign\_type'\])); 
80. 
81. **return** $para\_sort; 
82. \} 
83. 
84. /\*\*
85. \* 除去数组中的空值和签名参数
86. \* @param $para 签名参数组
87. \* return 去掉空值与签名参数后的新签名参数组
88. \*/
89. **function** paraFilter($para) \{ 
90. $para\_filter = **array**(); 
91. **while** (list ($key, $val) = each ($para)) \{ 
92. **if**($key == "sign" || $key == "sign\_type" || $val == "")**continue**; 
93. **else** $para\_filter\[$key\] = $para\[$key\]; 
94. \} 
95. **return** $para\_filter; 
96. \} 
97. 
98. /\*\*
99. \* 对数组排序
100. \* @param $para 排序前的数组
101. \* return 排序后的数组
102. \*/
103. **function** argSort($para) \{ 
104. ksort($para); 
105. reset($para); 
106. **return** $para; 
107. \} 
108. 
109. /\*\*
110. \* 生成签名结果
111. \* @param $para\_sort 已排序要签名的数组
112. \* return 签名结果字符串
113. \*/
114. **function** buildRequestMysign($para\_sort) \{ 
115. //把数组所有元素，按照“参数=参数值”的模式用“&”字符拼接成字符串
116. $prestr = createLinkstring($para\_sort); 
117. 
118. $mysign = ""; 
119. **switch** (strtoupper(trim($this\->alipay\_config\['sign\_type'\]))) \{ 
120. **case** "MD5" : 
121. $mysign = md5Sign($prestr, $this\->alipay\_config\['key'\]); 
122. **break**; 
123. **case** "RSA": 
124. **require** ('AopClient.php'); 
125. $aop = **new** AopClient(); 
126. $mysign = $aop\->rsaSign($prestr); 
127. **break**; 
128. **default** : 
129. $mysign = ""; 
130. \} 
131. **return** $mysign; 
132. \} 
133. 
134. 
135. /\*\*
136. \* 把数组所有元素，按照“参数=参数值”的模式用“&”字符拼接成字符串，并对字符串做urlencode编码
137. \* @param $para 需要拼接的数组
138. \* return 拼接完成以后的字符串
139. \*/
140. **function** createLinkstringUrlencode($para) \{ 
141. $arg = ""; 
142. **while** (list ($key, $val) = each ($para)) \{ 
143. $arg.=$key."=".urlencode($val)."&"; 
144. \} 
145. //去掉最后一个&字符
146. $arg = substr($arg,0,count($arg)-2); 
147. 
148. //如果存在转义字符，那么去掉转义
149. **if**(get\_magic\_quotes\_gpc())\{ $arg = stripslashes($arg);\} 
150. **return** $arg; 
151. \}

[https_doc.open.alipay.com_doc2_detail.htm_treeId_200_articleId_105351_docType_1]: https://doc.open.alipay.com/doc2/detail.htm?treeId=200&articleId=105351&docType=1#
[https_doc.open.alipay.com_docs_api.htm_spm_a219a.7386797.0.0.89T9QM_docType_4_apiId_1049]: https://doc.open.alipay.com/docs/api.htm?spm=a219a.7386797.0.0.89T9QM&docType=4&apiId=1049
[https_doc.open.alipay.com_docs_doc.htm_spm_a219a.7629140.0.0.ITH10h_treeId_58_articleId_103578_docType_1]: https://doc.open.alipay.com/docs/doc.htm?spm=a219a.7629140.0.0.ITH10h&treeId=58&articleId=103578&docType=1
[Link 1]: http://download.csdn.net/detail/ty_hf/9626153
[Center]: /images/20220605/f5b1fa6af4c64ed28222f9b1c8bcf418.png
[view plain]: http://blog.csdn.net/ty_hf/article/details/52486131#