README

本包仅是这个仓库 IPN 类的实现

https://github.com/Quixotix/PHP-PayPal-IPN

在 composer.json 的 "require-dev" 中添加以下内容

"fahim/laravel5-paypal-ipn": "dev-master@dev"

PHP-PayPal-IPN

PHP 5 的 PayPal 即时支付通知 (IPN) 类。

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

为 Laravel 提供服务

'Fahim\PaypalIPN\PaypalIPNServiceProvider',

使用场景

use Fahim\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 编译时，如果未显式设置 cURL 选项的 SSL 版本，调用 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

drongen / laravel5-paypal-ipn

维护者

详细信息

README

PHP-PayPal-IPN

功能

入门指南

文档

已知问题

示例报告