支付宝网页即时到账功能,可让用户在线向开发者的支付宝账号支付资金,交易资金即时到账,帮助开发者快速回笼资金。
当用户进行支付操作时候可以直接跳转到支付宝支付页面进行支付
准备
关于支付宝签约即时到账和PID获取、密钥生成这里不做叙述,官方文档步骤也很清楚:传送门
支付宝即时到账DEMO下载:下载
DEMO目录结构
简单使用需要的文件说明
./alipay.config.php --- 配置文件
./alipayapi.php ------- 接口文件
./notify_url.php ------ 服务器异步通知文件
./return_url.php ----- 服务器同步跳转文件
./log.txt -------------- 日志
配置alipay.config.php
在配置文件中有详细的说明,主要配置有
$alipay_config['partner'] = '208862160xxxxxxx'; // 合作者身份ID $alipay_config['private_key'] = "xxxxxxxxxxxxx”; // 商户的私钥,此处填写原始私钥去头去尾 $alipay_config['notify_url'] = "http://xxxx/alipay/notify_url.php"; // 服务器异步通知页面路径 需http://格式的完整路径,不能加?id=123这类自定义参数,必须外网可以正常访问 $alipay_config['return_url'] = "http://xxxx/alipay/return_url.php"; // 页面跳转同步通知页面路径 需http://格式的完整路径,不能加?id=123这类自定义参数,必须外网可以正常访问
其他配置按实际情况配置
前端支付请求
请求一般都是form表单post请求alipayapi.php,涉及到金钱操作的我们都要小心严谨,这种请求代码需要封装到后端,不能前端展示出来
例如,我们可以后端封装个方法来进行处理,请求这个方法将代码echo到页面直接进行二次跳转
/** * 支付宝支付 * @param string $id ID */ public function getAlipayParam($id) { $form = <<<FORM <form style='display: none;' action='提交URL' name='payForm' method='post'> <input name='WIDout_trade_no' value='订单编号'> <input name='WIDsubject' value='订单名称'> <input name='WIDtotal_fee' value='金额'> <input name='WIDbody' value='商品描述'> <input name='extra_common_param' value='公共回参'> </form> <script> function submitForm() { document.payForm.submit(); } submitForm(); </script> FORM; echo $form; }
在DEMO中(alipay.php)接受的请求参数并不多,实际上请求参数是很全面的:请求参数列表
我们可以根据实际需求进行扩展,实际开发中为了安全,请求的name可以适当的进行改变
/**************************请求参数**************************/ //商户订单号,商户网站订单系统中唯一订单号,必填 $out_trade_no = $_POST['WIDout_trade_no']; //订单名称,必填 $subject = $_POST['WIDsubject']; //付款金额,必填 $total_fee = $_POST['WIDtotal_fee']; //商品描述,可空 $body = $_POST['WIDbody']; //公共回传参数 $extra_common_param = $_POST['extra_common_param'];
支付
跳转到支付页面进行支付
支付结果异步处理
关于异步通知的参数:服务器异步通知参数列表
前面提到异步通知请求到notify_url.php(根据个人配置)
异步通知主要负责处理支付结果的业务逻辑,这个需要自己根据项目需求更改编写
例如
<?php /* * * 功能:支付宝服务器异步通知页面 * 版本:3.5 * 日期:2016-06-25 * 说明: * 以下代码只是为了方便商户测试而提供的样例代码,商户可以根据自己网站的需要,按照技术文档编写,并非一定要使用该代码。 * 该代码仅供学习和研究支付宝接口使用,只是提供一个参考。 *************************页面功能说明************************* * 创建该页面文件时,请留心该页面文件中无任何HTML代码及空格。 * 该页面不能在本机电脑测试,请到服务器上做测试。请确保外部可以访问该页面。 * 该页面调试工具请使用写文本函数logResult,该函数已被默认关闭,见alipay_notify_class.php中的函数verifyNotify * 如果没有收到该页面返回的 success 信息,支付宝会在24小时内按一定的时间策略重发通知 */ require_once("alipay.config.php"); require_once("admin.config.php"); require_once("lib/alipay_notify.class.php"); require_once("log.php"); //计算得出通知验证结果 $alipayNotify = new AlipayNotify($alipay_config); $verify_result = $alipayNotify->verifyNotify(); //初始化日志 $logHandler = new CLogFileHandler('logs/'.date('y-m-d').'.log'); $log = Log::Init($logHandler, 15); if($verify_result) {//验证成功 Log::DEBUG(json_encode($_POST)); // 操作类型 $extra_common_param = $_POST['extra_common_param']; // 订单编号 $code = $_POST['out_trade_no']; // 支付宝交易号 $trade_no = $_POST['trade_no']; // 交易状态 $trade_status = $_POST['trade_status']; /** * 判断交易状态 * ------------------------------------------------------------------------ * 判断该笔订单是否在商户网站中已经做过处理 * 如果没有做过处理,根据订单号(out_trade_no)在商户网站的订单系统中查到该笔订单的详细,并执行商户的业务程序 * 请务必判断请求时的total_fee、seller_id与通知时获取的total_fee、seller_id为一致的 * 如果有做过处理,不执行商户的业务程序 * ------------------------------------------------------------------------ * 调试用,写文本函数记录程序运行情况是否正常 * logResult("这里写入想要调试的代码变量值,或其他运行的结果记录"); */ if ($trade_status == 'TRADE_FINISHED') { //注意:退款日期超过可退款期限后(如三个月可退款),支付宝系统发送该交易状态通知 } elseif ($trade_status == 'TRADE_SUCCESS') { //注意:付款完成后,支付宝系统发送该交易状态通知 switch ($extra_common_param) { case AdminConfig::OPER_PLACE_ORDER: // 判断该订单是否处理过 $url = AdminConfig::BACKOFFICE_URL . 'xxx/xxx/xxx/' . $code . '/outtradeNo/' . $trade_no; $is_order = request($url); if ($is_order == 'success') { // 订单未处理 // 修改订单的相关状态为已支付 $url = AdminConfig::BACKOFFICE_URL . 'xxx/xxx/xxx/' . $code . '/outtradeNo/' . $trade_no; request($url); } break; case AdminConfig::OPER_RECHARGE: //修改充值订单支付状态为已支付 $id = $_POST['out_trade_no']; $outtrade_no = $_POST['trade_no']; $money = $_POST['total_fee']; $url = AdminConfig::ORDER_URL . 'xxx/xxx/id/'.$id.'/money/'.$money.'/outtradeno/'.$outtrade_no; request($url); break; } } echo "success"; //请不要修改或删除 } else { //验证失败 echo "fail"; } /** * 发送请求 * @param string $url 请求地址 * @param array $data 请求数据 * @param string $type 请求类型 * @param boolean $ssl 是否是HTTPS请求 * @return string 响应主体Content */ function request($url, $data=array(), $type='get', $ssl=false) { // curl请求 $curl = curl_init(); // 设置curl选项 curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_AUTOREFERER, true); // referer 请求来源 curl_setopt($curl, CURLOPT_TIMEOUT, 10); // 设置超时时间 // SSL相关 if ($ssl) { curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); // 是否在服务端进行验证 curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, '2'); // 检查服务器SSL证书中是否存在一个公用名 } // POST请求 if ($type == 'post') { curl_setopt($curl, CURLOPT_POST, true); // 是否为post请求 curl_setopt($curl, CURLOPT_POSTFIELDS, $data); // 处理请求数据 } // 处理响应结果 curl_setopt($curl, CURLOPT_HEADER, false); // 是否处理响应头 curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); // 是否返回响应结果 // 发送请求 $response = curl_exec($curl); if (false === $response) { return false; } return $response; } ?>
支付结果同步处理
关于同步通知的参数:服务器同步通知参数列表
前面提到同步通知请求到return_url.php(根据个人配置)
同步通知主要负责处理支付结果的结果展示,这个需要自己根据项目需求更改编写
例如
/** * 判断该笔订单是否在商户网站中已经做过处理 * 如果没有做过处理,根据订单号(out_trade_no)在商户网站的订单系统中查到该笔订单的详细,并执行商户的业务程序 * 如果有做过处理,不执行商户的业务程序 */ if($_GET['trade_status'] == 'TRADE_FINISHED' || $_GET['trade_status'] == 'TRADE_SUCCESS') { // 交易成功或交易成功且订单结束 switch ($extra_common_param) { case AdminConfig::OPER_PLACE_ORDER: // 订单支付 $url = AdminConfig::ORDER_URL . 'xxx/orderPaySuccessShow'; header("Location:$url"); break; case AdminConfig::OPER_RECHARGE: $url = AdminConfig::ORDER_URL . 'xxx/rechargeSuccessShow'; header("Location:$url"); break; default: echo 'Undefined operation type!!'; break; } } else { // 交易状态未成功 switch ($extra_common_param) { case AdminConfig::OPER_PLACE_ORDER: // 订单支付 $url = AdminConfig::ORDER_URL . 'xxx/orderPayFailShow'; header("Location:$url"); break; case AdminConfig::OPER_RECHARGE: $url = AdminConfig::ORDER_URL . 'xxx/rechargeFailShow'; break; default: echo 'Undefined operation type!!'; break; } }
关于交易状态
其他一些细节性问题请大家参阅官方文档,文档永远是最好的教程!