用 ThinkPHP3.2 对接支付宝即时到账接口，我踩了 3 个坑，这份避坑指南请收好

Extend/
└── Payment/          # 支付相关扩展
    └── Alipay/       # 支付宝接口目录
        ├── Alipay.php       # 自定义的支付入口类（封装官方SDK）
        ├── cacert.pem       # SSL证书文件
        └── lib/             # 官方核心类库
            ├── alipay_core.function.php
            ├── alipay_notify.class.php
            ├── alipay_submit.class.php
            └── alipay_md5.function.php

<?php
return array(
    'partner' => '2088xxxxxxxxx', // 你的商户ID，从支付宝商户平台获取
    'seller_email' => 'xxx@xxx.com', // 收款支付宝账号
    'key' => 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', // 商户密钥，注意和公钥区分
    'input_charset' => 'utf-8', // 编码格式，建议utf-8
    'sign_type' => 'MD5', // 签名方式，官方推荐MD5或RSA
    'transport' => 'http', // 通信方式，http或https（推荐https）
);

<?php
namespace Extend\Payment\Alipay; // 命名空间要和目录结构对应

// 引入官方核心类（如果没自动加载的话）
require_once 'lib/alipay_core.function.php';
require_once 'lib/alipay_md5.function.php';
require_once 'lib/alipay_submit.class.php';

class Alipay {
    /**
     * 生成支付表单，跳转到支付宝
     * @param array $alipay_config 支付宝配置（从C('alipay')获取）
     * @param array $args 订单参数（订单号、金额等）
     */
    public static function pay($alipay_config, $args) {
        /************************** 固定参数 **************************/
        $payment_type = "1"; // 支付类型，固定为1（即时到账），不能改
        $notify_url = $args['notify_url']; // 异步回调地址（支付宝后台调用）
        $return_url = $args['return_url']; // 同步回调地址（用户付款后跳回）
        /************************** 订单参数 **************************/
        $out_trade_no = $args['out_trade_no']; // 商户唯一订单号（自己生成，比如时间戳+随机数）
        $subject = $args['name']; // 订单名称（比如“会员充值-100元”）
        $total_fee = $args['total']; // 订单金额（保留2位小数，比如100.00）
        $body = $args['content']; // 订单描述（可选，比如“2024年9月会员充值”）
        $show_url = $args['show_url']; // 商品展示地址（可选，比如网站首页）
        /************************** 构造请求参数 **************************/
        $parameter = array(
            "service" => "create_direct_pay_by_user", // 即时到账接口服务名，固定
            "partner" => trim($alipay_config['partner']),
            "seller_email" => trim($alipay_config['seller_email']),
            "payment_type" => $payment_type,
            "notify_url" => $notify_url,
            "return_url" => $return_url,
            "out_trade_no" => $out_trade_no,
            "subject" => $subject,
            "total_fee" => $total_fee,
            "body" => $body,
            "show_url" => $show_url,
            "anti_phishing_key" => "", // 防钓鱼时间戳，可选
            "exter_invoke_ip" => "", // 客户端IP，可选
            "_input_charset" => trim(strtolower($alipay_config['input_charset']))
        );
        /************************** 提交到支付宝 **************************/
        $alipaySubmit = new \AlipaySubmit($alipay_config); // 实例化提交类
        $html_text = $alipaySubmit->buildRequestForm($parameter, "get", "点击跳转到支付宝支付");
        echo $html_text; // 输出表单，自动跳转到支付宝
    }
}

<?php
namespace Home\Controller;
use Think\Controller;
use Extend\Payment\Alipay\Alipay; // 导入支付宝类的命名空间

