Why did I get API error code 10009?

Multiple issues can produce this error. These are explained in the following paragraphs.

Authorization and Capture API errors

If the account is locked or inactive, retry the request later or close the order.

RefundTransaction API errors

First, to resolve this issue, check that there is sufficient money in your PayPal balance.

The following errors can also produce error code 10009:

  • The bank account attached to your PayPal account is not verified.
  • The partial refund amount isn't less than or equal to the original transaction amount.
  • The partial refund amount isn't less than or equal to the remaining amount.
  • The partial refund amount is invalid.
  • If a buyer opened a dispute for a transaction, only the full or remaining amount can be refunded.
  • The time limit to refund this transaction has been exceeded.
  • A full refund can’t be issued after a partial refund.
  • Check if your PayPal account is locked or inactive.
  • Check if your PayPal account has a limitation.
  • The partial refund isn't in the same currency as the original transaction.
  • This transaction has already been fully refunded.
  • This type of transaction can’t be refunded.
  • A partial refund of this transaction can’t be issued.
  • The account for the buyer is locked or inactive.

DoReferenceTransaction errors

  • The buyer’s account is locked or inactive.
  • The seller’s account is locked, closed, or has a limitation.

AddressVerify API errors

  • The AddressVerify or the Address APIs are disabled.

PayPal NVP and SOAP API Reference Guides.

See the Developer Portal for a complete list of NVP/SOAP API error codes.

How do I remove a limitation from my PayPal account
How do I verify my PayPal account

More ways we can help

Resolution Center

Fix transaction and account related issues

Tax center

Get your 1099-K and other tax info here

Business Help

Get help with using any of our PayPal products

Technical Help

Find out how PayPal works for your business

Message Center

Send, receive, and view your PayPal messages