【微信小程序】退款功能教程（含申请退款和退款回调）

1、一定要区分小程序和公众号的退款，唯一的区别就是 appid不一样，其他的都是一样的。

不废话，直接写代码了啊。放大招！！！

然后，需要注意的：最好是把证书放在下面的php的同级或者下级。

证书的路径一定要是服务器的根路径，比如E:\tupuu\WWW\XXX。而像http://www.xxx.com/../.. 是不行的，会报58错误。

DEMO1、用来调试退款流程，在浏览器直接访问这个php文件。

<?php

/**

 * 微信公众号和小程序退款申请接口-demo

 * ====================================================

 * 注意：同一笔单的部分退款需要设置相同的订单号和不同的

 * out_refund_no。一笔退款失败后重新提交，要采用原来的

 * out_refund_no。总退款金额不能超过用户实际支付金额(现

 * 金券金额不能退款)。

*/

//include_once(S_ROOT ."xxpay/WxPayPubHelper/WxPayPubHelper.miniprogram.php");

     //输入需退款的订单号

     if (!isset($_POST["out_trade_no"]) || !isset($_POST["refund_fee"]))

     {

         $out_trade_no = " ";

         $refund_fee = "1";

     }else{

         //echo "退款订单号：".$_POST['out_trade_no'];

         $order_msg= array(

            'out_trade_no'=>'homeX20171206155833_1180',

             'out_trade_no'=>'homeX20171206155833_1180',

             'order_amount'=>'0.02',

         );

         $appid =        'wx60****d';//如果是公众号 就是公众号的appid;小程序就是小程序的appid

         $mch_id =       '126****01';

         $KEY = 'xixi***09000908bkj';

         $nonce_str =    randomkeys(32);//随机字符串

         $op_user_id = $mch_id;

         $out_trade_no = $order_msg['out_trade_no'];//商户传微信的订单号

         $out_refund_no = $order_msg['out_trade_no'];//用户请求退款id对应的out_trade_no订单号

         $refund_fee =1;//退款金额

         $total_fee = 2;//订单总金额

         //这里是按照顺序的 因为下面的签名是按照(字典序)顺序 排序错误 肯定出错

         $post['appid'] = $appid;

         $post['mch_id'] = $mch_id;

         $post['nonce_str'] = $nonce_str;//随机字符串

         $post['op_user_id'] = $mch_id;

         $post['out_refund_no'] = $out_refund_no;

         $post['out_trade_no'] = $out_trade_no;

         $post['refund_fee'] = $refund_fee;

         $post['total_fee'] = $total_fee;        //总金额 最低为一分钱 必须是整数

         $sign = MakeSign($post,$KEY);              //签名

         $post_xml = '<xml>

                       <appid>'.$appid.'</appid>

                       <mch_id>'.$mch_id.'</mch_id>

                       <nonce_str>'.$nonce_str.'</nonce_str>

                       <op_user_id>'.$mch_id.'</op_user_id>

                       <out_refund_no>'.$out_refund_no.'</out_refund_no>

                       <out_trade_no>'.$out_trade_no.'</out_trade_no>

                       <refund_fee>'.$refund_fee.'</refund_fee>

                       <total_fee>'.$total_fee.'</total_fee>

                       <sign>'.$sign.'</sign>

                    </xml>';

         //echo $post_xml;

         //申请退款接口

         $url = 'https://api.mch.weixin.qq.com/secapi/pay/refund';

         $xml = curl_post_ssl($url,$post_xml);     //POST方式请求http,支付无需证书;申请退款api需要证书校验

         $array = xml2array($xml);               //将【申请退款】api返回xml数据转换成数组，全要大写

         //var_dump($array);

         if($array['RETURN_CODE'] == 'SUCCESS' && $array['RESULT_CODE'] == 'SUCCESS'){//退款业务已受理//

    //          $up['order_status'] = 'refunding';  //退款申请中

    //          $up['order_id'] = $order_id;

    //          $up['order_time'] = time();         //退款申请时间

    //          if(M("home_order","xxf_witkey_")->save($up)){

    //              $model_demo = new \Home\Model\HomeorderModel('home_order','xxf_witkey_');

    //              $res = $model_demo->home_order_list($userwx_info['uid'],19);

    //              if(!$res){

    //                  exit('订单信息有误');

    //              }else{

    //                  echo json_encode($res);exit;

    //              }

    //          }

    　　　　　　// for 调试

             echo "业务结果：".$array['RETURN_CODE']."<br>";

             echo "错误代码：".$array['err_code']."<br>";

             echo "错误代码描述：".$array['err_code_des']."<br>";

             echo "公众账号ID：".$array['APPID']."<br>";

             echo "商户号：".$array['MCH_ID']."<br>";

             echo "子商户号：".$array['sub_mch_id']."<br>";

             echo "设备号：".$array['device_info']."<br>";

             echo "签名：".$array['SIGN']."<br>";

             echo "微信订单号：".$array['transaction_id']."<br>";

             echo "商户订单号：".$array['OUT_TRADE_NO']."<br>";

             echo "商户退款单号：".$array['OUT_REFUND_NO']."<br>";

             echo "微信退款单号：".$array['refund_idrefund_id']."<br>";

             echo "订单总金额：".$array['TOTAL_FEE']."<br>";

             echo "退款金额：".$array['REFUND_FEE']."<br>";

             echo "现金券退款金额：".$array['coupon_refund_fee']."<br>";

         }else{

            echo "RETURN_CODE：".$array['RETURN_CODE']."<br>";

             echo "RESULT_CODE：".$array['RESULT_CODE']."<br>";

             echo $array['RETURN_MSG']."<br>";

             echo "错误代码：".$array['ERR_CODE']."<br>";

             echo "错误代码描述：".$array['ERR_CODE_DES']."<br>";

             exit；

echo $array['RETURN_MSG'];exit;

         }

     }

     /* php获取随机字符（数字+英文）函数，长度可以进行控制 */

     function randomkeys($length) {

         $key = null;

         $pattern = '1234567890abcdefghijklmnopqrstuvwxyz

                   ABCDEFGHIJKLOMNOPQRSTUVWXYZ';

         for ($i = 0; $i < $length; $i++) {

             $key .= $pattern {mt_rand(0, 35)};

         }

         return $key;

     }

     /**

      * 生成签名, $KEY就是支付key

      * @return 签名

      */

     function MakeSign( $params,$KEY){

         //签名步骤一：按字典序排序数组参数

         ksort($params);

         $string = ToUrlParams($params);  //参数进行拼接key=value&k=v

         //签名步骤二：在string后加入KEY

         $string = $string . "&key=".$KEY;

         //签名步骤三：MD5加密

         $string = md5($string);

         //签名步骤四：所有字符转为大写

         $result = strtoupper($string);

         return $result;

     }

     /**

      * 将参数拼接为url: key=value&key=value

      * @param $params

      * @return string

      */

     function ToUrlParams( $params ){

         $string = '';

         if( !empty($params) ){

             $array = array();

             foreach( $params as $key => $value ){

                 $array[] = $key.'='.$value;

             }

             $string = implode("&",$array);

         }

         return $string;

     }

     //获取xml里面数据，转换成array

     function xml2array($xml){

         $p = xml_parser_create();

         xml_parse_into_struct($p, $xml, $vals, $index);

         xml_parser_free($p);

         $data = "";

         foreach ($index as $key=>$value) {

             if($key == 'xml' || $key == 'XML') continue;

             $tag = $vals[$value[0]]['tag'];

             $value = $vals[$value[0]]['value'];

             $data[$tag] = $value;

         }

         return $data;

     }

    function curl_post_ssl($url, $vars, $second=30,$aHeader=array())

     {

         $ch = curl_init();

         //超时时间

         curl_setopt($ch,CURLOPT_TIMEOUT,$second);

         curl_setopt($ch,CURLOPT_RETURNTRANSFER, 1);

         //这里设置代理，如果有的话

         //curl_setopt($ch,CURLOPT_PROXY, '10.206.30.98');

         //curl_setopt($ch,CURLOPT_PROXYPORT, 8080);

         curl_setopt($ch,CURLOPT_URL,$url);

         curl_setopt($ch,CURLOPT_SSL_VERIFYPEER,FALSE);

         curl_setopt($ch,CURLOPT_SSL_VERIFYHOST,FALSE);

         //以下两种方式需选择一种

         //第一种方法，cert 与 key 分别属于两个.pem文件

         //默认格式为PEM，可以注释

         curl_setopt($ch,CURLOPT_SSLCERTTYPE,'PEM');

         curl_setopt($ch,CURLOPT_SSLCERT,getcwd().'/cert/apiclient_cert.pem');//getcwd()=》当前工作目录，不含最下级的/

         //默认格式为PEM，可以注释

         curl_setopt($ch,CURLOPT_SSLKEYTYPE,'PEM');

         curl_setopt($ch,CURLOPT_SSLKEY,getcwd().'/cert/apiclient_key.pem');

         //第二种方式，两个文件合成一个.pem文件

         //curl_setopt($ch,CURLOPT_SSLCERT,getcwd().'/all.pem');

         if( count($aHeader) >= 1 ){

             curl_setopt($ch, CURLOPT_HTTPHEADER, $aHeader);

         }

         curl_setopt($ch,CURLOPT_POST, 1);

         curl_setopt($ch,CURLOPT_POSTFIELDS,$vars);

         $data = curl_exec($ch); //返回xml

         if($data){

             curl_close($ch);

             return $data;

         }

         else {

             $error = curl_errno($ch);

             echo "call faild, errorCode:$error\n";

             curl_close($ch);

             return false;

         }

     }

