为旧版PayPal集成添加按件运费：HTML变量配置指南

本教程详细阐述了如何在旧版paypal payments standard集成中实现按件运费的配置，特别是针对joomla等网站中硬编码的paypal按钮。文章将指导读者通过html表单变量来传递每个商品的运费信息，区分单件商品添加和购物车上传两种模式，并提供示例代码。同时，教程也强调了查阅官方文档的重要性，并简要介绍了现代paypal checkout作为更优解决方案。

理解PayPal Payments Standard中的运费挑战

在使用Joomla等平台搭建的网站中，如果采用的是较早期的PayPal Payments Standard集成方式，例如通过硬编码HTML表单来生成“添加到购物车”按钮，那么在处理按件、按区域变化的运费时，可能会遇到困惑。这种集成方式的运费处理机制与现代API驱动的支付网关有所不同，它主要依赖于HTML表单中传递的特定变量。

用户通常希望实现以下目标：

• 为购物车中的每个商品设定独立的运费。
• 运费金额能够根据送货区域和商品类型动态调整。

对于这种旧版PayPal集成，运费的配置并非完全在PayPal后台完成，而更多地需要通过前端HTML表单来传递具体数值。

解决方案核心：HTML变量与购物车集成

PayPal Payments Standard允许通过HTML表单中的隐藏输入字段来传递商品名称、价格、数量以及运费等详细信息。其核心在于利用特定的变量名来告知PayPal每个商品的运费。

立即学习“前端免费学习笔记（深入）”；

1. 查阅官方文档是关键

首先，最重要的是查阅PayPal Payments Standard的官方HTML变量文档。这份文档详细列出了所有可用的变量及其用途。对于本教程涉及的运费问题，以下两个链接尤为重要：

• PayPal Payments Standard HTML 变量文档
• 购物车上传命令 (_cart with upload=1) 详细说明

2. 单件商品运费配置 (Add-to-Cart模式)

如果您的表单是用于将单个商品添加到购物车（即 cmd=_cart 且 add=1），并且您希望为这个特定商品定义运费，可以直接在表单中添加 shipping 和 shipping2 变量。

• shipping: 定义该商品的运费。
• shipping2: 定义该商品的处理费（Handling Fee）。

示例代码修改：

<form action="https://www.paypal.com/cgi-bin/webscr" method="post" target="paypal">
    <input alt="Add this item to your order" name="submit" src="/add-to-order.gif" type="image" />
    <input name="add" type="hidden" value="1" />
    <input name="cmd" type="hidden" value="_cart" />
    <input name="business" type="hidden" value="your_paypal_email@example.com" />
    <input name="item_name" type="hidden" value="商品名称" />
    <input name="amount" type="hidden" value="500.00" />
    <!-- 添加此商品的运费 -->
    <input name="shipping" type="hidden" value="15.00" /> 
    <!-- 可选：添加此商品的处理费 -->
    <input name="shipping2" type="hidden" value="5.00" /> 
    <input name="no_shipping" type="hidden" value="0" /> <!-- 0 表示提示客户输入送货地址 -->
    <input name="currency_code" type="hidden" value="GBP" />
    <input name="bn" type="hidden" value="PP-ShopCartBF" />
</form>

注意： 将 no_shipping 设置为 0 是关键，这样PayPal才会提示客户输入送货地址，从而允许根据地区计算运费。如果设置为 1 或 2，PayPal将不会要求提供送货地址，运费计算会受到限制。

3. 多件商品与按件运费 (Cart Upload模式)

当您需要一次性将多个商品（每个商品有自己的运费）上传到PayPal购物车时，应使用 cmd=_cart 结合 upload=1 命令。在这种模式下，所有商品相关的变量都需要通过数字索引来区分。

Browse AI

AI驱动的网页内容抓取和数据采集工具

53

查看详情

• item_name_x: 第 x 个商品的名称。
• amount_x: 第 x 个商品的价格。
• quantity_x: 第 x 个商品的数量。
• shipping_x: 第 x 个商品的运费。
• shipping2_x: 第 x 个商品的处理费。

示例代码：

