旧版 PayPal Standard 集成：配置商品级运费的实践指南

在旧版 PayPal Standard 中，所有商品信息（如名称、价格、数量）和交易参数（如货币代码、运费）都通过隐藏的 字段传递。要为每个商品添加独立的运费，我们需要了解并正确使用 PayPal 提供的相关 HTML 变量。

配置商品级运费

为了实现商品级运费的自定义，我们需要利用 PayPal Standard 购物车命令 (_cart) 的特性，并在每个商品对应的表单中明确指定其运费。

1. 购物车命令 (_cart) 的作用

当您的表单中包含 cmd="_cart" 和 add="1" 这两个隐藏字段时，每次提交表单都会将一个商品添加到用户的 PayPal 购物车中。这意味着您可以为网站上的每个商品设置一个独立的“添加到购物车”按钮，并为该商品指定特定的运费。

2. 引入商品级运费变量

在每个商品对应的 HTML 表单中，您可以通过添加一个名为 shipping 的隐藏字段来指定该商品的运费。

• shipping: 此变量用于指定当前商品的运费金额。当商品被添加到购物车时，此金额会作为该商品的独立运费计入总价。

示例代码：为商品添加运费

MagicArena

字节跳动推出的视觉大模型对战平台

163

查看详情

以下是基于您提供的原始代码修改后的示例，展示了如何为单个商品添加 shipping 变量：

<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" /> <!-- 请替换为您的 PayPal 商家邮箱 -->
    <input name="item_name" type="hidden" value="商品名称示例" />
    <input name="amount" type="hidden" value="500.00" />
    <!-- 核心修改：新增 'shipping' 字段以指定当前商品的运费 -->
    <input name="shipping" type="hidden" value="10.50" /> <!-- 例如，该商品的运费为 10.50 GBP -->
    <input name="no_shipping" type="hidden" value="2" />
    <input name="currency_code" type="hidden" value="GBP" />
    <input name="bn" type="hidden" value="PP-ShopCartBF" />
</form>

在上述代码中，value="10.50" 即为该“商品名称示例”的运费。如果您有多个商品，每个商品的“添加到购物车”表单都应包含各自的 shipping 字段，并根据实际情况设置不同的运费值。

3. 动态运费处理

如果您的运费需要根据送货区域、商品重量、数量或其他复杂规则动态计算，那么您需要在服务器端（例如使用 PHP, Python, Node.js 等）生成这些 HTML 表单。当用户访问商品页面时，您的服务器端逻辑会根据预设的规则计算出该商品的运费，然后将其填充到 shipping 隐藏字段的 value 属性中，再将完整的 HTML 表单渲染到页面上。

例如，一个简化的服务器端逻辑可能如下：

<?php
$itemPrice = 500.00;
$itemShipping = 10.50; // 假设通过某种逻辑计算得出

// 根据区域或其他条件动态调整运费
if ($_GET['region'] == 'EU') {
    $itemShipping = 15.00;
} elseif ($_GET['region'] == 'US') {
    $itemShipping = 20.00;
}
?>

<form action="https://www.paypal.com/cgi-bin/webscr" method="post" target="paypal">
    <!-- ... 其他不变的字段 ... -->
    <input name="item_name" type="hidden" value="动态商品名称" />
    <input name="amount" type="hidden" value="<?php echo htmlspecialchars($itemPrice); ?>" />
    <input name="shipping" type="hidden" value="<?php echo htmlspecialchars($itemShipping); ?>" />
    <!-- ... 其他不变的字段 ... -->
</form>

注意事项与最佳实践

1. 查阅官方文档：PayPal Standard 的集成变量非常多，建议查阅其官方的 HTML 变量文档 以获取所有可用参数的详细说明。特别是关于 购物车上传命令 的部分，对理解多商品和运费处理至关重要。
2. no_shipping 变量：在示例代码中，no_shipping 被设置为 2。这意味着 PayPal 不会要求用户提供收货地址。如果您需要收集用户的收货地址以进行物理配送，应将其设置为 0 或 1。设置为 0 表示需要收货地址，但不需要电话号码；设置为 1 表示需要收货地址和电话号码。请根据您的业务需求进行调整。
3. 旧版集成警告：请务必注意，PayPal Standard 这种基于 HTML 表单的集成方式已经非常陈旧（已有约20年历史）。它可能缺乏现代支付系统所提供的许多功能，例如：
   • 安全性：可能不如现代 API 集成安全，例如对 CSRF 和其他攻击的防御。
   • 用户体验：支付流程可能不够流畅，不支持最新的支付方式或界面优化。
   • 功能扩展：难以集成复杂的业务逻辑，如订阅、退款自动化、高级报告等。
   • 维护性：PayPal 官方对这种旧版集成的支持和更新可能有限。
4. 现代替代方案：强烈建议考虑升级到现代的 PayPal Checkout 或其他 API 驱动的集成方式。现代的 PayPal Checkout 提供了更强大的功能、更高的安全性、更好的用户体验以及更灵活的集成选项。您可以访问 PayPal Checkout 开发者文档 了解更多信息。升级到现代解决方案将为您的网站带来更稳定、更高效的支付体验。

总结

通过在每个商品的“添加到购物车”HTML 表单中添加 shipping 隐藏字段，您可以为旧版 PayPal Standard 集成实现商品级的运费设置。对于需要动态计算运费的场景，结合服务器端逻辑生成这些表单是必要的。然而，鉴于这种集成方式的年代久远性，我们强烈建议您评估并考虑升级到现代的 PayPal Checkout 或其他 API 驱动的支付解决方案，以获得更优的安全性、功能性和用户体验。