?>

<!DOCTYPE HTML>

<html>

<head>

    <meta charset="UTF-8">

    <title>微信安全支付</title>

</head>

<body>

    </br></br></br></br>

    <div align="center">

        <form  action="./refund_miniprogram.php" method="post">

            <p>申请退款：</p>

            <p>退款单号: <input type="text" name="out_trade_no" value=<?php echo $out_trade_no; ?> ></p>

            <p>退款金额(分): <input type="text" name="refund_fee" value=<?php echo $refund_fee; ?> ></p>

            <button type="submit" >提交</button>

        </form>

        </br>

        <a href="../index.php">返回首页</a>

    </div>

</body>

</html>

DEMO2、在其他的php文件中引用该退款流程

//在这里将订单的id、out_trade_no、out_refund_no、总金额、退款金额都拿到，然后进行下面步骤
include_once S_ROOT.'xxpay/wxzf/refund_miniprogram.php';    //小程序退款

<?php

/**

 * 退款申请接口-demo

 * ====================================================

 * 注意：同一笔单的部分退款需要设置相同的订单号和不同的

 * out_refund_no。一笔退款失败后重新提交，要采用原来的

 * out_refund_no。总退款金额不能超过用户实际支付金额(现

 * 金券金额不能退款)。

*/

         $appid =        'wx6***1d';//如果是公众号 就是公众号的appid;小程序就是小程序的appid

         $mch_id =       '12*****201';

         $KEY = 'xi***********kj';

         $nonce_str =    randomkeys(32);//随机字符串

         $op_user_id = $mch_id;

         $out_trade_no = $order_no['out_trade_no'];//商户传微信的订单号

         $out_refund_no = $order_no['out_trade_no'];//用户请求退款id对应的out_trade_no订单号

