支付宝即时到账DEMO配置与使用

时间:2022-01-06 06:47:02

支付宝网页即时到账功能,可让用户在线向开发者的支付宝账号支付资金,交易资金即时到账,帮助开发者快速回笼资金。

当用户进行支付操作时候可以直接跳转到支付宝支付页面进行支付

支付宝即时到账DEMO配置与使用

支付宝即时到账DEMO配置与使用

1. 准备

关于支付宝签约即时到账和PID获取、密钥生成这里不做叙述,官方文档步骤也很清楚:传送门

支付宝即时到账DEMO下载:下载

2. DEMO目录结构

支付宝即时到账DEMO配置与使用

简单使用需要的文件说明

./alipay.config.php --- 配置文件

./alipayapi.php ------- 接口文件

./notify_url.php ------ 服务器异步通知文件

./return_url.php ----- 服务器同步跳转文件

./log.txt -------------- 日志

3. 配置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这类自定义参数,必须外网可以正常访问

其他配置按实际情况配置

4. 前端支付请求

请求一般都是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'];

5. 支付

跳转到支付页面进行支付

6. 支付结果异步处理

关于异步通知的参数:服务器异步通知参数列表

前面提到异步通知请求到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;
}

?>

支付宝即时到账DEMO配置与使用

7. 支付结果同步处理

关于同步通知的参数:服务器同步通知参数列表

前面提到同步通知请求到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;
        }
    }

8. 关于交易状态

支付宝即时到账DEMO配置与使用

其他一些细节性问题请大家参阅官方文档,文档永远是最好的教程!