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"，它们有不同的价格和运费。

MewXAI

一站式AI绘画平台，支持AI视频、AI头像、AI壁纸、AI艺术字、可控AI绘画等功能

311

查看详情

<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中文网其它相关文章！