//          $refund_fee = 1;//退款金额

//          $total_fee = 2;//订单总金额

         $refund_fee = intval($refund_amount*100);//退款金额

         $total_fee = intval($total_amount*100);//订单总金额

         //这里是按照顺序的 因为下面的签名是按照(字典序)顺序 排序错误 肯定出错

         $post['appid'] = $appid;

         $post['mch_id'] = $mch_id;

         $post['nonce_str'] = $nonce_str;//随机字符串

         $post['op_user_id'] = $mch_id;

         $post['out_refund_no'] = $out_refund_no;

         $post['out_trade_no'] = $out_trade_no;

         $post['refund_fee'] = $refund_fee;

         $post['total_fee'] = $total_fee;        //总金额 最低为一分钱 必须是整数

         $sign = MakeSign($post,$KEY);              //签名

         $post_xml = '<xml>

                       <appid>'.$appid.'</appid>

                       <mch_id>'.$mch_id.'</mch_id>

                       <nonce_str>'.$nonce_str.'</nonce_str>

                       <op_user_id>'.$mch_id.'</op_user_id>

                       <out_refund_no>'.$out_refund_no.'</out_refund_no>

                       <out_trade_no>'.$out_trade_no.'</out_trade_no>

                       <refund_fee>'.$refund_fee.'</refund_fee>

                       <total_fee>'.$total_fee.'</total_fee>

                       <sign>'.$sign.'</sign>

                    </xml>';

         //echo $post_xml;

         //申请退款接口

         $url = 'https://api.mch.weixin.qq.com/secapi/pay/refund';

         $xml = curl_post_ssl($url,$post_xml);     //POST方式请求http,支付无需证书;申请退款api需要证书校验

         $array = xml2array($xml);               //将【申请退款】api返回xml数据转换成数组，全要大写

         //var_dump($array);

         if($array['RETURN_CODE'] == 'SUCCESS' && $array['RESULT_CODE'] == 'SUCCESS'){//退款业务已受理//

            //数据库更新操作

             /* for 调试  */

//              echo "业务结果：".$array['RETURN_CODE']."<br>";

//              echo "错误代码：".$array['err_code']."<br>";

//              echo "错误代码描述：".$array['err_code_des']."<br>";

//              echo "公众账号ID：".$array['APPID']."<br>";

//              echo "商户号：".$array['MCH_ID']."<br>";

//              echo "子商户号：".$array['sub_mch_id']."<br>";

//              echo "设备号：".$array['device_info']."<br>";

//              echo "签名：".$array['SIGN']."<br>";

//              echo "微信订单号：".$array['transaction_id']."<br>";

//              echo "商户订单号：".$array['OUT_TRADE_NO']."<br>";

//              echo "商户退款单号：".$array['OUT_REFUND_NO']."<br>";

//              echo "微信退款单号：".$array['refund_idrefund_id']."<br>";

//              echo "订单总金额：".$array['TOTAL_FEE']."<br>";

//              echo "退款金额：".$array['REFUND_FEE']."<br>";

//              echo "现金券退款金额：".$array['coupon_refund_fee']."<br>";

         }else{

             echo "RETURN_CODE：".$array['RETURN_CODE']."<br>";

             echo "RESULT_CODE：".$array['RESULT_CODE']."<br>";

             echo $array['RETURN_MSG']."<br>";

             echo "错误代码：".$array['ERR_CODE']."<br>";

             echo "错误代码描述：".$array['ERR_CODE_DES']."<br>";

             exit;

         }

