PayPal gateway rejected the request. Field format error: 10431-Item amount is invalid

PayPal gateway rejected the request. Field format error: 10431-Item amount is invalid

October 1, 2026 · Illustrated author avatarBy Stefan Bogdanescu
PayPal gateway rejected the request. Field format error: 10431-Item amount is invalid

Solving PayPal Gateway Errors on Magento 1.x: Handling Discounts

As a senior developer working with e-commerce platforms, I often encounter issues like the one you’ve described - unexpected behavior when applying shopping cart price rules in Magento. Let me guide you through identifying and resolving this specific error involving the PayPal Website Payments Pro Payflow gateway.

Understanding the Error: Field Format Error 10431

The error message PayPal gateway rejected the request. Field format error: 10431-Item amount is invalid typically occurs when there’s an inconsistency between the data sent to PayPal and its expected format or validation rules. In your case, this seems to stem from applying a shopping cart price rule that alters the order total.

Why Discounts Cause This Issue

PayPal requires specific formatting for the item amounts it receives. When you apply a discount rule in Magento, the platform recalculates the totals but may not always update the format used by PayPal correctly. This mismatch is likely causing the validation error.

Step-by-Step Resolution Approach

1. Verify Your Magento Version and Setup

First, ensure your Magento version (1.8.0.0) is fully patched and optimized for use with the Payflow Pro extension. Check that you have installed the latest compatible version of the PayPal payment method.

2. Review Your Discount Rule Configuration

Examine your shopping cart price rule to confirm it’s configured properly:

  • Ensure the discount calculation method (fixed, percentage, or other) is suitable for your products.
  • Verify that the rule applies correctly based on customer groups and product attributes.
  • Check if there are any conflicts with other rules or payment methods.

3. Debug the Request Data

To understand what’s triggering the error, enable Magento logging to capture the exact data sent to PayPal:

  1. Navigate to System > Configuration.
  2. Select Advanced in the left menu.
  3. Expand Developer.
  4. Set Log Level to Debug and click Save Config.

Reload your site and place an order with a discount applied. Then, review the log file (var/log/system.log) for details on the request sent to PayPal.

4. Manually Validate the Request Format

Compare the logged request data against PayPal’s documentation (https://developer.paypal.com/docs/api/) for the specific API endpoint used by your gateway (likely the Express Checkout or Direct Payment integration).

Ensure that:

  • The item amount format matches PayPal’s required decimal precision.
  • Any taxes and discounts are included correctly in the totals structure.
  • There are no missing or incorrectly formatted fields.

5. Update Your Discount Rule or Customize the Integration

If the issue persists, you have a few options:

1. Adjust your discount rule configuration:

  • Test with smaller discount values to narrow down if there’s an amount threshold causing issues.
  • Consider using fixed amounts instead of percentages for discounts under $0.01.

2. Modify the PayPal integration logic:

You can customize how Magento prepares the payment data before sending it to PayPal. This requires editing the app/code/core/Paypal/Integration/Model files and ensuring they handle pricing adjustments correctly.

3. Contact Magento Support or PayPal Developer Support

If you’ve exhausted these troubleshooting steps, reach out to either Magento’s official support channels (https://magento.com/help) or PayPal’s developer community (https://developer.paypal.com/docs/integration/direct/payflow-interface-integration-guide/).

Provide them with the logged request data and error details for further assistance.

Conclusion: Resolving Payment Gateway Issues in Magento

This error is a common symptom of miscommunication between your e-commerce platform and payment gateway due to price adjustments. By following this guide, you should be able to identify whether the issue lies in your discount rule configuration or requires customization of your PayPal integration.

Remember that proper testing of all edge cases is crucial when working with third-party payment gateways on Magento. Always validate the data flow end-to-end and ensure compatibility between software versions and extensions.

If you’re looking for professional help in managing complex payment integrations like this, feel free to reach out to our team at Laravel Company. We specialize in optimizing e-commerce experiences through custom development and integration services.

Magento 1 Checkout Performance Security

Our network