PayPal php回调接口配置 phpPayPal支付回调步骤解析

星夢妙者

发布时间：2025-06-27 19:32:01

284人浏览过

来源于php中文网

原创

配置paypal php回调接口需先设置webhooks并编写验证脚本。1. 登录paypal开发者账号，在“my apps & credentials”中选择或创建应用，添加webhook url（如https://yourdomain.com/paypal_callback.php），并选择事件类型，尤其是payment.sale.completed。2. 编写paypal_callback.php脚本接收post数据，使用curl向paypal发送验证请求，若返回verified则检查payment_status是否为completed，并通过txn_id去重、验证receiver_email和付款金额等信息，确保无误后更新数据库并记录日志；若返回invalid则记录无效通知。3. 安全方面应始终验证ipn有效性，使用https传输，避免即时发货，同时记录所有通知便于审计。测试时应使用沙盒环境模拟多种场景，排查失败原因包括检查webhook url、服务器是否接收post请求、ssl证书、代码错误及数据库连接问题。处理重复通知需用txn_id去重并设计幂等性逻辑。ipn与webhooks不同，前者需手动验证且基于post，后者更现代支持json和重试机制。

PayPal php回调接口配置 phpPayPal支付回调步骤解析

配置PayPal PHP回调接口，核心在于确保你的服务器能正确接收和处理PayPal发送的付款状态更新信息。简单来说，就是告诉PayPal，付款成功或者失败后，往哪里发送通知。

解决方案

设置PayPal IPN (Instant Payment Notification)：

立即学习“PHP免费学习笔记（深入）”；
- 登录你的PayPal开发者账号（https://www.php.cn/link/9fdbe9d3193358ceccdd9b6460185174）。
- 导航到“My Apps & Credentials”。
- 选择你的应用（或者创建一个新的）。
- 在“Webhooks”部分，添加一个Webhook URL。这个URL就是你的PHP回调接口地址，例如：https://yourdomain.com/paypal_callback.php。
- 选择你希望接收的事件类型，例如：Payment sale completed、Payment sale denied等。关键在于PAYMENT.SALE.COMPLETED，这是支付完成事件。

编写PHP回调接口脚本 (paypal_callback.php)：

这个脚本负责接收PayPal发送的POST数据，验证数据的有效性，并根据付款状态执行相应的操作（例如更新数据库）。

<?php
// 开启错误报告，方便调试
ini_set('display_errors', 1);
error_reporting(E_ALL);

// 从PayPal接收POST数据
$raw_post_data = file_get_contents('php://input');
$raw_post_array = explode('&', $raw_post_data);
$myPost = array();
foreach ($raw_post_array as $keyval) {
    $keyval = explode ('=', $keyval);
    if (count($keyval) == 2)
        $myPost[$keyval[0]] = urldecode($keyval[1]);
}
// 读取POST数据的IPN变量
$req = 'cmd=_notify-validate';
foreach ($myPost as $key => $value) {
    $value = urlencode($value);
    $req .= "&$key=$value";
}

// 设置PayPal沙盒/正式环境URL
$paypal_url = 'https://ipnpb.sandbox.paypal.com/cgi-bin/webscr'; // 沙盒环境
//$paypal_url = 'https://ipnpb.paypal.com/cgi-bin/webscr'; // 正式环境

// 使用curl验证IPN消息
$ch = curl_init($paypal_url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER,1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $req);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
curl_setopt($ch, CURLOPT_FORBID_REUSE, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Connection: Close'));

// 在某些环境中，你可能需要指定CA证书路径
// curl_setopt($ch, CURLOPT_CAINFO, getcwd() . '/cacert.pem');

$res = curl_exec($ch);
curl_close($ch);

// 处理验证结果
if (strcmp ($res, "VERIFIED") == 0) {
    // IPN消息有效

    // 检查付款状态是否为“Completed”
    $payment_status = $_POST['payment_status'];
    if ($payment_status == 'Completed') {
        // 检查txn_id是否已经处理过，防止重复处理
        $txn_id = $_POST['txn_id'];
        // ... (你的数据库查询代码，检查txn_id是否存在)

        // 检查receiver_email是否是你的PayPal账号
        $receiver_email = $_POST['receiver_email'];
        // ... (验证receiver_email是否正确)

        // 检查付款金额和货币是否正确
        $payment_amount = $_POST['mc_gross'];
        $payment_currency = $_POST['mc_currency'];
        // ... (验证金额和货币是否正确)

        // 如果所有验证都通过，更新数据库，记录付款信息
        // ... (你的数据库更新代码)

        // 记录日志，方便调试
        error_log(date('[Y-m-d H:i e] '). "Verified IPN: $req ". PHP_EOL, 3, 'paypal.log');

    }

} else if (strcmp ($res, "INVALID") == 0) {
    // IPN消息无效
    error_log(date('[Y-m-d H:i e] '). "Invalid IPN: $req ". PHP_EOL, 3, 'paypal.log');
}

?>

安全性考虑：

Imagine By Magic Studio
AI图片生成器，用文字制作图片

下载
- 始终验证IPN消息的有效性，防止伪造的通知。
- 不要依赖IPN消息来立即发货，最好等待银行确认后再执行发货操作。
- 记录所有IPN消息，方便日后审计。
- 使用HTTPS协议，确保数据传输的安全性。
测试：
- 使用PayPal沙盒环境进行测试，模拟各种付款场景，确保你的回调接口能够正确处理。
- 检查日志文件，确认所有IPN消息都被正确处理。

PayPal回调接口配置失败的常见原因及排查方法

Webhook URL配置错误：检查PayPal开发者平台上的Webhook URL是否正确，确保与你的PHP脚本地址一致。尤其注意大小写和协议（http/https）。
服务器无法接收POST请求：检查你的服务器是否允许接收来自PayPal的POST请求，防火墙或安全组可能会阻止这些请求。
SSL证书问题：如果你的网站使用HTTPS，确保SSL证书有效且配置正确。 PayPal可能无法访问没有有效SSL证书的HTTPS网站。
代码错误：检查PHP脚本是否存在语法错误或逻辑错误，导致无法正确处理IPN消息。开启PHP错误报告可以帮助你找到这些错误。
IPN消息验证失败：检查你的代码是否正确验证了IPN消息的有效性。确保你使用了正确的PayPal URL（沙盒/正式环境），并且正确设置了curl选项。
数据库连接问题：如果你的代码需要连接数据库，检查数据库连接是否正常。