//      }

     /* php获取随机字符（数字+英文）函数，长度可以进行控制 */

     function randomkeys($length) {

         $key = null;

         $pattern = '1234567890abcdefghijklmnopqrstuvwxyz

                   ABCDEFGHIJKLOMNOPQRSTUVWXYZ';

         for ($i = 0; $i < $length; $i++) {

             $key .= $pattern {mt_rand(0, 35)};

         }

         return $key;

     }

     /**

      * 生成签名, $KEY就是支付key

      * @return 签名

      */

     function MakeSign( $params,$KEY){

         //签名步骤一：按字典序排序数组参数

         ksort($params);

         $string = ToUrlParams($params);  //参数进行拼接key=value&k=v

         //签名步骤二：在string后加入KEY

         $string = $string . "&key=".$KEY;

         //签名步骤三：MD5加密

         $string = md5($string);

         //签名步骤四：所有字符转为大写

         $result = strtoupper($string);

         return $result;

     }

     /**

      * 将参数拼接为url: key=value&key=value

      * @param $params

      * @return string

      */

     function ToUrlParams( $params ){

         $string = '';

         if( !empty($params) ){

             $array = array();

             foreach( $params as $key => $value ){

                 $array[] = $key.'='.$value;

             }

             $string = implode("&",$array);

         }

         return $string;

     }

     //获取xml里面数据，转换成array,key键均大写

     function xml2array($xml){

         $p = xml_parser_create();

         xml_parse_into_struct($p, $xml, $vals, $index);

         xml_parser_free($p);

         $data = "";

         foreach ($index as $key=>$value) {

             if($key == 'xml' || $key == 'XML') continue;

             $tag = $vals[$value[0]]['tag'];

             $value = $vals[$value[0]]['value'];

             $data[$tag] = $value;

         }

         return $data;

     }

    function curl_post_ssl($url, $vars, $second=30,$aHeader=array())

     {

         $ch = curl_init();

         //超时时间

         curl_setopt($ch,CURLOPT_TIMEOUT,$second);

         curl_setopt($ch,CURLOPT_RETURNTRANSFER, 1);

         //这里设置代理，如果有的话

         //curl_setopt($ch,CURLOPT_PROXY, '10.206.30.98');

         //curl_setopt($ch,CURLOPT_PROXYPORT, 8080);

         curl_setopt($ch,CURLOPT_URL,$url);

         curl_setopt($ch,CURLOPT_SSL_VERIFYPEER,FALSE);

         curl_setopt($ch,CURLOPT_SSL_VERIFYHOST,FALSE);

         //以下两种方式需选择一种

         //第一种方法，cert 与 key 分别属于两个.pem文件

         //默认格式为PEM，可以注释

         curl_setopt($ch,CURLOPT_SSLCERTTYPE,'PEM');

         //curl_setopt($ch,CURLOPT_SSLCERT,getcwd().'/cert/apiclient_cert.pem');//getcwd()=》当前工作目录，不含最下级的/

         curl_setopt($ch,CURLOPT_SSLCERT,S_ROOT.'x**ay/wxzf/cert/apiclient_cert.pem');//这种获取绝对路径，请使用文件根目录E:\putuu\WWW\你的项目放置文件夹名\，而非站点目录

         //默认格式为PEM，可以注释

         curl_setopt($ch,CURLOPT_SSLKEYTYPE,'PEM');

         //curl_setopt($ch,CURLOPT_SSLKEY,getcwd().'/cert/apiclient_key.pem');

         curl_setopt($ch,CURLOPT_SSLKEY,S_ROOT.'x**ay/wxzf/cert/apiclient_key.pem');

         //第二种方式，两个文件合成一个.pem文件

         //curl_setopt($ch,CURLOPT_SSLCERT,getcwd().'/all.pem');

         if( count($aHeader) >= 1 ){

             curl_setopt($ch, CURLOPT_HTTPHEADER, $aHeader);

         }

         curl_setopt($ch,CURLOPT_POST, 1);

         curl_setopt($ch,CURLOPT_POSTFIELDS,$vars);

         $data = curl_exec($ch); //返回xml

         if($data){

             curl_close($ch);

             return $data;

         }

         else {

             $error = curl_errno($ch);

             echo "call faild, errorCode:$error\n";

             curl_close($ch);

             return false;

         }

     }

