Analyze the PHP development method of PayPal payment interface

申请PayPal注册网址：https://www.paypal.com/

paypal接口与其它接口有些不同，稍微复杂一点。其实银行接口也算是一个站点的插件。

所谓paypal ipn（Instant Payment Notification），就是Paypal开发的一种能主动通知第三方卖家系统交易状态的一种机制。IPN的原理很简单，就是当产生了一个交易之后，交易状态发生变化时，如用户已经付款、或者退款、撤销时，Paypal利用常用的HTTP POST方式，将交易的一些变量提交给网站的某个页面（称之为IPN Handler），当这个页面接受到请求时候，将这些数据原封不动加上一个指示验证的cmd=_notify-validate，POST回Paypal 的接口地址，如果数据正确，那么Paypal返回字符串VERIFIED，否则为INVALID，如果结果为VERIFIED，那么你的程序就可以使用这些数据进行操作。

开设Sandbox帐号

但代码的调试是一件很痛苦的事情，因为作为第三方开发人员，不可能开两个帐号，每次测试还要之间交易一些钱，所以Paypal专门开发了Sandbox给开发人员进行开发，首先到https://developer.paypal.com/注册一个开发帐号，好了之后再进入Sandbox建立测试用的Paypal虚拟帐号（至少应该建立一个Business的和一个Personal的），这种账号注册方法和Paypal的流程一样，信息可以是假的，包括银行帐号、信用卡（其实Paypal Sandbox会自动生成一些随机的号码）。接下来需要激活Paypal Sandbox的虚拟帐号，注意，这里不管你在Paypal Sanbox注册时填什么邮件地址，有任何发送到虚拟帐号所填邮箱的邮件都存会在开发帐号的管理界面中的Email页（导航栏上有）中。登录 Sandbox的虚拟Paypal环境，还需要验证虚拟帐号的银行，这里可以随便填，然后通过Add Funds来给账户充值（想填多少填多少 920-203 920-533 ）。然后，还需要激活IPN的选项，在Business的那个账户的Profile设置页面中，点击，然后点击Edit按钮，打开IPN，这里如果你使用的是固定的IPN Handle，可以直接将地址填入。

接下来，我们测试的时候，应该将Paypal接口的地址设置为https://www.sandbox.paypal.com/cgi-bin/webscr

基本的流程

当客户向您付款时，PayPal将向位于指定 URL (type=”hidden” name=”notify_url” value=” “)的服务器发送一个通知。此通知中将包括您的客户的所有付款信息（例如，客户名称、金额），以及一段加密代码。当服务器收到通知时，它随后会将该信息（包括加密代码）发送回安全的PayPal URL。PayPal将通过检查加密字符串对交易进行身份验证。这种将 IPN 数据传回PayPal的操作防止了“欺骗”，因此您可以确保 IPN 来自PayPal。在进行验证时，PayPal会将其合法性的确认信息发送回您的服务器。

提示：要启用即时付款通知，您将需要输入一个 URL，通过它您可以接收到来自您的用户信息的通知。

启用了即时付款通知后，每次当您接收付款时您的服务器都会收到一个通知，此通知将以隐藏的“FORM POST”的方式发送到指定的 URL，并将包括所有付款信息。此页面的底部列出了通知的 FORM 变量。

每次收到来自PayPal的 IPN 时，您必须在实施订单之前完成如下所述的通知确认过程。确认列出的信息将可确保交易合法。

通知确认IPN

为了确保付款已进入您的PayPal账户，您必须验证用作“receiver_email”的电子邮件地址是否已在您的PayPal账户中注册并得到确认。

服务器收到即时付款通知后，您将需要通过构建一个发送到PayPal的 HTTP POST 对其进行确认。您的 POST 应发送到https://www.paypal.com/cgi-bin/webscr

您必须完全按照收到表单变量时的原样发送所有收到的表单变量。您还需要将一个值为“_notify-validate”的名为“cmd”变量（例如，cmd=_notify-validate）附加到 POST 字符串。

PayPal将回复该 POST，并在回复的正文中包含一个单词“VERIFIED”或“INVALID”。当您收到 VERIFIED 回复时，您需要在实施订单之前执行若干检查：

确认“payment_status”为“Completed”，因为系统也会为其他结果（如“Pending”或“Failed”）发送 IPN。

检查“txn_id”是否未重复，以防止欺诈者重复使用旧的已完成的交易。

验证“receiver_email”是已在您的PayPal账户中注册的电子邮件地址，以防止将付款发送到欺诈者的账户。

检查其他交易详情（如物品号和价格），以确认价格未改变完成了以上检查后，您可以使用 IPN 数据更新您的数据库，并处理购物。

如果收到“无效”通知，则应将其视为可疑通知，并应对其进行调查。

主要参数：

向PayPal提交粘贴代码时，应包括以下 4 个隐藏变量及一张图片，这就是说，您粘贴到PayPal的最短必需代码应如下：

<form action="https://www.paypal.com/row/cgi-bin/webscr" method="post">

<input type="hidden" name="cmd" value="_xclick"> // "_xclick" 立即购买

<input type="hidden" name="business" value="you@youremail.com">
//PayPal账户上的电子邮件地址

<input type="hidden" name="item_name" value="Item Name">
//物品名称（或购物车名称）

<input type="hidden" name="currency_code" value="USD">
//定义币种以标示货币变量值可以为 "USD"、"EUR"、"GBP"、"CAD"、"JPY"。

<input type="hidden" name="amount" value="0.00">
//物品的价格（购物车中所有物品的总价格,因为是_Xclick模式）
<input type="image" src="http://www.paypal.com/zh_XC/i/btn/x-click-but01.
gif" name="submit" alt="请使用PayPal付款！">

