123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604 |
- <?php
- require_once "WxPay.Exception.php";
- require_once "WxPay.Data.php";
- /**
- *
- * 接口访问类,包含所有微信支付API列表的封装,类中方法为static方法,
- * 每个接口有默认超时时间(除提交被扫支付为10s,上报超时时间为1s外,其他均为6s)
- *
- * @author widyhu
- *
- */
- class WxPayApi {
- /**
- *
- * 统一下单,WxPayUnifiedOrder中out_trade_no、body、total_fee、trade_type、appid、mchid、spbill_create_ip必填
- * nonce_str不需要填入
- *
- * @param WxPayUnifiedOrder $inputObj
- * @param int $timeOut
- *
- * @param array $config
- *
- * @return array 成功时返回
- * @throws WxPayException
- */
- public static function unifiedOrder($inputObj, $timeOut = 6, array $config) {
- $url = "https://api.mch.weixin.qq.com/pay/unifiedorder";
- //检测必填参数
- if (!$inputObj->IsOut_trade_noSet()) {
- throw new WxPayException("缺少统一支付接口必填参数out_trade_no!");
- } else if (!$inputObj->IsBodySet()) {
- throw new WxPayException("缺少统一支付接口必填参数body!");
- } else if (!$inputObj->IsTotal_feeSet()) {
- throw new WxPayException("缺少统一支付接口必填参数total_fee!");
- } else if (!$inputObj->IsTrade_typeSet()) {
- throw new WxPayException("缺少统一支付接口必填参数trade_type!");
- }
- //关联参数
- // if($inputObj->GetTrade_type() == "JSAPI" && !$inputObj->IsOpenidSet()){
- // throw new WxPayException("统一支付接口中,缺少必填参数openid!trade_type为JSAPI时,openid为必填参数!");
- // }
- // if($inputObj->GetTrade_type() == "NATIVE" && !$inputObj->IsProduct_idSet()){
- // throw new WxPayException("统一支付接口中,缺少必填参数product_id!trade_type为JSAPI时,product_id为必填参数!");
- // }
- if ($inputObj->GetTrade_type() == "APP" && !$inputObj->IsAppidSet()) {
- throw new WxPayException("统一支付接口中,缺少必填参数app_id!trade_type为APP时,app_id为必填参数!");
- }
- $inputObj->SetNonce_str(self::getNonceStr());//随机字符串
- //签名
- $inputObj->SetSign();
- $xml = $inputObj->ToXml();
- $startTimeStamp = self::getMillisecond();//请求开始时间
- $response = self::postXmlCurl($xml, $url, false, $timeOut, $config);
- $result = WxPayResults::Init($response, $config);
- // self::reportCostTime($url, $startTimeStamp, $result, $config);//上报请求花费时间
- return $result;
- }
- /**
- *
- * 查询订单,WxPayOrderQuery中out_trade_no、transaction_id至少填一个
- * appid、mchid、spbill_create_ip、nonce_str不需要填入
- *
- * @param WxPayOrderQuery $inputObj
- * @param int $timeOut
- *
- * @param array $config
- *
- * @return array 成功时返回,其他抛异常
- * @throws WxPayException
- */
- public static function orderQuery($inputObj, $timeOut = 6, array $config) {
- $url = "https://api.mch.weixin.qq.com/pay/orderquery";
- //检测必填参数
- if (!$inputObj->IsOut_trade_noSet() && !$inputObj->IsTransaction_idSet()) {
- throw new WxPayException("订单查询接口中,out_trade_no、transaction_id至少填一个!");
- }
- $inputObj->SetAppid($config['app_id']);//公众账号ID
- $inputObj->SetMch_id($config['mch_id']);//商户号
- $inputObj->SetNonce_str(self::getNonceStr());//随机字符串
- $inputObj->setKey($config['key']);
- $inputObj->SetSign();//签名
- $xml = $inputObj->ToXml();
- $startTimeStamp = self::getMillisecond();//请求开始时间
- $response = self::postXmlCurl($xml, $url, false, $timeOut, $config);
- $result = WxPayResults::Init($response, $config);
- self::reportCostTime($url, $startTimeStamp, $result, $config);//上报请求花费时间
- return $result;
- }
- /**
- *
- * 关闭订单,WxPayCloseOrder中out_trade_no必填
- * appid、mchid、spbill_create_ip、nonce_str不需要填入
- *
- * @param WxPayCloseOrder $inputObj
- * @param int $timeOut
- *
- * @param array $config
- *
- * @return string 成功时返回,其他抛异常
- * @throws WxPayException
- */
- public static function closeOrder($inputObj, $timeOut = 6, array $config) {
- $url = "https://api.mch.weixin.qq.com/pay/closeorder";
- //检测必填参数
- if (!$inputObj->IsOut_trade_noSet()) {
- throw new WxPayException("订单查询接口中,out_trade_no必填!");
- }
- $inputObj->SetAppid($config['app_id']);//公众账号ID
- $inputObj->SetMch_id($config['mch_id']);//商户号
- $inputObj->SetNonce_str(self::getNonceStr());//随机字符串
- $inputObj->SetSign();//签名
- $xml = $inputObj->ToXml();
- $startTimeStamp = self::getMillisecond();//请求开始时间
- $response = self::postXmlCurl($xml, $url, false, $timeOut, $config);
- $result = WxPayResults::Init($response, $config);
- self::reportCostTime($url, $startTimeStamp, $result, $config);//上报请求花费时间
- return $result;
- }
- /**
- *
- * 申请退款,WxPayRefund中out_trade_no、transaction_id至少填一个且
- * out_refund_no、total_fee、refund_fee、op_user_id为必填参数
- * appid、mchid、spbill_create_ip、nonce_str不需要填入
- *
- * @param WxPayRefund $inputObj
- * @param int $timeOut
- *
- * @param array $config
- *
- * @return string 成功时返回,其他抛异常
- * @throws WxPayException
- */
- public static function refund($inputObj, $timeOut = 6, array $config) {
- $url = "https://api.mch.weixin.qq.com/secapi/pay/refund";
- //检测必填参数
- if (!$inputObj->IsOut_trade_noSet() && !$inputObj->IsTransaction_idSet()) {
- throw new WxPayException("退款申请接口中,out_trade_no、transaction_id至少填一个!");
- } else if (!$inputObj->IsOut_refund_noSet()) {
- throw new WxPayException("退款申请接口中,缺少必填参数out_refund_no!");
- } else if (!$inputObj->IsTotal_feeSet()) {
- throw new WxPayException("退款申请接口中,缺少必填参数total_fee!");
- } else if (!$inputObj->IsRefund_feeSet()) {
- throw new WxPayException("退款申请接口中,缺少必填参数refund_fee!");
- } else if (!$inputObj->IsOp_user_idSet()) {
- throw new WxPayException("退款申请接口中,缺少必填参数op_user_id!");
- }
- $inputObj->SetAppid($config['app_id']);//公众账号ID
- $inputObj->SetMch_id($config['mch_id']);//商户号
- $inputObj->SetNonce_str(self::getNonceStr());//随机字符串
- $inputObj->SetSign();//签名
- $xml = $inputObj->ToXml();
- $startTimeStamp = self::getMillisecond();//请求开始时间
- $response = self::postXmlCurl($xml, $url, true, $timeOut, $config);
- $result = WxPayResults::Init($response, $config);
- self::reportCostTime($url, $startTimeStamp, $result, $config);//上报请求花费时间
- return $result;
- }
- /**
- *
- * 查询退款
- * 提交退款申请后,通过调用该接口查询退款状态。退款有一定延时,
- * 用零钱支付的退款20分钟内到账,银行卡支付的退款3个工作日后重新查询退款状态。
- * WxPayRefundQuery中out_refund_no、out_trade_no、transaction_id、refund_id四个参数必填一个
- * appid、mchid、spbill_create_ip、nonce_str不需要填入
- *
- * @param WxPayRefundQuery $inputObj
- * @param int $timeOut
- *
- * @param array $config
- *
- * @return string
- * @throws WxPayException
- */
- public static function refundQuery($inputObj, $timeOut = 6, array $config = []) {
- $url = "https://api.mch.weixin.qq.com/pay/refundquery";
- //检测必填参数
- if (!$inputObj->IsOut_refund_noSet()
- && !$inputObj->IsOut_trade_noSet()
- && !$inputObj->IsTransaction_idSet()
- && !$inputObj->IsRefund_idSet()
- ) {
- throw new WxPayException("退款查询接口中,out_refund_no、out_trade_no、transaction_id、refund_id四个参数必填一个!");
- }
- $inputObj->SetAppid($config['app_id']);//公众账号ID
- $inputObj->SetMch_id($config['mch_id']);//商户号
- $inputObj->SetNonce_str(self::getNonceStr());//随机字符串
- $inputObj->SetSign();//签名
- $xml = $inputObj->ToXml();
- $startTimeStamp = self::getMillisecond();//请求开始时间
- $response = self::postXmlCurl($xml, $url, false, $timeOut, $config);
- $result = WxPayResults::Init($response, $config);
- self::reportCostTime($url, $startTimeStamp, $result, $config);//上报请求花费时间
- return $result;
- }
- /**
- * 下载对账单,WxPayDownloadBill中bill_date为必填参数
- * appid、mchid、spbill_create_ip、nonce_str不需要填入
- *
- * @param WxPayDownloadBill $inputObj
- * @param int $timeOut
- *
- * @param array $config
- *
- * @return string
- * @throws WxPayException
- */
- public static function downloadBill($inputObj, $timeOut = 6, array $config) {
- $url = "https://api.mch.weixin.qq.com/pay/downloadbill";
- //检测必填参数
- if (!$inputObj->IsBill_dateSet()) {
- throw new WxPayException("对账单接口中,缺少必填参数bill_date!");
- }
- $inputObj->SetAppid($config['app_id']);//公众账号ID
- $inputObj->SetMch_id($config['mch_id']);//商户号
- $inputObj->SetNonce_str(self::getNonceStr());//随机字符串
- $inputObj->SetSign();//签名
- $xml = $inputObj->ToXml();
- $response = self::postXmlCurl($xml, $url, false, $timeOut, $config);
- if (substr($response, 0, 5) == "<xml>") {
- return "";
- }
- return $response;
- }
- /**
- * 提交被扫支付API
- * 收银员使用扫码设备读取微信用户刷卡授权码以后,二维码或条码信息传送至商户收银台,
- * 由商户收银台或者商户后台调用该接口发起支付。
- * WxPayWxPayMicroPay中body、out_trade_no、total_fee、auth_code参数必填
- * appid、mchid、spbill_create_ip、nonce_str不需要填入
- *
- * @param WxPayMicroPay $inputObj
- * @param int $timeOut
- *
- * @param array $config
- *
- * @return array
- * @throws WxPayException
- */
- public static function micropay(WxPayMicroPay $inputObj, $timeOut = 10, array $config) {
- $url = "https://api.mch.weixin.qq.com/pay/micropay";
- //检测必填参数
- if (!$inputObj->IsBodySet()) {
- throw new WxPayException("提交被扫支付API接口中,缺少必填参数body!");
- } else if (!$inputObj->IsOut_trade_noSet()) {
- throw new WxPayException("提交被扫支付API接口中,缺少必填参数out_trade_no!");
- } else if (!$inputObj->IsTotal_feeSet()) {
- throw new WxPayException("提交被扫支付API接口中,缺少必填参数total_fee!");
- } else if (!$inputObj->IsAuth_codeSet()) {
- throw new WxPayException("提交被扫支付API接口中,缺少必填参数auth_code!");
- }
- $inputObj->SetAppid($config['app_id']);//公众账号ID
- $inputObj->SetMch_id($config['mch_id']);//商户号
- $inputObj->SetNonce_str(self::getNonceStr());//随机字符串
- $inputObj->SetSign();//签名
- $xml = $inputObj->ToXml();
- $startTimeStamp = self::getMillisecond();//请求开始时间
- $response = self::postXmlCurl($xml, $url, false, $timeOut, $config);
- $result = WxPayResults::Init($response, $config);
- self::reportCostTime($url, $startTimeStamp, $result, $config);//上报请求花费时间
- return $result;
- }
- /**
- *
- * 撤销订单API接口,WxPayReverse中参数out_trade_no和transaction_id必须填写一个
- * appid、mchid、spbill_create_ip、nonce_str不需要填入
- *
- * @param WxPayReverse $inputObj
- * @param int $timeOut
- *
- * @param array $config
- *
- * @return array
- * @throws WxPayException
- */
- public static function reverse(WxPayReverse $inputObj, $timeOut = 6, array $config) {
- $url = "https://api.mch.weixin.qq.com/secapi/pay/reverse";
- //检测必填参数
- if (!$inputObj->IsOut_trade_noSet() && !$inputObj->IsTransaction_idSet()) {
- throw new WxPayException("撤销订单API接口中,参数out_trade_no和transaction_id必须填写一个!");
- }
- $inputObj->SetAppid($config['app_id']);//公众账号ID
- $inputObj->SetMch_id($config['mch_id']);//商户号
- $inputObj->SetNonce_str(self::getNonceStr());//随机字符串
- $inputObj->SetSign();//签名
- $xml = $inputObj->ToXml();
- $startTimeStamp = self::getMillisecond();//请求开始时间
- $response = self::postXmlCurl($xml, $url, true, $timeOut, $config);
- $result = WxPayResults::Init($response, $config);
- self::reportCostTime($url, $startTimeStamp, $result, $config);//上报请求花费时间
- return $result;
- }
- /**
- *
- * 测速上报,该方法内部封装在report中,使用时请注意异常流程
- * WxPayReport中interface_url、return_code、result_code、user_ip、execute_time_必填
- * appid、mchid、spbill_create_ip、nonce_str不需要填入
- *
- * @param WxPayReport $inputObj
- * @param int $timeOut
- *
- * @param array $config
- *
- * @return string
- * @throws WxPayException
- */
- public static function report(WxPayReport $inputObj, $timeOut = 1, array $config) {
- $url = "https://api.mch.weixin.qq.com/payitil/report";
- //检测必填参数
- if (!$inputObj->IsInterface_urlSet()) {
- throw new WxPayException("接口URL,缺少必填参数interface_url!");
- }
- if (!$inputObj->IsReturn_codeSet()) {
- throw new WxPayException("返回状态码,缺少必填参数return_code!");
- }
- if (!$inputObj->IsResult_codeSet()) {
- throw new WxPayException("业务结果,缺少必填参数result_code!");
- }
- if (!$inputObj->IsUser_ipSet()) {
- throw new WxPayException("访问接口IP,缺少必填参数user_ip!");
- }
- if (!$inputObj->IsExecute_time_Set()) {
- throw new WxPayException("接口耗时,缺少必填参数execute_time_!");
- }
- $inputObj->SetAppid($config['app_id']);//公众账号ID
- $inputObj->SetMch_id($config['mch_id']);//商户号
- $inputObj->SetUser_ip($_SERVER['REMOTE_ADDR']);//终端ip
- $inputObj->SetTime(date("YmdHis"));//商户上报时间
- $inputObj->SetNonce_str(self::getNonceStr());//随机字符串
- $inputObj->SetSign();//签名
- $xml = $inputObj->ToXml();
- // $startTimeStamp = self::getMillisecond();//请求开始时间
- $response = self::postXmlCurl($xml, $url, false, $timeOut, $config);
- return $response;
- }
- /**
- *
- * 生成二维码规则,模式一生成支付二维码
- * appid、mchid、spbill_create_ip、nonce_str不需要填入
- *
- * @param WxPayBizPayUrl $inputObj
- *
- * @param array $config
- *
- * @return array
- * @throws WxPayException
- */
- public static function bizpayurl(WxPayBizPayUrl $inputObj, array $config = []) {
- if (!$inputObj->IsProduct_idSet()) {
- throw new WxPayException("生成二维码,缺少必填参数product_id!");
- }
- $inputObj->SetAppid($config['app_id']);//公众账号ID
- $inputObj->SetMch_id($config['mch_id']);//商户号
- $inputObj->SetTime_stamp(time());//时间戳
- $inputObj->SetNonce_str(self::getNonceStr());//随机字符串
- $inputObj->SetSign();//签名
- return $inputObj->GetValues();
- }
- /**
- *
- * 转换短链接
- * 该接口主要用于扫码原生支付模式一中的二维码链接转成短链接(weixin://wxpay/s/XXXXXX),
- * 减小二维码数据量,提升扫描速度和精确度。
- * appid、mchid、spbill_create_ip、nonce_str不需要填入
- *
- * @param WxPayShortUrl $inputObj
- * @param int $timeOut
- *
- * @param array $config
- *
- * @return string
- * @throws WxPayException
- */
- public static function shorturl($inputObj, $timeOut = 6, array $config = []) {
- $url = "https://api.mch.weixin.qq.com/tools/shorturl";
- //检测必填参数
- if (!$inputObj->IsLong_urlSet()) {
- throw new WxPayException("需要转换的URL,签名用原串,传输需URL encode!");
- }
- // $inputObj->SetAppid(WxPayConfig::APPID);//公众账号ID
- // $inputObj->SetMch_id(WxPayConfig::MCHID);//商户号
- $inputObj->SetNonce_str(self::getNonceStr());//随机字符串
- $inputObj->SetSign();//签名
- $xml = $inputObj->ToXml();
- $startTimeStamp = self::getMillisecond();//请求开始时间
- $response = self::postXmlCurl($xml, $url, false, $timeOut, $config);
- $result = WxPayResults::Init($response, $config);
- self::reportCostTime($url, $startTimeStamp, $result, $config);//上报请求花费时间
- return $result;
- }
- /**
- *
- * 支付结果通用通知
- *
- * @param function $callback
- * 直接回调函数使用方法: notify(you_function);
- * 回调类成员函数方法:notify(array($this, you_function));
- * $callback 原型为:function function_name($data){}
- * @param $msg
- *
- * @param array $config
- *
- * @return bool|mixed
- */
- public static function notify($callback, &$msg, array $config = []) {
- //获取通知的数据
- // $xml = $GLOBALS['HTTP_RAW_POST_DATA'];
- $xml = file_get_contents("php://input");
- //如果返回成功则验证签名
- try {
- $result = WxPayResults::Init($xml, $config);
- } catch (WxPayException $e) {
- $msg = $e->errorMessage();
- return false;
- }
- $result['huo_order_class'] = $config['huo_order_class'];
- $result['huo_func'] = $config['huo_func'];
- return call_user_func($callback, $result);
- }
- /**
- *
- * 产生随机字符串,不长于32位
- *
- * @param int $length
- *
- * @return string 产生的随机字符串
- */
- public static function getNonceStr($length = 32) {
- $chars = "abcdefghijklmnopqrstuvwxyz0123456789";
- $str = "";
- for ($i = 0; $i < $length; $i++) {
- $str .= substr($chars, mt_rand(0, strlen($chars) - 1), 1);
- }
- return $str;
- }
- /**
- * 直接输出xml
- *
- * @param string $xml
- */
- public static function replyNotify($xml) {
- echo $xml;
- }
- /**
- *
- * 上报数据, 上报的时候将屏蔽所有异常流程
- *
- * @param string $url
- * @param int $startTimeStamp
- * @param array $data
- * @param array $config
- */
- private static function reportCostTime($url, $startTimeStamp, $data, array $config) {
- //如果不需要上报数据
- if (0 == $config['report_levenl']) {
- return;
- }
- //如果仅失败上报
- if (1 == $config['report_levenl']
- && array_key_exists("return_code", $data)
- && $data["return_code"] == "SUCCESS"
- && array_key_exists("result_code", $data)
- && $data["result_code"] == "SUCCESS"
- ) {
- return;
- }
- //上报逻辑
- $endTimeStamp = self::getMillisecond();
- $objInput = new WxPayReport();
- $objInput->SetInterface_url($url);
- $objInput->SetExecute_time_($endTimeStamp - $startTimeStamp);
- //返回状态码
- if (array_key_exists("return_code", $data)) {
- $objInput->SetReturn_code($data["return_code"]);
- }
- //返回信息
- if (array_key_exists("return_msg", $data)) {
- $objInput->SetReturn_msg($data["return_msg"]);
- }
- //业务结果
- if (array_key_exists("result_code", $data)) {
- $objInput->SetResult_code($data["result_code"]);
- }
- //错误代码
- if (array_key_exists("err_code", $data)) {
- $objInput->SetErr_code($data["err_code"]);
- }
- //错误代码描述
- if (array_key_exists("err_code_des", $data)) {
- $objInput->SetErr_code_des($data["err_code_des"]);
- }
- //商户订单号
- if (array_key_exists("out_trade_no", $data)) {
- $objInput->SetOut_trade_no($data["out_trade_no"]);
- }
- //设备号
- if (array_key_exists("device_info", $data)) {
- $objInput->SetDevice_info($data["device_info"]);
- }
- try {
- self::report($objInput, 1, $config);
- } catch (WxPayException $e) {
- //不做任何处理
- }
- }
- /**
- * 以post方式提交xml到对应的接口url
- *
- * @param string $xml 需要post的xml数据
- * @param string $url url
- * @param bool $useCert 是否需要证书,默认不需要
- * @param int $second url执行超时时间,默认30s
- *
- * @param array $config
- *
- * @return mixed
- * @throws WxPayException
- */
- private static function postXmlCurl($xml, $url, $useCert = false, $second = 30, array $config) {
- $ch = curl_init();
- //设置超时
- curl_setopt($ch, CURLOPT_TIMEOUT, $second);
- //如果有配置代理这里就设置代理
- if ($config['curl_proxy_host'] != "0.0.0.0"
- && $config['curl_proxy_port'] != 0
- ) {
- curl_setopt($ch, CURLOPT_PROXY, $config['curl_proxy_host']);
- curl_setopt($ch, CURLOPT_PROXYPORT, $config['curl_proxy_port']);
- }
- curl_setopt($ch, CURLOPT_URL, $url);
- curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
- curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);//严格校验
- //设置header
- curl_setopt($ch, CURLOPT_HEADER, false);
- //要求结果为字符串且输出到屏幕上
- curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
- if ($useCert == true) {
- //设置证书
- //使用证书:cert 与 key 分别属于两个.pem文件
- curl_setopt($ch, CURLOPT_SSLCERTTYPE, 'PEM');
- curl_setopt($ch, CURLOPT_SSLCERT, $config['sslcert_path']);
- curl_setopt($ch, CURLOPT_SSLKEYTYPE, 'PEM');
- curl_setopt($ch, CURLOPT_SSLKEY, $config['sslkey_path']);
- }
- //post提交方式
- curl_setopt($ch, CURLOPT_POST, true);
- curl_setopt($ch, CURLOPT_POSTFIELDS, $xml);
- //运行curl
- $data = curl_exec($ch);
- //返回结果
- if ($data) {
- curl_close($ch);
- return $data;
- } else {
- $error = curl_errno($ch);
- curl_close($ch);
- throw new WxPayException("curl出错,错误码:$error");
- }
- }
- /**
- * 获取毫秒级别的时间戳
- */
- private static function getMillisecond() {
- //获取毫秒的时间戳
- $time = explode(" ", microtime());
- $time = $time[1].($time[0] * 1000);
- $time2 = explode(".", $time);
- $time = $time2[0];
- return $time;
- }
- }
|