?>

退款部分结束。

下面是退款回调

DEMO3、退款回调

1）首先去：商户平台-交易中心-退款配置中配置notify_url。（和支付回调类似）

2）解密步骤：【微信小程序】退款功能教程（含申请退款和退款回调）-LMLPHP

3）上面的加密串A是什么？回答：XML里面的<req_info>字段。

【微信小程序】退款功能教程（含申请退款和退款回调）-LMLPHP

4）如何获取？==》核心： refund_decrypt($str, $key) ：其中参数$str是加密串A<req_info>（string类型），参数$key是md5后的商户key。

【微信小程序】退款功能教程（含申请退款和退款回调）-LMLPHP

//明文=refund_decrypt(密文,MD5(商户秘钥));明文格式如下：

【微信小程序】退款功能教程（含申请退款和退款回调）-LMLPHP

5）那么获得xml格式明文后，咋办？再次xml转array，得到里面的out_trade_no，订单号都得到了，你想干嘛干嘛去。至此，整个退款和回调结束。

下面附上代码：

<?php

//define ( "IN_KEKE", TRUE );

//require_once (dirname ( dirname ( dirname ( __FILE__ ) ) ) . DIRECTORY_SEPARATOR . 'app_comm.php');//引入数据库db工厂和其他配置

//申请退款，微信公众号和小程序退款成功的回调url是同一个

