Help Article

Why did I get API error code 10009?

Issue
PayPal returned API error code 10009 - Transaction refused.

Causes
Multiple issues, explained in the next few paragraphs, can produce this error.

Solutions
 
Authorization and capture API errors
If the account is locked or inactive, retry the request later or close the order.
 
RefundTransaction API errors
The following errors can produce error code 10009:
  • You don't have a verified Automated Clearing House (ACH).
  • 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.
  • Because a complaint case exists on this transaction, only a refund of the full or full remaining amount of the transaction can be issued.
  • You exceeded the time limit to refund this transaction.
  • You can't issue a full refund after a partial refund.
  • Your account is locked or inactive.
  • The partial refund isn't in the same currency as the original transaction.
  • This transaction has already been fully refunded.
  • The account is restricted.
  • You can't refund this type of transaction.
  • You can't issue a partial refund of this transaction.
  • The account for the counterparty is locked or inactive.

All of the preceding issues result from your PayPal balance having insufficient funds to cover the amount of the refund. In addition, either you haven't yet verified the bank account associated with your PayPal account or you have no bank account associated with your PayPal account.

To resolve these issues, check that you have sufficient funds in your PayPal balance and that you've verified the associated bank account.
 
DoReferenceTransaction errors
Causes include the following:
  • The account for the counterparty is locked or inactive.
  • The merchant is locked, closed, or restricted.
 
AddressVerify API errors
  • The API is disabled.
  • The Address API is currently disabled.

For help resolving this issue or others, visit PayPal's Contact Customer Service page.


See also:
API rrror codes
We’re sorry, the page you’re looking for is no longer available. Please try your search again in our Help Center if you have a question or want to contact us.