向您的第三方购物车中添加PayPal结账功能
有些网站开发者可能希望将PayPal付款处理集成到他们自己的第三方购物车上,而不是标准的PayPal购物车上。请使用以下说明为您的买家提供PayPal付款,以便他们在您的第三方购物车上添加购置物品后结账时使用。
将您的第三方购物车与PayPal的付款流程集成目前有两种方法。第一种方法是传递购物车付款总额,而不是单个物品金额。第二种方法是将所选物品详情传递给PayPal,而不是总购物车数量。提示:按下述步骤粘贴必需的变量到PayPal时,可能需要在您的网站上执行某些脚本。
方法 1. 将总购物车数量传递给PayPal |
如果愿意,您可以累加整个购物车,将总数量传递给PayPal的立即购买按钮代码(也就是说,您需要粘贴整个购物车的单一名称及其物品总价款,与购买单件物品一样)。
该方法有一个不足之处,您的买家将无法查看其购物车中的单个物品。此外,您不能修改我们的变量名称,也不能添加您自己的变量名称。
查阅以下信息后如有其他技术问题,请访问我们的 开发者服务网页。欲知有关“立即购买”按钮代码或以下变量的附加信息,请查看网站付款标准版集成指南 (PDF,4.6 MB,2008年3月)。
必需的变量
向PayPal提交粘贴代码时,应包括以下 4 个隐藏变量及一张图片:
|
这就是说,您粘贴到PayPal的最短必需代码应如下:
|
PayPal 提供附加变量,用于自定义您的 Form Post。所有可用变量如下(变量名称必须用小写):
|
扩展变量
PayPal 允许您粘贴扩展变量,条件是将改变以下 "cmd" 值:
|
到:
|
通过上述 "cmd" 值修改,您还可使用以下变量:
|
提示:若要更改“用户信息”中的默认运费和手续费设置,请转至您的用户信息,编辑您的运费计算,然后点击“允许采用基于交易的运费”复选框。
方法 2. 将单个物品传递给PayPal |
如果您的第三方购物车可设置成向PayPal传递单个物品,有关物品的信息将加入买家和卖家的记录日志和系统通知中。要加入该物品的信息,您需要将 HTML 格式元素粘贴至PayPal购物车流程的新版本。该过程与 #1 节“将总购物车数量传递给PayPal”描述的非常相似,不同之处在于:
- 将 "cmd" 变量设置到 "_cart"
更换必要的 HTML 行
<input type="hidden" name="cmd" value="_xclick">
与
<input type="hidden" name="cmd" value="_cart">
- 添加称为 "upload" 的新变量
在 <表格> 和 </表格> 标签之间新增以下行:
<input type="hidden" name="upload" value="1">
- 定义物品明细
对于以下各特定物品参数,定义与通过您的合作商购物车购买的各物品对应的一组新值。将 "_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"。
- 为购物车中每件物品重复此设定
为您的买家购物车中的各物品加入以上表格中的一组必需的变量和任何选项变量。购物车中的第一物品必须用以 "_1" 结束的参数定义,如 "item_name_1"、"amount_1" 等。同样,第二物品应用变量 "item_name_2"、"amount_2" 等命名。提示:"_x" 值必须以一为单位按序递增,以便识别。如果从 item #1 跳到 item #3 而不定义 item #2,则第三个物品会被忽略。
要指定币种:所有货币变量(金额、运费、运费 2、手续费、税款)将以粘贴在付款上的 "currency_code" 变量指定的币种显示。因为其不是随物品不同的,无需向变量名称附加 "_x"。如果没有粘贴 "currency_code" 变量,我们将假定所有货币变量值为美元。
查阅以下信息后如有其他技术问题,请访问我们的开发者支持网页。欲知有关购物车代码或以下变量的其他信息,请查看网站付款标准版集成指南 (PDF,4.6 MB,2008年3月)。