PayPal HTML表单多商品功能失效问题排查求助

Hey there! Let's get that multi-item PayPal form working for you—since you've already nailed single-item submissions, we just need to tweak a few key details to make multiple items play nice with PayPal's standard payments.

First: The Correct Multi-Item Form Structure #

The biggest difference between single and multi-item forms is using the cart command and structured, indexed parameters. Here's a working example you can adapt:

<form action="https://www.paypal.com/cgi-bin/webscr" method="post" target="_top">
  <!-- Required cart commands -->
  <input type="hidden" name="cmd" value="_cart">
  <input type="hidden" name="upload" value="1">
  <input type="hidden" name="business" value="your-merchant-email@example.com">

  <!-- Item 1 -->
  <input type="hidden" name="item_name_1" value="Premium T-Shirt">
  <input type="hidden" name="amount_1" value="29.99">
  <input type="hidden" name="quantity_1" value="1">
  <input type="hidden" name="item_number_1" value="TS-001">

  <!-- Item 2 -->
  <input type="hidden" name="item_name_2" value="Custom Hat">
  <input type="hidden" name="amount_2" value="14.99">
  <input type="hidden" name="quantity_2" value="2">
  <input type="hidden" name="item_number_2" value="HT-003">

  <!-- Item 3 (add as many as needed) -->
  <input type="hidden" name="item_name_3" value="Sticker Pack">
  <input type="hidden" name="amount_3" value="4.99">
  <input type="hidden" name="quantity_3" value="1">

  <!-- Optional: Shipping, tax, etc. -->
  <input type="hidden" name="shipping" value="5.00">
  <input type="hidden" name="tax_cart" value="3.25">

  <input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_buynowCC_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
  <img alt="" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
</form>

Key Notes on This Structure: #

• cmd=_cart: Tells PayPal this is a cart submission (instead of the single-item _xclick).
• upload=1: Critical! This enables PayPal to process multiple indexed items. Omit this, and PayPal will only recognize the first item.
• Indexed parameters: Every item uses item_name_X, amount_X, quantity_X where X starts at 1 and increments for each new item. Stick to this exact naming convention—no typos, no missing underscores.

Common Mistakes to Troubleshoot #

If your form still isn't working, check for these super easy-to-miss issues:

• Forgot upload=1: This is the #1 culprit for multi-item failures. Double-check it's present and set to 1.
• Parameter typos: Did you write itemname_1 instead of item_name_1? Or amount1 instead of amount_1? PayPal is strict about parameter names.
• Invalid amount formatting: Amounts must be numeric with a decimal point (e.g., 9.99, not $9.99 or 9,99). No currency symbols or commas allowed.
• Wrong cmd value: Using _xclick (single-item) instead of _cart will break multi-item submissions.
• Duplicate indexes: Accidentally using item_name_1 for two different items? PayPal will only process the last one with that index.
• Method not set to POST: Your form must use method="post"—GET can truncate parameters and cause unexpected behavior.

Testing Tips #

• Use PayPal's Sandbox environment first (replace the form action with https://www.sandbox.paypal.com/cgi-bin/webscr) to avoid real charges while debugging.
• After submitting the form, pay attention to any error messages PayPal displays—they often spell out exactly what's wrong (e.g., "Invalid amount for item 2").
• Check your browser's dev tools (Network tab) to verify all parameters are being sent correctly to PayPal.

内容的提问来源于stack exchange，提问作者Etienne Dupuis