form>

可用变量

business 您的PayPal账户上的电子邮件地址

quantity 物品数量。大于 1 时，会与金额相乘

item_name 物品名称（或购物车名称）。必须是字母数字字符，最多为 127 个字符

item_number 用于跟踪付款的可选传递变量。必须是字母数字字符，最多为 127 个字符

amount 物品的价格（购物车中所有物品的总价格）

shipping 该物品的运送成本

shipping2 每增加一件物品所需的运送成本

handling 手续费

tax 基于交易的税额。如果使用该变量，传递值将覆盖所有用户信息税收设置（不管买家所在位置）。

no_shipping 送货地址。如果设为 "1"，则不会要求您的客户提供送货地址。该变量为可选项；如果省略或设为 "0"，将提示您的客户输入送货地址

cn 可选标签，会在提示栏上显示（最多 40 个字符）

no_note 为付款加入提示。如果设为 "1"，则不会提示您的客户输入提示。该变量为可选项；如果省略或设为 "0"，将提示您的客户输入提示。

on0 第一选项栏名称。最多 64 个字符

os0 第一组选项值。最多 200 个字符。"on0" 必须定义，以便识别 "os0"。

on1 第二选项栏名称。最多 64 个字符

os1 第二组选项值。最多 200 个字符。"on1" 必须定义，以便识别 "os1"。

custom 决不会向您的客户显示的可选转递变量。可用于跟踪存货

invoice 决不会向您的客户显示的可选转递变量。可用于跟踪账单号

notify_url 仅与 IPN 一起使用。发送 IPN Form Post 的互联网 URL

return 您的客户完成付款后将返回的互联网 URL

cancel_return 您的客户取消付款后将返回的互联网 URL

image_url 您要用作图标的图片的互联网 URL，图片大小为 150 X 50 像素

cs 设置您的付款页面的背景色。如果设为 "1"，背景色将为黑色。该变量为可选项；如果省略或设为 "0"，背景色将为白色

扩展变量

PayPal 允许您粘贴扩展变量，条件是将改变以下 "cmd" 值：

到：

通过上述 “cmd” 值修改，您还可使用以下变量：

扩展变量

email 客户的电子邮件地址

first_name 客户的名。必须是字母数字字符，最多为 32 个字符

last_name 客户的姓。必须是字母数字字符，最多为 64 个字符

address1 客户地址所在国家或地区。必须是字母数字字符，最多为 100 个字符

address2 客户地址第二行。必须是字母数字字符，最多为 100 个字符

city 客户地址所在城市。必须是字母数字字符，最多为 100 个字符

state 客户地址所在州。必须是正式的 2 个字母缩写

zip 客户地址的邮政编码

night_phone_a The area code of the customer’s nighttime contact phone number

night_phone_b The first three digits of the customer’s nighttime contact phone number

day_phone_a The area code of the customer’s daytime contact phone number

day_phone_b The first three digits of the customer’s contact phone number during the day

Tip: To change the default shipping and handling settings in User Information, go to your User Information, edit your shipping calculations, and click the "Allow transaction-based shipping" checkbox.

Transfer individual items to PayPal

If your third-party shopping cart can be set up to pass individual items to PayPal, information about the items will be added to buyer and seller logs and system notifications. To include this item's information, you'll need to paste the HTML formatting element into the new version of the PayPal shopping cart process. The process is very similar to the one described in Section #1, "Passing Total Cart Quantity to PayPal", with the following exceptions:

Set the "cmd" variable to "_cart"

Replace necessary HTML lines

and

Add new variable called “upload”

Add the following line between the

and tags:

Define item details

For each item-specific parameter below, define a new set of values that correspond to each item purchased through your partner's shopping cart. Append "_x" to the variable name, where x is the item number, starting at 1 and increasing by one for each item added.

item_name_x (required for item #x) The name of item #x in the cart. Must be alphanumeric, up to 127 characters

item_number_x Optional pass-through variable associated with item #x in the cart. Must be alphanumeric, up to 127 characters

amount_x (required for item #x) The price of item #x

shipping_x Cost to ship the first unit (quantity 1) of item #x

shipping2_x Shipping cost for each additional item #x shipped (quantity 2 or more)

handling_x cost of handling item #x

on0_x The first option column name of item #x. Maximum 64 characters

os0_x The first set of option values for item #x. Maximum 200 characters. "on0_x" must be defined in order to recognize "os0_x".

on1_x Secondary option column name for item #x. Maximum 64 characters

os1_x The second set of option values for item #x. Maximum 200 characters. "on1_x" must be defined in order to recognize "os1_x".

Repeat this for each item in the cart

Add a set of required variables and any option variables from the table above for each item in your buyer's cart. The first item in the shopping cart must be defined with parameters ending with "_1", such as "item_name_1", "amount_1", etc. Similarly, the second item should be named using the variables "item_name_2", "amount_2", etc. Tip: "_x" values must increase sequentially by one in order to be recognized. If you jump from item #1 to item #3 without defining item #2, the third item will be ignored.

To specify currency: All currency variables (amount, shipping, shipping2, fees, taxes) will be displayed in the currency specified by the "currency_code" variable pasted on the payment. Since it is not item-specific, there is no need to append "_x" to the variable name. If the "currency_code" variable is not pasted, we will assume that all currency variable values are USD.

The above are the main steps introduced in this article to use PHP to develop the PayPal payment interface.

Related labels：

https paypal php develop interface pay Way register Apply of URL parse

source：php.cn

Previous article：PHP verification code code (latest modification, fully customized!)_PHP tutorial Next article：PHP foreach parameter coercion problem_PHP tutorial

Statement of this Website

The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn

Analyze the PHP development method of PayPal payment interface_PHP tutorial