Understanding PayPal Website Payments Pro error messages

created

If you use PayPal Website Payments Pro and you or a site visitor attempting to make a payment an error when attempting to make payment that begins "Error:" followed by a five digit code in parenthesis, this is an error generated by PayPal itself.

Below is a list of common error codes and their meaning. For a full list, refer to PayPal's documentation.

Consult the list to determine what the error means. If it is related to aspects of your PayPal account including payment status or account verification, please login to your PayPal account to investigate and resolve the issue. If you are uncertain the nature of the error, feel free to contact us and provide as much detail as you can regarding the 1) page on your site the transaction was taking place; 2) the details of the transaction; and 3) the outcome including the specific error message and code.

Error Code Message Notes
10002 Username/Password is incorrect This error can be caused by an incorrect API username, an incorrect API password, or an invalid API signature. Make sure that all three of these values are correct. For your security, PayPal does not report exactly which of these three values might be in error.
  You do not have permissions to make this API call  
  Account is locked or inactive  
  Account is not verified  
  This call is not defined in the database!  
  Token is not valid  
  Account is restricted Your PayPal merchant account has been restricted. Contact your PayPal account manager for resolution.
  Token is not valid  
  API access is disabled for this account  
  Client certificate is disabled  
  Account is restricted  
10500 This transaction cannot be processed due to an invalid merchant configuration. Occurs when you have not agreed to the billing agreement.
10501 This transaction cannot be processed due to an invalid merchant configuration. Occurs when the billing agreement is disabled or inactive.
10505 This transaction cannot be processed. The transaction was refused because the AVS response returned the value of N, and the merchant account is not able to accept such transactions.
10507 This transaction cannot be processed. Please contact PayPal Customer Service. Your PayPal account is restricted - contact PayPal for more information.
10537 This transaction cannot be processed. The transaction was declined by the country filter managed by the merchant. To accept this transaction, change your risk settings on PayPal.
10538 This transaction cannot be processed. The transaction was declined by the maximum amount filter managed by the merchant. To accept this transaction, change your risk settings on PayPal.
10539 This transaction cannot be processed. The transaction was declined by PayPal. Contact PayPal for more information.
10548 This transaction cannot be processed. The merchant's account is not able to process transactions. The merchant account attempting the transaction is not a business account at PayPal. Check your account settings.
10549 This transaction cannot be processed. The merchant's account is not able to process transactions. The merchant account attempting the transaction is not able to process Direct Payment transactions. Contact PayPal for more information.
10550 This transaction cannot be processed Access to Direct Payment was disabled for your account. Contact PayPal for more information.
10552 This transaction cannot be processed The merchant account attempting the transaction does not have a confirmed email address with PayPal. Check your account settings.
10553 This transaction cannot be processed The merchant attempted a transaction where the amount exceeded the upper limit for that merchant.
10554 This transaction cannot be processed The transaction was declined because of a merchant risk filter for AVS. Specifically, the merchant has set to decline transaction when the AVS returned a no match (AVS = N).
10555 This transaction cannot be processed The transaction was declined because of a merchant risk filter for AVS. Specifically, the merchant has set to decline transaction when the AVS returned a partial match.
10556 This transaction cannot be processed The transaction was declined because of a merchant risk filter for AVS. Specifically, the merchant has set to decline transaction when the AVS was unsupported.
10748 This transaction cannot be processed without a Credit Card Verification Number. The merchant's configuration requires a CVV to be entered, but no CVV was provided with this transaction. Contact PayPal if you wish to change this setting.
10755 This transaction cannot be processed due to an unsupported currency. The currency code entered by the merchant is not supported.
10758 There's been an error due to invalid API username and/or password. The API username or password is incorrect for this merchant
10760 This transaction cannot be processed. The country listed for your business address is not currently supported. The merchant's country of residence listed in their PayPal account is not currently supported to allow Direct Payment transactions.
15003 This transaction cannot be processed The transaction was declined because the merchant does not have a valid commercial entity agreement on file with PayPal. Contact PayPal for more information.
10007 Permission denied You do not have permissions to make this API call
10402 Authorization only is not allowed for merchant. This merchant account is not permitted to set PaymentAction to Authorization. Please contact Customer Service.
10425 Express Checkout has been disabled for this merchant. Express Checkout has been disabled for this merchant. Please contact Customer Service.
10537 Risk Control Country Filter Failure The transaction was refused because the country was prohibited as a result of your Country Monitor Risk Control Settings.
10538 Risk Control Max Amount Failure The transaction was refused because the maximum amount was excceeded as a result of our Maximum Amount Risk Control Settings.
10539 Payment declined by your Risk Controls settings: PayPal Risk Model. Payment declined by your Risk Controls settings: PayPal Risk Model.
10007 Permission denied You do not have permissions to make this API call
    You do not have permission to get the details of this transaction
10406 Transaction refused because of an invalid argument. See additional error messages for details. The PayerID value is invalid.
10419 Express Checkout PayerID is missing. Express Checkout PayerID is missing.
10539 Payment declined by your Risk Controls settings: PayPal Risk Model. Payment declined by your Risk Controls settings: PayPal Risk Model.
10009 The account for the counterparty is locked or inactive Merchant is locked/close/restricted
10201 Billing Agreement was cancelled Billing agreement is not active
10204 User's account is closed or restricted  
10205 Transaction refused due to risk model  
10211 Invalid MP ID  
10212 A profile preference is set to automatically deny certain transactions  
10402 This merchant account is not permitted to set PaymentAction? to Authorization. Please contact Customer Service. Merchant is not eligible for auth settlement
10537 The transaction was refused because the country was prohibited as a result of your Country Monitor Risk Control Settings. Transaction refused due to country monitor risk control
10538 The transaction was refused because the maximum amount was excused as a result of your Maximum Amount Risk Control Settings. Transaction refused due to max amount risk control
10539 Payment declined by your Risk Controls settings: PayPal Risk Model. Transaction declined by Risk Control settings: PayPal Risk model
10546 This transaction cannot be processed. IP fraud models failed.
10600 Authorization voided.  
10752 Transaction cannot be processed. Please use a different payment card. The transaction was declined by the issuing bank, not PayPal. The merchant should attempt another card. One possible cause for this error is your business category is not allowed by American Express.
10755 Unsupported Currency. This transaction cannot be processed due to an unsupported currency.
11586 DPRP is disabled. DPRP is disabled for this merchant.

See Why do visitors see "Payment Error: (11586) - DPRP is disabled. - DPRP is disabled for this merchant."? for more details

 

Have more questions? Submit a request
Article is closed for comments.