The world of Marketers

[转]向您的第三方购物车中添加PayPal结账功能

时间：2007-11-22 9:13:38 | 作者：PayPal | 分类：学习摘录 | 浏览: | 来自：www.paypal.com |
有些网站开发者可能希望将PayPal付款处理集成到他们自己的第三方购物车上，而不是标准的PayPal购物车上。请使用以下说明为您的买家提供PayPal付款，以便他们在您的第三方购物车上添加购置物品后结账时使用。

将您的第三方购物车与PayPal的付款流程集成目前有两种方法。第一种方法是传递购物车付款总额，而不是单个物品金额。第二种方法是将所选物品详情传递给PayPal，而不是总购物车数量。提示：按下述步骤粘贴必需的变量到PayPal时，可能需要在您的网站上执行某些脚本。

• 方法 1. 将总购物车数量传递给PayPal
• 方法 2. 将单个物品传递给PayPal
  

方法 1. 将总购物车数量传递给PayPal

如果愿意，您可以累加整个购物车，将总数量传递给 PayPal 的 立即购买按钮代码（也就是说，您需要粘贴整个购物车的单一名称及其物品总价款，与购买单件物品一样）。

该方法有一个不足之处，您的买家将无法查看其购物车中的单个物品。此外，您不能修改我们的变量名称，也不能添加您自己的变量名称。

查阅以下信息后如有其他技术问题，请访问我们的 开发者服务网页。欲知有关“立即购买”按钮代码或以下变量的附加信息，请查看网站付款标准版集成指南 (PDF, 5.3MB, 2006 年 8 月)。

必需的变量

向PayPal提交粘贴代码时，应包括以下 4 个隐藏变量及一张图片：

必需的变量 姓名 值 business 您的PayPal账户上的电子邮件地址 item_name 物品名称（或购物车名称） currency_code 定义币种以标示货币变量（金额、运送费、运送费 2、手续费、税款）。值可以为 "USD"、"EUR"、"GBP"、"CAD"、"JPY"。 amount 物品的价格（购物车中所有物品的总价格） image 按钮图片，您的买家按此按钮开始PayPal付款程序。您可以将 src 更换为图片 URL，以使用您自己的图片

这就是说，您粘贴到PayPal的最短必需代码应如下：

<form action="https://www.paypal.com/row/cgi-bin/webscr" method="post"> <input type="hidden" name="cmd" value="_xclick"> <input type="hidden" name="business" value="you@youremail.com"> <input type="hidden" name="item_name" value="Item Name"> <input type="hidden" name="currency_code" value="USD"> <input type="hidden" name="amount" value="0.00"> <input type="image" src="http://www.paypal.com/zh_XC/i/btn/x-click-but01.gif" name="submit" alt="请使用PayPal付款 —— 快捷、免费和安全的付款方式！"> </form>

PayPal 提供附加变量，用于自定义您的 Form Post。所有可用变量如下（变量名称必须用小写）：

可用变量 姓名 值 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" 值：

<input type="hidden" name="cmd" value="_xclick">

到：

<input type="hidden" name="cmd" value="_ext-enter"> <input type="hidden" name="redirect_cmd" value="_xclick">

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

扩展变量 姓名 值 email 客户的电子邮件地址 first_name 客户的名。必须是字母数字字符，最多为 32 个字符 last_name 客户的姓。必须是字母数字字符，最多为 64 个字符 address1 客户地址所在国家或地区。必须是字母数字字符，最多为 100 个字符 address2 客户地址第二行。必须是字母数字字符，最多为 100 个字符 city 客户地址所在城市。必须是字母数字字符，最多为 100 个字符 state 客户地址所在州。必须是正式的 2 个字母缩写 zip 客户地址的邮政编码 night_phone_a 客户夜间联系电话号码的区号 night_phone_b 客户夜间联系电话号码前三位     day_phone_a 客户白天联系电话号码的区号 day_phone_b 客户白天联系电话号码前三位

提示：若要更改“用户信息”中的默认运费和手续费设置，请转至您的用户信息，编辑您的运费计算，然后点击“允许采用基于交易的运费”复选框。

方法 2. 将单个物品传递给PayPal

如果您的第三方购物车可设置成向PayPal传递单个物品，有关物品的信息将加入买家和卖家的记录日志和系统通知中。要加入该物品的信息，您需要将 HTML 格式元素粘贴至PayPal购物车流程的新版本。该过程与 #1 节“将总购物车数量传递给PayPal”描述的非常相似，不同之处在于：

1. 将 "cmd" 变量设置到 "_cart"
   更换必要的 HTML 行
   
   

   <input type="hidden" name="cmd" value="_xclick">

   
   与
   
   

   <input type="hidden" name="cmd" value="_cart">

   
   
2. 添加称为 "upload" 的新变量
   
   在 <表格> 和 </表格> 标签之间新增以下行：
   
   

   <input type="hidden" name="upload" value="1">

   
   
3. 定义物品明细
   对于以下各特定物品参数，定义与通过您的合作商购物车购买的各物品对应的一组新值。将 "_x" 附加到变量名称，其中 x 是物品号码，从 1 开始，每加入一物品增加一。
   
   

   姓名 值 item_name_x （物品 #x 需要）购物车中物品 #x 的名称。必须是字母数字字符，最多为 127 个字符 item_number_x 与购物车中物品 #x 关联的可选传递变量。必须是字母数字字符，最多为 127 个字符 amount_x （物品 #x 需要）物品 #x 的价格 shipping_x 运送物品 #x 的第一件（数量 1）的成本 shipping2_x 每增加一件运送物品 #x（数量 2 或更多）所需的运送成本 handling_x 物品 #x 的处理成本 on0_x 物品 #x 的第一选项栏名称。最多 64 个字符 os0_x 物品 #x 的第一组选项值。最多 200 个字符。"on0_x" 必须定义，以便识别 "os0_x"。 on1_x 物品 #x 的第二选项栏名称。最多 64 个字符 os1_x 物品 #x 的第二组选项值。最多 200 个字符。"on1_x" 必须定义，以便识别 "os1_x"。

   
   
4. 为购物车中每件物品重复此设定
   为您的买家购物车中的各物品加入以上表格中的一组必需的变量和任何选项变量。购物车中的第一物品必须用以 "_1" 结束的参数定义，如 "item_name_1"、"amount_1" 等。同样，第二物品应用变量 "item_name_2"、"amount_2" 等命名。提示："_x" 值必须以一为单位按序递增，以便识别。如果从 item #1 跳到 item #3 而不定义 item #2，则第三个物品会被忽略。
   
   要指定币种：所有货币变量（金额、运费、运费 2、手续费、税款）将以粘贴在付款上的 "currency_code" 变量指定的币种显示。因为其不是随物品不同的，无需向变量名称附加 "_x"。如果没有粘贴 "currency_code" 变量，我们将假定所有货币变量值为美元。

---