PayPal标准支付集成：按商品配置运费详解

本文旨在为使用 paypal website payments standard（旧版 html 表单集成）的用户提供按商品配置运费的详细指南。我们将探讨如何利用 paypal 预定义的 html 变量，特别是针对购物车上传命令，来为每个商品设置独立的运费。文章还将强调查阅官方文档的重要性，并提醒读者该集成方式的局限性及其与现代 paypal checkout 解决方案的 区别。

引言：PayPal 标准支付与商品运费配置

对于许多早期建立的电子商务网站，特别是那些基于 Joomla 等内容管理系统并采用硬 编码 PayPal 按钮的平台，PayPal Website Payments Standard（也称为 PayPal 标准支付或 Website Standard HTML Variables）是一种常见的支付集成方式。这种方法允许开发者通过简单的html 表单 向 PayPal 传递交易信息，包括商品名称、价格、数量等。当需要为购物车中的每个商品设定不同的运费时，理解其背后的运费处理机制和相应的 HTML 变量至关重要。

理解 PayPal 标准支付的运费机制

PayPal 标准支付的核心在于通过一系列预定义的 HTML input 字段来构建交易请求。用户提供的基础代码示例展示了一个典型的单品添加至购物车的表单：

<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-email@example.com" />     <input name="item_name" type="hidden" value="Item name" />     <input name="amount" type="hidden" value="500.00" />     <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>

在这个示例中，cmd 字段被设置为 _cart，表示这是一个添加到 PayPal 购物车的操作。然而，要实现按商品计算运费，我们需要更精细地控制每个商品的属性，这需要利用 PayPal 提供的购物车上传（Cart Upload）功能。

核心：配置商品级运费变量

要为购物车中的每个商品单独设置运费，需要将 cmd 值设置为 _cart，并额外添加一个 upload 字段并将其值设为 1。这会告诉 PayPal，你将通过表单上传一个包含多个商品详细信息的购物车。在此模式下，每个商品的属性（如名称、价格、数量、运费）都通过带有数字后缀的变量来区分。

以下是实现商品级运费配置的关键变量和修改后的表单结构：

1. cmd: 必须为 _cart。
2. upload: 必须为 1，启用购物车上传功能。
3. 商品特定变量: 对于购物车中的第 x 个商品（x 从 1 开始递增），使用以下格式的变量：
   • item_name_x: 商品名称。
   • amount_x: 商品单价。
   • quantity_x: 商品数量。
   • shipping_x: 该商品的独立运费。这是实现按商品运费的关键。
   • shipping2_x: 可选，针对该商品的额外运费（例如，第二个及后续同款商品的运费）。

示例代码：

假设我们有两个商品，” 商品 A ” 和 ” 商品 B ”，它们有不同的价格和运费。

AppMall 应用商店

AI 应用商店，提供即时交付、按需付费的人工智能应用服务

56

查看详情

<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-email@example.com"> <!-- 你的 PayPal 商家  邮箱 -->      <!-- 第一个商品：商品 A -->     <input type="hidden" name="item_name_1" value=" 商品 A ">     <input type="hidden" name="amount_1" value="50.00">     <input type="hidden" name="quantity_1" value="1">     <input type="hidden" name="shipping_1" value="5.00"> <!-- 商品 A 的独立运费 -->      <!-- 第二个商品：商品 B -->     <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="3.50"> <!-- 商品 B 的独立运费 -->      <!-- 通用设置 -->     <input type="hidden" name="currency_code" value="GBP">     <!-- no_shipping=0 允许 PayPal 提示并收集收货地址，这对于收取运费是必要的。如果设置为 2（如原代码），表示不要求收货地址，可能导致运费处理异常。-->     <input type="hidden" name="no_shipping" value="0">     <input type="image" src="/add-to-order.gif" border="0" name="submit" alt=" 添加到订单 "> </form>

在上述代码中，shipping_1 和 shipping_2 分别为商品 A 和商品 B 指定了独立的运费。当用户点击“添加到订单”按钮时，PayPal 将接收到包含这些详细运费信息的购物车。

重要注意事项

1. 查阅官方文档： 上述集成方式属于 PayPal 的旧版产品，即 PayPal Website Standard HTML Variables。所有可用的变量及其详细用法、限制和最佳实践，都应以 PayPal 官方开发者文档为准。建议搜索“PayPal Website Standard HTML Variables”或“PayPal Payments Standard integration guide”以获取最权威和全面的信息。官方文档通常会提供一个完整的变量列表，包括 handling（处理费）等其他相关字段。

2. 运费计算逻辑： 尽管 HTML 表单允许你传递商品级运费，但根据地区、商品重量、体积或促销活动动态计算这些运费的逻辑，必须在 你的网站 后端 （例如，在 Joomla 的php 代码中）实现。PayPal 表单仅负责将这些已计算好的 值传递 给 PayPal，它本身不提供复杂的运费计算引擎。

3. no_shipping 字段： 在原代码中，no_shipping 被设置为 2，这表示“不要求收货地址，但允许用户输入”。如果你计划收取运费，通常需要收集用户的收货地址。因此，建议将 no_shipping 设置为 0（允许 PayPal 提示收货地址）或 1（不提示收货地址，但如果地址已在 PayPal 账户中，则使用）。如果设置为 2 且未提供地址，PayPal 可能无法正确计算或应用运费。

4. 旧版集成： 务必认识到 PayPal Website Payments Standard 是一个相对老旧的集成方式（已有约 20 年历史）。虽然它仍然有效，但其灵活性和安全性相较于现代 API 驱动的解决方案（如 PayPal Checkout）有显著差距。对于新的项目或对现有系统进行重大升级时，强烈建议考虑迁移到 PayPal Checkout 或其他更新的 API 集成方式，它们提供了更强大的功能、更好的用户体验和更灵活的运费处理选项。

总结

通过正确利用 PayPal Website Payments Standard 中的购物车上传功能（cmd=_cart 和 upload=1），并为每个商品设置带有数字后缀的 shipping_x 变量，你可以实现在硬 编码 HTML 表单中按商品添加独立运费。然而，这种方法的局限性在于运费计算逻辑需在网站 后端 完成，且其整体灵活性和功能性远不如现代的 PayPal API 集成。对于长期维护和新开发项目，建议优先考虑升级到 PayPal Checkout 等更先进的解决方案，以获得更强大的功能和更好的可扩展性。

以上就是 PayPal 标准支付集成：按商品配置运费详解的详细内容，更多请关注 php 中文网其它相关文章！