Recurring Payments errors - 10001 to 15004

This table lists errors for the following APIs that handle recurring payments profiles:

  • CreateRecurringPaymentsProfile
  • GetRecurringPaymentsProfileDetails
  • ManageRecurringPaymentsProfileStatus
  • UpdateRecurringPaymentsProfile
  • BillOutstandingAmount
Error code Short and long messages User action
10001 Invalid account number
The transaction failed as a result of invalid credit card number. Check the number or attempt with another credit card.
To learn more about possible causes and corrective actions, see What is API error code 10001?.
10003 Missing argument
Item name, amount and quantity are required if item category is provided.
Scenario: Merchant passes item category as either Digital or Physical but does not also pass one of the following parameters: name, amount, or quantity.
10004 Transaction refused because of an invalid argument. See additional error messages for details.
You are not signed up to accept payment for digitally delivered goods.
Scenario: Merchant is not signed up for digital goods but passes item category as Digital.
10004 Cart item calculation mismatch.
Cart item calculation mismatch. The regular non-trial billing period amount is different than the sum of the amounts for each item in the cart.
Scenario: When the regular non-trial billing period amount is different than the sum of the amounts for each item in the cart.
10004 Tax calculation mismatch.
Tax calculation mismatch. The tax amount for the regular non-trial billing period is different than the sum of the tax for each item in the cart.
Scenario: When the tax for the regular non-trial billing period is different than the sum of the tax for each item in the cart.
10014 API call was rate limited.
The API call has been denied as it has exceeded the permissible call rate limit.
10215 (Warning) Soft Descriptor truncated
The soft descriptor passed in was truncated
10216 Confirmed address required
Transaction refused because a confirmed address is not available
10217 (Warning) Soft Descriptor City truncated
The SoftDescriptorCity field was truncated
10218 (Warning) Soft Descriptor modified
Illegal characters were removed from the SoftDescriptor field
10219 (Warning) Soft Descriptor City modified
Illegal characters were removed from the SoftDescriptorCity field
10220 (Warning) Soft Descriptor's ignored
The Merchant is not enabled to pass SoftDescriptor or SoftDescriptorCity
10478 Invalid Data
Recurring payments profile description must be provided if the billing agreement type is recurring payments.
10501 Invalid Configuration
This transaction cannot be processed due to an invalid merchant configuration.
Occurs when the billing agreement is disabled or inactive.
10502 Invalid Data
This transaction cannot be processed. Please use a valid credit card.
The credit card used is expired.
10505 Gateway Decline
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 Invalid Configuration
This transaction cannot be processed. Please contact PayPal Customer Service.
Your PayPal account is restricted. Contact PayPal for more information.
10508 Invalid Data
This transaction cannot be processed. Please enter a valid credit card expiration date.
The expiration date must be a two-digit month and four-digit year.
10509 Invalid Data
This transaction cannot be processed.
You must submit an IP address of the buyer with each API call.
10510 Invalid Data
The credit card type is not supported. Try another card type.
The credit card type entered is not currently supported by PayPal.
10511 Invalid Data
This transaction cannot be processed.
The merchant selected an value for the PaymentAction field that is not supported.
10512 Invalid Data
This transaction cannot be processed. Please enter a first name.
The first name of the buyer is required for this merchant.
10513 Invalid Data
This transaction cannot be processed. Please enter a last name.
The last name of the buyer is required for this merchant.
10527 Invalid Data
This transaction cannot be processed. Please enter a valid credit card number and type.
10535 Gateway decline
This transaction cannot be processed. Please enter a valid credit card number and type.
This error can also be returned if you pass an industry standard test credit card number in the Live environment.
10544 Gateway Decline
This transaction cannot be processed.
The transaction was declined by PayPal. Contact PayPal for more information.
10544 This transaction cannot be processed.
Please use a different payment card.
10548 Invalid Configuration
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.
10550 Invalid Configuration
This transaction cannot be processed.
Access to Direct Payment was disabled for your account. Contact PayPal for more information.
10561 Invalid Data
There's an error with this transaction. Please enter complete billing address.
10565 Merchant country unsupported
The merchant country is not supported.
10577 Gateway Decline.
This transaction cannot be processed. The merchant must not attempt payment on this card again for this buyer.
10709 Invalid Data
There's an error with this transaction. Please enter an address1 in the billing address.
There was a problem with a particular field in the address. The long error message tells you which field is invalid.
10710 Invalid Data
There's an error with this transaction. Please enter a city in the billing address.
There was a problem with a particular field in the address. The long error message tells you which field is invalid.
10711 Invalid Data
There's an error with this transaction. Please enter your state in the billing address.
There was a problem with a particular field in the address. The long error message tells you which field is invalid.
10712 Invalid Data
There's an error with this transaction. Please enter your five digit postal code in the billing address.
There was a problem with a particular field in the address. The long error message tells you which field is invalid.
10713 Invalid Data
There's an error with this transaction. Please enter a country in the billing address.
There was a problem with a particular field in the address. The long error message tells you which field is invalid.
10744 Invalid Data
This transaction cannot be processed. Please enter a valid country code in the billing address.
There was a problem with a particular field in the address. The long error message will tells you which field is invalid.
10748 Invalid Data
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.
10751 Invalid Data
There's an error with this transaction. Please enter a valid state in the billing address.
The merchant provided an address either in the United States or Canada, but the state provided is not a valid state in either country.
10752 Gateway Decline
This transaction cannot be processed.
The transaction was declined by the issuing bank, not PayPal. The merchant should attempt another card.
10760 Invalid Configuration
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.
11089 Transaction Refused.
Account is locked or inactive.
11501 Invalid merchant country
The merchant's country is currently not supported
Missing token
11502 The token is missing or is invalid
The token is missing or is invalid
One or more subscription detail fields are missing from the request.
11503 Missing subscription details
Missing subscription details
One or more schedule detail fields are missing from the request.
11504 Missing schedule details
Missing schedule details
11505 Start date should be greater than current date
Subscription start date should be greater than current date
11506 Invalid max failed payments
Max failed payments, if supplied, must be >= 0
11507 Invalid trial amount
Trial amount must be >= 0
11508 Invalid trial total billing cycles
Trial total billing cycles must be > 0
11509 Invalid trial billing period
Trial billing period must be one of Day, Week, Month, SemiMonth, or Year
11510 Invalid trial amount
Trial amount must be >= 0
11511 Invalid currency for trial amount
This currency is currently not supported for trial amount.
Currency must be USD.
11512 Invalid trial shipping amount
Trial shipping amount must be >= 0
If a trial shipping amount is supplied, it must be >= 0.
11513 Invalid currency for trial shipping amount
This currency is currently not supported for trial shipping amount
Currency must be USD.
11514 Invalid profile status
The profile status is invalid.
11515 Invalid currency for trial tax amount
This currency is currently not supported for trial tax amount
Currency must be USD.
11516 Invalid billing frequency
Billing Frequency must be > 0 and be less than or equal to one year
The combination of billing frequency and billing period cannot exceed one year.
11517 Invalid total billing cycles
Total billing cycles must be >= 0 (0 means continuous)
11518 Invalid billing period
Billing period must be one of Day, Week, Month, SemiMonth, or Year
11519 Invalid amount
Bill amount must be greater than 0
11520 Invalid currency for amount
This currency is currently not supported for amount
Currency must be USD.
11521 Invalid shipping amount
Shipping amount must be >= 0
11522 Invalid currency for shipping amount
This currency is currently not supported for shipping amount
Currency must be USD.
11523 Invalid tax amount
Tax amount must be >= 0
11524 Invalid currency for tax amount
This currency is currently not supported for tax amount
Currency must be USD.
11531 Invalid profile status
The profile status must be one of (A)ctive, (C)ancelled, or e(X)pired
11543 Invalid payer country
The payer's country is currently not supported
11544 Invalid period status
The trial period status must be one of (A)ctive or (C)ancelled
11545 Denied
Payer's account is denied
11546 Denied
Merchant account is denied
11547 This feature is not available at this time
Recurring payments feature is not currently available; try again later
11548 Invalid currency code
Invalid currency code, all currency codes much match
11549 Start Date is required
Subscription start date is required
11550 Start Date should be valid
Subscription start date should be valid
11551 Profile ID is missing from the request
Profile ID is missing from the request
11552 Invalid profile ID
The profile ID is invalid
11553 Invalid action value provided
Invalid action value provided
11554 Note is missing from the request
Note is missing from the request
11555 Note length is too long
Note length is too long
11556 Invalid profile status for cancel action; profile should be active or suspended
Invalid profile status for suspend action; profile should be active
11557 Invalid profile status for suspend action; profile should be active
Invalid profile status for reactivate action; profile should be suspended
11558 Invalid profile status for reactivate action; profile should be suspended
The activation type is invalid
11560 Invalid activation type
The activation type is invalid
11561 Invalid initial amount
The initial amount is invalid
11562 Invalid auto bill type
The auto bill type is invalid
11564 The number of failed payments should be greater than the current number of failed payments
The number of failed payments should be greater than the current number of failed payments
11567 The time of the update is too close to the billing date
The time of the update is too close to the billing date
11568 Invalid currency for delinquent amount
Invalid currency for delinquent amount
11569 Cannot increase delinquent amount
Cannot increase delinquent amount
11570 The maximum number of failed payments should be greater than the current number of failed payments
The maximum number of failed payments should be greater than the current number of failed payments
11571 The total amount cannot exceed 120% increment per 180 days
The total amount cannot exceed 120% increment per 180 days
11576 Bill amount is greater than outstanding balance
Bill amount is greater than outstanding balance
11577 Another outstanding payment is scheduled
Another outstanding payment is scheduled
11578 Bill outstanding amount not processed because of scheduled payment
Recurring payment scheduled within 24 hours, so we are not processing the bill outstanding amount
11579 Payment is failing
Payment is failing
11581 Invalid Data
Profile description is invalid.
11582 No payment in queue
No scheduled payment has been found.
11583 DPRP feature is unavailable
DPRP feature is unavailable
11584 Inactive profile
Profile is not active
11585 Missing Token or buyer credit card
Missing token or payment source
11586 DPRP is disabled
DPRP is disabled for this merchant.
11587 Billing Address is Partial
Billing Address is Partial
11590 Profile update is not required
Based on your input request, profile already up to date.
11592 Subscription profiles are not supported for recurring payments
Subscription profiles are not supported for recurring payments
11607 Duplicate request for specified Message Submission ID.
The specified Message Submission ID (specified in MSGSUBID parameter) is a duplicate; result parameters of the original request are attached.
13122 Transaction refused
This transaction cannot be completed because it violates the PayPal User Agreement.
13701 Invalid Data
Item Category value is invalid. Only Digital or Physical are allowed.
Scenario: When merchant passes an item category value other than Digital or Physical.
15004 Gateway Decline
This transaction cannot be processed. Please enter a valid Credit Card Verification Number.

Additional information

  • API error codes
  • CreateRecurringPaymentsProfile API Operation (NVP, SOAP)
  • GetRecurringPaymentsProfileDetails API Operation (NVP, SOAP)
  • ManageRecurringPaymentsProfileStatus API Operation (NVP, SOAP)
  • UpdateRecurringPaymentsProfile API Operation (NVP, SOAP)
  • BillOutstandingAmount API Operation (NVP, SOAP)