<form action="https://www.paypal.com/cgi-bin/webscr" method="post" target="paypal">
    <input type="hidden" name="cmd" value="_cart" />
    <input type="hidden" name="upload" value="1" /> <!-- 启用购物车上传模式 -->
    <input type="hidden" name="business" value="your_paypal_email@example.com" />
    <input type="hidden" name="currency_code" value="GBP" />
    <input type="hidden" name="no_shipping" value="0" /> <!-- 提示客户输入送货地址 -->

    <!-- 商品 1 -->
    <input type="hidden" name="item_name_1" value="商品 A" />
    <input type="hidden" name="amount_1" value="100.00" />
    <input type="hidden" name="quantity_1" value="2" />
    <input type="hidden" name="shipping_1" value="10.00" /> <!-- 商品 A 的运费 -->
    <input type="hidden" name="shipping2_1" value="2.00" /> <!-- 商品 A 的处理费 -->

    <!-- 商品 2 -->
    <input type="hidden" name="item_name_2" value="商品 B" />
    <input type="hidden" name="amount_2" value="25.00" />
    <input type="hidden" name="quantity_2" value="1" />
    <input type="hidden" name="shipping_2" value="5.00" /> <!-- 商品 B 的运费 -->
    <!-- 如果没有处理费，可以省略 shipping2_2 -->

    <!-- 其他表单元素，如提交按钮 -->
    <input type="image" src="/add-to-order.gif" name="submit" alt="将所有商品添加到订单" />
</form>

在实际应用中，您需要通过服务器端脚本（例如PHP、Python等）或客户端JavaScript来动态生成这些带有索引的 input 字段，以反映用户购物车中的实际商品及其计算出的运费。

实施细节与注意事项

1. 动态计算运费

由于运费需要根据地区和商品类型动态变化，您需要在前端（JavaScript）或后端（服务器端脚本）实现运费计算逻辑。

• 前端计算： 当用户选择送货地址或更改商品数量时，通过JavaScript计算运费并更新隐藏的 input 字段值。
• 后端计算： 在生成HTML表单之前，通过后端代码根据数据库中的商品信息和运费规则计算出运费，然后将其填充到表单中。后端计算通常更安全可靠。

2. no_shipping 变量的影响

no_shipping 变量控制PayPal是否要求客户输入送货地址。

• no_shipping=0 (或省略): PayPal会要求客户输入送货地址，这是实现按地区运费的关键。
• no_shipping=1: PayPal不要求输入送货地址，但假设运费已包含在商品价格中。
• no_shipping=2: PayPal不要求输入送货地址，且不计算运费。 为了能够根据地区动态计算运费，请务必将 no_shipping 设置为 0。

3. 旧版集成的局限性

PayPal Payments Standard是一种相对较旧的集成方式（已有约20年历史），其灵活性和安全性相较于现代API驱动的解决方案有一定局限性。

• 安全性： 硬编码价格和运费可能存在篡改风险。
• 用户体验： 流程相对固定，不易定制。
• 维护成本： 随着业务逻辑的复杂化，维护大量的HTML表单可能变得困难。

4. 后台设置与前端变量的优先级

PayPal后台可以设置一些通用的运费规则，但通常情况下，通过HTML表单传递的 shipping 或 shipping_x 变量会覆盖后台的通用设置，为您提供更精细的控制。

现代替代方案：PayPal Checkout

对于新的项目或考虑升级现有集成的用户，强烈建议采用现代的 PayPal Checkout 解决方案。PayPal Checkout 提供了一套更强大、更灵活的API，允许开发者通过后端集成更安全、高效地处理支付、运费、税费等复杂业务逻辑。它通常提供更好的用户体验，并能更轻松地集成到现代电商平台和框架中。

总结

在旧版PayPal Payments Standard集成中实现按件运费，主要依赖于在HTML表单中通过 shipping (单件商品) 或 shipping_x (购物车上传模式) 变量来传递运费金额。务必查阅官方文档以获取最新的变量列表和使用说明，并注意将 no_shipping 设置为 0 以启用地址输入。尽管这种方法可行，但考虑到其局限性，对于新项目或需要更高级功能的场景，推荐迁移到现代的PayPal Checkout API集成。

以上就是为旧版PayPal集成添加按件运费：HTML变量配置指南的详细内容，更多请关注php中文网其它相关文章！