README

此包是从以下代码分离出来的分支：

https://github.com/sh0umik/Laravel5-PaypalIPN

将此添加到你的 composer.json 文件中的 "require" 部分

"8ctopus/laravel-paypal-ipn": "1.0.*"

在您的 PHP IPN 脚本中使用 PaypalIPNListener 类来处理 POST 数据的编码、回发到 PayPal 以及解析 PayPal 的响应。

Laravel 服务

'Oct8pus\PaypalIPN\PaypalIPNServiceProvider',

用例

use Oct8pus\PaypalIPN\PaypalIPNListener;

public function paypalIpn()
{
    $ipn = new PaypalIPNListener();
    $ipn->use_sandbox = true;

    $verified = $ipn->processIpn();

    $report = $ipn->getTextReport();

    Log::info("-----new payment-----");

    Log::info($report);

    if ($verified) {
        if ($_POST['address_status'] == 'confirmed') {
            // Check outh POST variable and insert your logic here
            Log::info("payment verified and inserted to db");
        }
    } else {
        Log::info("Some thing went wrong in the payment !");
    }
}

特性

通过设置 use_sandbox 属性在沙盒和实时环境之间切换。
通过设置 use_ssl 属性支持安全的 SSL 和普通 HTTP 事务（推荐使用 SSL）。
通过设置 use_curl 属性支持 cURL 和 fsockopen 网络库（推荐使用 cURL）。
验证 PayPal 服务器的 HTTP "200" 响应状态码。
使用 getTextReport() 方法获取整个 IPN 的详细纯文本报告，用于电子邮件和日志记录。
抛出各种异常以区分代码或服务器配置中的常见错误与无效的 IPN 响应。

入门指南

此代码面向网络开发者。你应该了解 IPN 处理过程的原理，并了解何时以及为何使用 IPN。阅读PayPal 即时支付通知指南是一个很好的起点。

你还应该有一个PayPal 沙盒账户，包含一个测试买家账户和一个测试卖家账户。登录沙盒账户后，在“测试工具”菜单下有一个 IPN 模拟器，你可以用它来测试你的 IPN 监听器。

一旦你设置了沙盒账户，你只需创建一个 PHP 脚本，该脚本将成为你的 IPN 监听器。在该脚本中，使用以下示例所示的 IpnListener() 类。有关更详细的示例，请查看源代码中的 example/ipn.php 脚本。

文档

尚未生成文档，但，在 ipnlistener.php 中有 phpDocumentor 风格的 docstrings（注释），解释了重要的公共属性和方法。

我还在我的博客上写了一个更深入的 IPN 教程：使用 PHP 的 PayPal IPN

已知问题

问题

processIpn() 方法抛出以下异常

cURL error: [52] GnuTLS recv error (-9): A TLS packet with unexpected length was received.

解决方案

当 cURL 使用 GnuTLS 编译时，如果未明确设置 SSL 版本作为 cURL 选项，调用 PayPal 将失败。将 force_ssl_v3 属性设置为强制使用 SSL 3

$listener = new IpnListener();
$listener->force_ssl_v3 = true;

注意：现在默认为 force_ssl_v3 为 true

问题

 PHP Warning: curl_setopt() [function.curl-setopt]: CURLOPT_FOLLOWLOCATION 
 cannot be activated when in safe_mode or an open_basedir is set in ...

解决方案

如果你需要 PHP 安全模式，可以使用 follow_location 属性禁用 CURLOPT_FOLLOWLOCATION。

$listener = new IpnListener();
$listener->follow_location = false;

注意：现在默认为 follow_location 为 false

示例报告

以下是 getTextReport() 方法返回的报告示例。通过扩展 IpnListener() 类或在您的 ipn 脚本中直接访问数据来创建自己的报告。

--------------------------------------------------------------------------------
[09/09/2011 8:35 AM] - https://www.sandbox.paypal.com/cgi-bin/webscr (curl)
--------------------------------------------------------------------------------
HTTP/1.1 200 OK
Date: Fri, 09 Sep 2011 13:35:39 GMT
Server: Apache
X-Frame-Options: SAMEORIGIN
Set-Cookie: c9MWDuvPtT9GIMyPc3jwol1VSlO=Ch-NORlHUjlmbEm__KG9LupR4mfMfQTkx1QQ6hHDyc0RImWr88NY_ILeICENiwtVX3iw4jEnT1-1gccYjQafWrQCkDmiykNT8TeDUg7R7L0D9bQm47PTG8MafmrpyrUAxQfst0%7c_jG1ZL6CffJgwrC-stQeqni04tKaYSIZqyqhFU7tKnV520wiYOw0hwk5Ehrh3hLDvBxkpm%7cYTFdl0w0YpEqxu0D1jDTVTlEGXlmLs4wob2Glu9htpZkFV9O2aCyfQ4CvA2kLJmlI6YiXm%7c1315575340; domain=.paypal.com; path=/; Secure; HttpOnly
Set-Cookie: cookie_check=yes; expires=Mon, 06-Sep-2021 13:35:40 GMT; domain=.paypal.com; path=/; Secure; HttpOnly
Set-Cookie: navcmd=_notify-validate; domain=.paypal.com; path=/; Secure; HttpOnly
Set-Cookie: navlns=0.0; expires=Thu, 04-Sep-2031 13:35:40 GMT; domain=.paypal.com; path=/; Secure; HttpOnly
Set-Cookie: Apache=10.72.109.11.1315575339707456; path=/; expires=Sun, 01-Sep-41 13:35:39 GMT
X-Cnection: close
Transfer-Encoding: chunked
Content-Type: text/html; charset=UTF-8

VERIFIED
--------------------------------------------------------------------------------
test_ipn                 1
payment_type             instant
payment_date             06:34:51 Sep 09, 2011 PDT
payment_status           Completed
address_status           confirmed
payer_status             verified
first_name               John
last_name                Smith
payer_email              buyer@paypalsandbox.com
payer_id                 TESTBUYERID01
address_name             John Smith
address_country          United States
address_country_code     US
address_zip              95131
address_state            CA
address_city             San Jose
address_street           123, any street
business                 seller@paypalsandbox.com
receiver_email           seller@paypalsandbox.com
receiver_id              TESTSELLERID1
residence_country        US
item_name                something
item_number              AK-1234
quantity                 1
shipping                 3.04
tax                      2.02
mc_currency              USD
mc_fee                   0.44
mc_gross                 12.34
mc_gross_1               9.34
txn_type                 web_accept
txn_id                   51991334
notify_version           2.1
custom                   xyz123
charset                  windows-1252
verify_sign              Ah5rOpfPGo5g6FNg95DMPybP51J5AUEdXS1hqyRAP6WYYwaixKNDgQRR

8ctopus / laravel-paypal-ipn

维护者

详情

README

特性

入门指南

文档

已知问题

示例报告