class IndexController extends Controller {
    /**
     * 用户下单，提交到支付宝
     */
    public function doBuy() {
        // 1. 先获取用户提交的订单信息（比如商品ID、金额）
        $goodsId = I('post.goods_id');
        $goods = M('Goods')->find($goodsId); // 从商品表获取商品信息
        if (!$goods) {
            $this->error('商品不存在！');
        }
        // 2. 生成唯一订单号（避免重复，比如时间戳+随机数）
        $out_trade_no = date('YmdHis') . mt_rand(1000, 9999);
        // 3. 把订单信息存入数据库（状态设为0：待支付）
        $orderData = array(
            'number' => $out_trade_no, // 订单号
            'goods_id' => $goodsId,
            'name' => $goods['name'], // 商品名称
            'price' => $goods['price'], // 商品金额
            'status' => 0, // 0=待支付，1=已支付，2=已取消
            'create_time' => time()
        );
        $orderId = M('Order')->add($orderData);
        if (!$orderId) {
            $this->error('创建订单失败！');
        }
        // 4. 构造支付参数，提交到支付宝
        $baseUrl = 'http://' . $_SERVER['HTTP_HOST']; // 网站根域名
        $args = array(
            'out_trade_no' => $out_trade_no, // 订单号
            'notify_url' => $baseUrl . '/index.php/Home/Index/notifyUrl', // 异步回调地址
            'return_url' => $baseUrl . '/index.php/Home/Index/returnUrl', // 同步回调地址
            'name' => $goods['name'], // 订单名称
            'total' => $goods['price'], // 订单金额
            'content' => '购买商品：' . $goods['name'], // 订单描述
            'show_url' => $baseUrl . '/index.php/Home/Goods/detail/id/' . $goodsId // 商品详情页
        );
        // 调用支付宝支付方法（传入配置和订单参数）
        Alipay::pay(C('alipay'), $args);
    }
}

public function returnUrl() {
    $alipayConfig = C('alipay');
    // 1. 引入支付宝通知类，验证回调的真实性（防止伪造请求）
    require_once EXTEND_PATH . 'Payment/Alipay/lib/alipay_notify.class.php';
    $alipayNotify = new \AlipayNotify($alipayConfig);
    $verifyResult = $alipayNotify->verifyReturn(); // 验证同步通知
    
    if ($verifyResult) {
        // 验证成功：获取支付宝返回的参数
        $outTradeNo = $_GET['out_trade_no']; // 商户订单号
        $tradeNo = $_GET['trade_no']; // 支付宝交易号
        $tradeStatus = $_GET['trade_status']; // 交易状态
        
        // 只有“交易成功”或“交易完成”才更新订单状态
        if ($tradeStatus == 'TRADE_SUCCESS' || $tradeStatus == 'TRADE_FINISHED') {
            $orderModel = M('Order');
            $order = $orderModel->where(array('number' => $outTradeNo))->find();
            if ($order && $order['status'] == 0) { // 确保订单存在且未被处理过
                $orderModel->where(array('id' => $order['id']))->save(array(
                    'status' => 1, // 改为已支付
                    'trade_no' => $tradeNo, // 记录支付宝交易号
                    'pay_time' => time()
                ));
            }
            // 跳转到支付成功页面，显示订单信息
            $this->assign('order', $order);
            $this->display('paySuccess');
        } else {
            $this->error('支付状态异常：' . $tradeStatus);
        }
    } else {
        // 验证失败：可能是伪造的回调
        $this->error('支付验证失败，请联系客服！');
    }
}

public function notifyUrl() {
    $alipayConfig = C('alipay');
    // 1. 引入通知类，验证回调真实性
    require_once EXTEND_PATH . 'Payment/Alipay/lib/alipay_notify.class.php';
    $alipayNotify = new \AlipayNotify($alipayConfig);
    $verifyResult = $alipayNotify->verifyNotify(); // 验证异步通知
    
    if ($verifyResult) {
        // 验证成功：处理订单
        $outTradeNo = $_POST['out_trade_no']; // 商户订单号
        $tradeNo = $_POST['trade_no']; // 支付宝交易号
        $tradeStatus = $_POST['trade_status']; // 交易状态
        
        if ($tradeStatus == 'TRADE_SUCCESS' || $tradeStatus == 'TRADE_FINISHED') {
            $orderModel = M('Order');
            $order = $orderModel->where(array('number' => $outTradeNo))->find();
            if ($order && $order['status'] == 0) { // 避免重复处理
                $updateRes = $orderModel->where(array('id' => $order['id']))->save(array(
                    'status' => 1,
                    'trade_no' => $tradeNo,
                    'pay_time' => time()
                ));
                // 这里还可以加其他逻辑，比如给用户充值会员、发送短信通知等
                echo "success"; // 必须输出“success”，支付宝才会停止重试回调
            } else {
                echo "success"; // 即使订单已处理，也输出success（避免重复回调）
            }
        } else {
            echo "fail"; // 状态异常，告诉支付宝重试
        }
    } else {
        // 验证失败，输出fail
        echo "fail";
        // 可以加日志记录，方便调试（比如把$_POST写入log文件）
        // file_put_contents('./alipay_notify_log.txt', date('Y-m-d H:i:s') . json_encode($_POST) . "\n", FILE_APPEND);
    }
}