//举例如下：

// <xml>

// <return_code>SUCCESS</return_code>

// <appid><![CDATA[wx2421b1c4370ec43b]]></appid>

// <mch_id><![CDATA[10000100]]></mch_id>

// <nonce_str><![CDATA[TeqClE3i0mvn3DrK]]></nonce_str>

// <req_info><![CDATA[T87GAHG17TGAHG1TGHAHAHA1Y1CIOA9UGJH1GAHV871HAGAGQYQQPOOJMXNBCXBVNMNMAJAA]]></req_info>

// </xml>

//解密步骤如下：

// （1）对加密串A<req_info>做base64解码，得到加密串B

// （2）对商户key做md5，得到32位小写key* ( key设置路径：微信商户平台(pay.weixin.qq.com)-->账户设置-->API安全-->密钥设置 )

// （3）用key*对加密串B做AES-256-ECB解密

//这里测试微信是否访问了当前url

//$li = db_factory::execute ( sprintf ( " update %switkey_ho*** set order_status='refunded' where out_trade_no= '%s' ",TABLEPRE,'ho*****2') );

//var_dump($li);

///////////////////////////////////////////////////-------//////////////////////////////////

//商户密钥$weixin_key，解密必要,按照上面步骤(2)(3)解密

$weixin_key = '**********************';

$post = post_data();    //接受微信POST过来的XML数据

$post_data = xml_to_array($post);   //XML转数组Array

$weixin_post_string = $post_data['req_info'];   //微信post过来的加密串A，字符串类型

//明文=refund_decrypt(密文,MD5(商户秘钥));返回XML格式明文，包含out_trade_no/out_refund_no等信息

$refund_xml_string = refund_decrypt($weixin_post_string, md5($weixin_key));

$refundArr = xml_to_array($refund_xml_string);

if(isset($refundArr['out_trade_no'])){//$refundArr['out_trade_no']字符串类型

    //数据库操作，将订单状态改为退款成功和其他操作

echo return_msg();

}

//对参数加密串A<req_info>进行AES-256（ECB模式，PKCS7Padding）解密，得到加密前参数。

function refund_decrypt($str, $key) {

    $str = base64_decode($str);

    $str = mcrypt_decrypt(MCRYPT_RIJNDAEL_128, $key, $str, MCRYPT_MODE_ECB);

    $block = mcrypt_get_block_size('rijndael_128', 'ecb');

    $pad = ord($str[($len = strlen($str)) - 1]);

    $len = strlen($str);

    $pad = ord($str[$len - 1]);

    return substr($str, 0, strlen($str) - $pad);

}

/*

 *  微信是用$GLOBALS['HTTP_RAW_POST_DATA'];这个函数接收微信支付成功post给商户的数据

 */

function post_data(){

    $receipt = $_REQUEST;

    if($receipt==null){

        $receipt = file_get_contents("php://input");

        if($receipt == null){

            $receipt = $GLOBALS['HTTP_RAW_POST_DATA'];

        }

    }

    return $receipt;

}

/**

 * 将xml转为array

 */

function xml_to_array($xml){

    if(!$xml){

        return false;

    }

    //将XML转为array

    //禁止引用外部xml实体

    libxml_disable_entity_loader(true);

    $data = json_decode(json_encode(simplexml_load_string($xml, 'SimpleXMLElement', LIBXML_NOCDATA)), true);

    return $data;

}

/* 发送给微信的退款回调消息 -xzz1207 */

function return_msg(){

    $msg = '<xml>

              <return_code><![CDATA[SUCCESS]]></return_code>

              <return_msg><![CDATA[OK]]></return_msg>

            </xml>';

    return $msg;

}

?>