10413

API

Last updated: Apr 10th, 9:54am

Returned from the following NVP/SOAP API calls:

  • SetExpressCheckout
  • DoExpressCheckoutPayment
  • DoReferenceTransaction

Cause

  • The API returns this error when a payment attempt through PayPal's Express Checkout fails due to an invalid argument.
  • This specifically occurs when the totals of the cart item amounts do not match the order amount.
  • The error indicates that item-level details are being passed, but the item amounts and total do not match.
  • Error code 10413 may return an Ack of SuccessWithWarning. This means the payment has been completed, but you won't see any item details for the transaction in your PayPal account.

Impact

The payment process is halted, preventing the customer from finalizing their purchase. This can lead to a poor customer experience and potentially lost sales if the issue is not resolved promptly.

Resolution

  • Ensure accurate totals: Verify that the total of the payment detail item parameters, such as ItemTotal, HandlingTotal, and TaxTotal, add up correctly to the OrderTotal. This step is crucial to ensure that all amounts are accurately reflected in the API request.
  • Review and update calculations: Check for any updates or modifications that could affect the calculation of totals. Ensure that any changes in item prices, taxes, shipping fees, or other charges are accurately reflected in the total amount specified in the API request.
  • Reconcile item details: Make sure that the item-level details, including quantities and prices, are correctly entered and that they sum up to the correct order total. This will help prevent discrepancies that could trigger the error.
  • Resubmit the payment request: After making the necessary corrections, resubmit the payment request. This should allow the payment to go through successfully, enabling the customer to complete their purchase without any issues.

Upgrade

The NVP/SOAP API integration method is deprecated. You can find more information about our latest integrations from the following resources:

Additional resources

If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more