PayPalPHP回调配置及支付验证教程

golang学习网今天将给大家带来《PayPal 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回调接口，核心在于确保你的服务器能正确接收和处理PayPal发送的付款状态更新信息。简单来说，就是告诉PayPal，付款成功或者失败后，往哪里发送通知。

解决方案

1. 设置PayPal IPN (Instant Payment Notification)：

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

2. 编写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');
   }
   
   ?>

3. 安全性考虑：

   • 始终验证IPN消息的有效性，防止伪造的通知。
   • 不要依赖IPN消息来立即发货，最好等待银行确认后再执行发货操作。
   • 记录所有IPN消息，方便日后审计。
   • 使用HTTPS协议，确保数据传输的安全性。

4. 测试：

   • 使用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选项。
• 数据库连接问题：如果你的代码需要连接数据库，检查数据库连接是否正常。

如何处理PayPal回调中的重复通知问题

PayPal可能会多次发送相同的IPN消息，为了防止重复处理，你需要：

• 使用事务ID (txn_id) 进行去重：在你的数据库中创建一个字段来存储txn_id，并在处理IPN消息之前，检查该txn_id是否已经存在。如果存在，则忽略该消息。
• 幂等性设计：确保你的处理逻辑是幂等的，即多次执行相同的操作，结果应该是一致的。

PayPal回调接口与Webhooks的区别

虽然都是用于接收PayPal的通知，但IPN和Webhooks在实现方式和功能上有所不同：

• IPN (Instant Payment Notification)：基于HTTP POST请求，需要你手动验证消息的有效性。 相对较老的技术，但仍然被广泛使用。
• Webhooks：一种更现代的API，提供更丰富的事件类型和更可靠的交付机制。 使用JSON格式的数据，并且支持重试机制。

一般来说，如果你的应用需要更精细的控制和更可靠的通知，建议使用Webhooks。 如果你只需要基本的付款状态更新，IPN仍然是一个可行的选择。

好了，本文到此结束，带大家了解了《PayPalPHP回调配置及支付验证教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！