https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_api_nvp_errorcodes
Table 1. General API Errors
Error Code
Short Message
Long Message
Correcting This Error
10002
Authentication/Authorization Failed
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.
10002
Authentication/Authorization Failed
You do not have permission to make this API call
10002
Authentication/Authorization Failed
Account is locked or inactive
10002
Internal Error
Internal Error
10002
Authentication/Authorization Failed
Internal Error
10002
Authentication/Authorization Failed
Account is not verified
10002
Authentication/Authorization Failed
This call is not defined in the database!
10002
Authentication/Authorization Failed
Token is not valid
10002
Restricted account
Account is restricted
Your PayPal merchant account has been restricted. Contact your PayPal account manager for resolution.
10002
Authentication/Authorization Failed
API access is disabled for this account
10002
Authentication/Authorization Failed
Client certificate is disabled
10006
Version error
Version is not supported
10008
Security error
Security header is not valid
10101
This API Temporarily Unavailable
This API is temporarily unavailable. Please try later.
Validation Errors
Table 2. Validation Errors
Error Code
Short Message
Long Message
81000
Missing Parameter
Required Parameter Missing : Unable to identify parameter
81001
Invalid Parameter
A Parameter is Invalid : Unable to identify parameter
81002
Unspecified Method
Method Specified is not Supported
81003
Unspecified Method
No Method Specified
81004
Unspecified Method
No Request Received
81100
Missing Parameter
OrderTotal (Amt) : Required parameter missing
81101
Missing Parameter
MaxAmt : Required parameter missing
81102
Missing Parameter
ReturnURL: Required parameter missing
81103
Missing Parameter
NotifyURL : Required parameter missing
81104
Missing Parameter
CancelURL : Required parameter missing
81105
Missing Parameter
ShipToStreet : Required parameter missing
81106
Missing Parameter
ShipToStreet2 : Required parameter missing
81107
Missing Parameter
ShipToCity : Required parameter missing
81108
Missing Parameter
ShipToState : Required parameter missing
81109
Missing Parameter
ShipToZip : Required parameter missing
81110
Missing Parameter
Country : Required parameter missing
81111
Missing Parameter
ReqConfirmShipping : Required parameter missing
81112
Missing Parameter
NoShipping : Required parameter missing
81113
Missing Parameter
AddrOverride : Required parameter missing
81114
Missing Parameter
LocaleCode : Required parameter missing
81115
Missing Parameter
PaymentAction : Required parameter missing
81116
Missing Parameter
Email : Required parameter missing
81117
Missing Parameter
Token : Required parameter missing
81118
Missing Parameter
PayerID : Required parameter missing
81119
Missing Parameter
ItemAmt : Required parameter missing
81120
Missing Parameter
ShippingAmt : Required parameter missing
81121
Missing Parameter
HandlingAmt : Required parameter missing
81122
Missing Parameter
TaxAmt : Required parameter missing
81123
Missing Parameter
IPAddress : Required parameter missing
81124
Missing Parameter
ShipToName : Required parameter missing
81125
Missing Parameter
L_Amt : Required parameter missing
81126
Missing Parameter
Amt : Required parameter missing
81127
Missing Parameter
L_TaxAmt : Required parameter missing
81128
Missing Parameter
AuthorizationID : Required parameter missing
81129
Missing Parameter
CompleteType : Required parameter missing
81130
Missing Parameter
CurrencyCode : Required parameter missing
81131
Missing Parameter
TransactionID : Required parameter missing
81132
Missing Parameter
TransactionEntity : Required parameter missing
81133
Missing Parameter
Acct : Required parameter missing
81134
Missing Parameter
ExpDate : Required parameter missing
81135
Missing Parameter
FirstName : Required parameter missing
81136
Missing Parameter
LastName : Required parameter missing
81137
Missing Parameter
Street : Required parameter missing
81138
Missing Parameter
Street2 : Required parameter missing
81139
Missing Parameter
City : Required parameter missing
81140
Missing Parameter
State : Required parameter missing
81141
Missing Parameter
Zip : Required parameter missing
81142
Missing Parameter
CountryCode : Required parameter missing
81143
Missing Parameter
RefundType : Required parameter missing
81144
Missing Parameter
StartDate : Required parameter missing
81145
Missing Parameter
EndDate : Required parameter missing
81146
Missing Parameter
MPID : Required parameter missing
81147
Missing Parameter
CreditCardType : Required parameter missing
81148
Missing Parameter
User : Required parameter missing
81149
Missing Parameter
Pwd : Required parameter missing
81150
Missing Parameter
Version : Required parameter missing
81200
Missing Parameter
Amt : Invalid parameter
81201
Invalid Parameter
MaxAmt : Invalid parameter
81203
Invalid Parameter
NotifyURL : Invalid parameter
81205
Invalid Parameter
ShipToStreet : Invalid parameter
81206
Invalid Parameter
ShipToStreet2 : Invalid parameter
81207
Invalid Parameter
ShipToCity : Invalid parameter
81208
Invalid Parameter
ShipToState : Invalid parameter
81209
Invalid Parameter
ShipToZip : Invalid parameter
81210
Invalid Parameter
Country : Invalid parameter
81211
Invalid Parameter
ReqConfirmShipping : Invalid parameter
81212
Invalid Parameter
Noshipping : Invalid parameter
81213
Invalid Parameter
AddrOverride : Invalid parameter
81214
Invalid Parameter
LocaleCode : Invalid parameter
81215
Invalid Parameter
PaymentAction : Invalid parameter
81219
Invalid Parameter
ItemAmt : Invalid parameter
81220
Invalid Parameter
ShippingAmt : Invalid parameter
81221
Invalid Parameter
HandlingTotal Amt : Invalid parameter
81222
Invalid Parameter
TaxAmt : Invalid parameter
81223
Invalid Parameter
IPAddress : Invalid parameter
81224
Invalid Parameter
ShipToName : Invalid parameter
81225
Invalid Parameter
L_Amt : Invalid parameter
81226
Invalid Parameter
Amt : Invalid parameter
81227
Invalid Parameter
L_TaxAmt : Invalid parameter
81229
Invalid Parameter
CompleteType : Invalid parameter
81230
Invalid Parameter
CurrencyCode : Invalid parameter
81232
Invalid Parameter
TransactionEntity : Invalid parameter
81234
Invalid Parameter
ExpDate : Invalid parameter
81235
Invalid Parameter
FirstName : Invalid parameter
81236
Invalid Parameter
LastName : Invalid parameter
81237
Invalid Parameter
Street : Invalid parameter
81238
Invalid Parameter
Street2 : Invalid parameter
81239
Invalid Parameter
City : Invalid parameter
81243
Invalid Parameter
RefundType : Invalid parameter
81244
Invalid Parameter
StartDate : Invalid parameter
81245
Invalid Parameter
EndDate : Invalid parameter
81247
Invalid Parameter
CreditCardType : Invalid parameter
81248
Invalid Parameter
Username : Invalid parameter
81249
Invalid Parameter
Password : Invalid parameter
81250
Invalid Parameter
Version : Invalid parameter
81251
Internal Error
Internal Service Error
99998
Transaction refused because of an invalid argument. See additional error messages for details.
Currency is not supported
DirectPayment API Errors
Table 3. DirectPayment API Errors
Error Code
Short Message
Long Message
Corrective Action
10102
PaymentAction of Order Temporarily Unavailable
PaymentAction of Order is temporarily unavailable. Please try later or use other PaymentAction.
10401
Transaction refused because of an invalid argument. See additional error messages for details.
Order total is missing.
10418
Transaction refused because of an invalid argument. See additional error messages for details.
The currencies of the shopping cart amounts must be the same.
10426
Transaction refused because of an invalid argument. See additional error messages for details.
Item total is invalid.
10427
Transaction refused because of an invalid argument. See additional error messages for details.
Shipping total is invalid.
10428
Transaction refused because of an invalid argument. See additional error messages for details.
Handling total is invalid.
10429
Transaction refused because of an invalid argument. See additional error messages for details.
Tax total is invalid.
10432
Invalid argument
Invoice ID value exceeds maximum allowable length.
10500
Invalid Configuration
This transaction cannot be processed due to an invalid merchant configuration.
Occurs when you have not agreed to the billing agreement.
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.
10504
Invalid Data
This transaction cannot be processed. Please enter a valid Credit Card Verification Number.
The CVV provided is invalid. The CVV is between 3-4 digits long.
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 a 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.
10519
Invalid Data
Please enter a credit card.
The credit card field was blank.
10520
Invalid Data
This transaction cannot be processed.
The total amount and item amounts do not match.
10521
Invalid Data
This transaction cannot be processed. Please enter a valid credit card.
The credit card entered is invalid.
10523
Internal Error
This transaction cannot be processed.
None - this is a PayPal internal error.
10525
Invalid Data
This transaction cannot be processed. The amount to be charged is zero.
The merchant entered a amount of zero.
10526
Invalid Data
This transaction cannot be processed. The currency is not supported at this time.
The currency code entered is not supported.
10527
Invalid Data
This transaction cannot be processed. Please enter a valid credit card number and type.
The credit card entered is invalid.
10534
Gateway Decline
This transaction cannot be processed. Please enter a valid credit card number and type.
The credit card entered is currently restricted by PayPal. Contact PayPal for more information.
10535
Gateway Decline
This transaction cannot be processed. Please enter a valid credit card number and type.
The credit card entered is invalid.
10536
Invalid Data
This transaction cannot be processed.
The merchant entered an invoice ID that is already associated with a transaction by the same merchant. By default, the invoice ID must be unique for all transactions. To change this setting, log into PayPal or contact customer service.
10537
Filter Decline
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
Filter Decline
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
Filter Decline
This transaction cannot be processed.
The transaction was declined by PayPal. Contact PayPal for more information.
10540
Invalid Data
The transaction cannot be processed due to an invalid address.
The transaction was declined by PayPal because of an invalid address.
10541
Gateway Decline
This transaction cannot be processed. Please enter a valid credit card number and type.
The credit card entered is currently restricted by PayPal. Contact PayPal for more information.
10542
Invalid Data
This transaction cannot be processed. Please enter a valid email address.
The email address provided by the buyer is in an invalid format.
10544
Gateway Decline
This transaction cannot be processed.
The transaction was declined by PayPal. Contact PayPal for more information.
10545
Gateway Decline
This transaction cannot be processed.
The transaction was declined by PayPal because of possible fraudulent activity. Contact PayPal for more information.
10546
Gateway Decline
This transaction cannot be processed.
The transaction was declined by PayPal because of possible fraudulent activity on the IP address. Contact PayPal for more information.
10547
Internal Error
This transaction cannot be processed.
None - this is a PayPal internal error.
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.
10549
Invalid Configuration
This transaction cannot be processed. The merchan’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
Invalid Configuration
This transaction cannot be processed.
Access to Direct Payment was disabled for your account. Contact PayPal for more information.
10552
Invalid Configuration
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
Gateway Decline
This transaction cannot be processed.
The merchant attempted a transaction where the amount exceeded the upper limit for that merchant.
10554
Filter Decline
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
Filter Decline
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
Filter Decline
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.
10561
Invalid Data
There’s an error with this transaction. Please enter complete billing address.
10562
Invalid Data
This transaction cannot be processed. Please enter a valid credit card expiration year.
10563
Invalid Data
This transaction cannot be processed. Please enter a valid credit card expiration month.
10564
Gateway Decline
This transaction cannot be processed.
There was a problem processing this transaction.
10565
Merchant country unsupported
The merchant country is not supported.
10566
Credit card type unsupported
The credit card type is not supported.
10567
Invalid Data
This transaction cannot be processed. Please enter a valid credit card number and type.
10571
Transaction approved, but with invalid Card Security Code (CSC) format.
This transaction was approved, although the Card Security Code (CSC) had too few, too many, or invalid characters. Based on your account profile settings, the invalid CSC was not given to the card issuer for its approval process.
If you want to require valid CVV values, change the risk control settings in your account profile.
10701
Invalid Data
There’s an error with this transaction. Please enter a valid billing address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10702
Invalid Data
There’s an error with this transaction. Please enter a valid address1 in the billing address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10703
Invalid Data
There’s an error with this transaction. Please enter a valid address2 in the billing address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10704
Invalid Data
There’s an error with this transaction. Please enter a valid city in the billing address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10705
Invalid Data
There’s an error with this transaction. Please enter a valid state in the billing address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10706
Invalid Data
There’s an error with this transaction. Please enter a valid postal code in the billing address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10707
Invalid Data
There’s an error with this transaction. Please enter a valid country in the billing address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10708
Invalid Data
There’s an error with this transaction. Please enter a complete billing address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
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 will tell you what field is invalid.
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 will tell you what 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 will tell you what 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 will tell you what 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 will tell you what 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 will tell you what 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 will tell you what 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 will tell you what field is invalid.
10714
Invalid Data
There’s an error with this transaction. Please enter a valid billing address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10715
Invalid Data
There’s an error with this transaction. Please enter a valid state in the billing address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10716
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 will tell you what field is invalid.
10717
Invalid Data
There’s an error with this transaction. Please enter a valid postal code in the billing address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10718
Invalid Data
There’s an error with this transaction. Please enter a valid city and state in the billing address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10719
Invalid Data
There’s an error with this transaction. Please enter a valid shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10720
Invalid Data
There’s an error with this transaction. Please enter a valid address1 in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10721
Invalid Data
There’s an error with this transaction. Please enter a valid address2 in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10722
Invalid Data
There’s an error with this transaction. Please enter a valid city in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10723
Invalid Data
There’s an error with this transaction. Please enter a valid state in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10724
Invalid Data
There’s an error with this transaction. Please enter your five digit postal code in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10725
Invalid Data
There’s an error with this transaction. Please enter a valid country in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10726
Invalid Data
There’s an error with this transaction. Please enter a complete shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10726
Invalid Data
There’s an error with this transaction. Please enter a complete shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10727
Invalid Data
There’s an error with this transaction. Please enter an address1 in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10727
Invalid Data
There’s an error with this transaction. Please enter an address1 in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10728
Invalid Data
There’s an error with this transaction. Please enter a city in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10728
Invalid Data
There’s an error with this transaction. Please enter a city in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10729
Invalid Data
There’s an error with this transaction. Please enter your state in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10730
Invalid Data
There’s an error with this transaction. Please enter your five digit postal code in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10731
Invalid Data
There’s an error with this transaction. Please enter a country in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10731
Invalid Data
There’s an error with this transaction. Please enter a country in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10732
Invalid Data
There’s an error with this transaction. Please enter a valid shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10733
Invalid Data
There’s an error with this transaction. Please enter a valid state in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10734
Invalid Data
There’s an error with this transaction. Please enter your five digit postal code in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10735
Invalid Data
There’s an error with this transaction. Please enter your five digit postal code in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10736
Invalid Data
There’s an error with this transaction. Please enter a valid city and state in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what 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 tell you what field is invalid.
10745
Invalid Data
This transaction cannot be processed. Please enter a valid country code in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10746
Invalid Data
This transaction cannot be processed. Please use a valid country on the billing address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
10747
Invalid Data
This transaction cannot be processed.
The merchant entered an IP address that was in an invalid format. The IP address must be in a format such as 123.456.123.456.
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.
10750
Invalid Data
There’s an error with this transaction. Please enter a valid state in the shipping address.
There was a problem with a particular field in the address. The long error message will tell you what field is invalid.
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.
10754
Gateway Decline
This transaction cannot be processed.
The transaction was declined by PayPal. Contact PayPal for more information.
10755
Invalid Data
This transaction cannot be processed due to an unsupported currency.
The currency code entered by the merchant is not supported.
10756
Gateway Decline
The transaction cannot be processed. The country and billing address associated with this credit card do not match.
None - this is a PayPal internal error.
10758
Invalid Configuration
There’s been an error due to invalid API username and/or password.
The API username or password is incorrect for this merchant.
10759
Gateway Decline
This transaction cannot be processed. Please enter a valid credit card number and type.
The transaction was declined by PayPal. Contact PayPal for more information.
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.
10761
Gateway Decline
This transaction cannot be processed. Please check the status of your first transaction before placing another order.
The transaction was declined because PayPal is currently processing a transaction by the same buyer for the same amount. Can occur when a buyer submits multiple, identical transactions in quick succession.
10762
Gateway Decline
This transaction cannot be processed.
The CVV provide is invalid. The CVV is between 3-4 digits long.
10763
Invalid Data
This transaction cannot be processed.
None - this is a PayPal internal error.
10764
This transaction cannot be processed at this time. Please try again later.
This transaction cannot be processed at this time. Please try again later.
The transaction was declined by PayPal. Please try again later. If the problem persists, please contact PayPal.
11610
Payment Pending your review in Fraud Management Filters
Payment Pending your review in Fraud Management Filters
11611
Transaction blocked by your settings in FMF
Transaction blocked by your settings in FMF
11612
Could not process your request to accept/deny the transaction
Could not process your request to accept/deny the transaction
11821
This transaction cannot be processed
This transaction cannot be processed because it has already been denied by a Fraud Management Filter
You cannot capture a payment after it has been denied by a Fraud Management Filter. You can control whether a Fraud Management Filter will deny a transaction by changing the filter's settings in the profile.
12000
Transaction is not compliant due to missing or invalid 3-D Secure authentication values.
Transaction is not compliant due to missing or invalid 3-D Secure authentication values.
Check ECI, ECI3DS, CAVV, XID fields.
12001
Transaction is not compliant due to missing or invalid 3-D Secure authentication values.
Transaction is not compliant due to missing or invalid 3-D Secure authentication values.
Check ECI, ECI3DS, CAVV, XID fields.
15001
Gateway Decline
This transaction cannot be processed.
The transaction was rejected by PayPal because of excessive failures over a short period of time for this credit card. Contact PayPal for more information.
15002
Gateway Decline
This transaction cannot be processed.
The transaction was declined by PayPal. Contact PayPal for more information.
15003
Invalid Configuration
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.
15004
Gateway Decline
This transaction cannot be processed. Please enter a valid Credit Card Verification Number.
The transaction was declined because the CVV entered does not match the credit card.
15005
Processor Decline
This transaction cannot be processed.
The transaction was declined by the issuing bank, not PayPal. The merchant should attempt another card.
15006
Processor Decline
This transaction cannot be processed. Please enter a valid credit card number and type.
The transaction was declined by the issuing bank, not PayPal. The merchant should attempt another card.
15007
Processor Decline
This transaction cannot be processed. Please use a valid credit card.
The transaction was declined by the issuing bank because of an expired credit card. The merchant should attempt another card.
15008
Invalid Data
This transaction has been completed, but the total of items in the cart did not match the total of all items.
SetExpressCheckout API Errors
Table 4. SetExpressCheckout API Errors
Error Code
Short Message
Long Message
Correcting This Error...
10001
ButtonSource value truncated.
The transaction could not be loaded
10001
Internal Error
Internal Error
10003
Missing argument.
OtherPaymentMethodID is missing.
10003
Missing argument.
OtherPaymentMethodLabel is missing.
10003
Missing argument.
OtherPaymentMethodType is missing.
10003
Missing argument.
One or more of these giropay URLs is missing: giropaySuccessURL, giropayCancelURL, BanktxnPendingURL.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Transaction refused because of an invalid argument. See additional error messages for details.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The transaction id is not valid
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid value for request billing address parameter.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid item URL.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
OtherPaymentMethodType is invalid.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
RegistrationDate of buyer is invalid.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay buyer feedback overall positive count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay buyer feedback overall negative count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay buyer feedback total positive count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay buyer feedback total negative count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay buyer feedback recent positive count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay buyer feedback recent negative count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
SellerRegistrationDate is invalid.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay seller feedback overall positive count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay seller feedback overall negative count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay seller feedback total positive count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay seller feedback total negative count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay seller feedback recent positive count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay seller feedback recent negative count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay item transaction date.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay item buyer protection type.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay item payment hold risk.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Multiple eBay order IDs not allowed.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
AllowPushFunding value specified is invalid. It must be 0 or 1 or an empty string.
10005
Option not supported.
Merchant not enabled to use enhanced checkout data.
10005
Option not supported.
Merchant not enabled to use OtherPaymentMethodDetails.
10005
Option not supported.
Transaction ID is not supported.
10007
Permission denied
You do not have permission to make this API call
10010
Invalid Invoice
Non-ASCII invoice id is not supported.
10101
Option not supported.
Express Checkout temporarily unavailable. Please try later.
10102
PaymentAction of Order Temporarily Unavailable
PaymentAction of Order is temporarily unavailable. Please try later or use other PaymentAction.
10103
Please use another Solution Type.
Your Solution Type is temporarily unavailable. If possible, please use another Solution Type.
10400
Transaction refused because of an invalid argument. See additional error messages for details.
OrderTotal is missing.
10401
Transaction refused because of an invalid argument. See additional error messages for details.
Order total is invalid.
10402
Authorization only is not allowed for merchant.
This merchant account is not permitted to set PaymentAction to Authorization. Please contact Customer Service.
10404
Transaction refused because of an invalid argument. See additional error messages for details.
ReturnURL is missing.
10405
Transaction refused because of an invalid argument. See additional error messages for details.
CancelURL is missing.
10407
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid buyer email address (BuyerEmail).
10409
You’re not authorized to access this info.
Express Checkout token was issued for a merchant account other than yours.
10410
Invalid token
Invalid token.
10411
This Express Checkout session has expired.
This Express Checkout session has expired. Token value is no longer valid.
If you receive this error, you must return your customer to PayPal to approve the use of PayPal again. Display an error message to inform the customer that the transaction expired, and provide a button to return to PayPal. In this situation, you are effectively restarting the entire checkout process. (Do not reuse the expired token value on SetExpressCheckout request.) However, because you already know the final OrderTotal, be sure to update the value for that element if appropriate. You might also want to update the values for ReturnURL and CancelURL, if necessary.
10412
Duplicate invoice
Payment has already been made for this InvoiceID.
PayPal checks that InvoiceID values are unique for any particular merchant. If you send an InvoiceID value already associated with another transaction in the PayPal system, PayPal returns error code 10412.
You might not be able to correct this error during an actual checkout. If you get this error, research why might occur and modify your implementation of Express Checkout to ensure that you generate unique invoice identification numbers.
10413
Transaction refused because of an invalid argument. See additional error messages for details
The totals of the cart item amounts do not match order amounts.
10415
Transaction refused because of an invalid argument. See additional error messages for details.
A successful transaction has already been completed for this token.
PayPal allows a token only once for a successful transaction.
Handling this error
If you determine that your customers are clicking your “Place Order” button twice, PayPal recommends that you disable the button after your customer has clicked it.
10418
Transaction refused because of an invalid argument. See additional error messages for details
The currencies of the shopping cart amounts must be the same.
10425
Express Checkout has been disabled for this merchant.
Express Checkout has been disabled for this merchant. Please contact Customer Service.
10426
Transaction refused because of an invalid argument. See additional error messages for details
Item total is invalid.
10427
Transaction refused because of an invalid argument. See additional error messages for details
Shipping total is invalid.
10428
Transaction refused because of an invalid argument. See additional error messages for details
Handling total is invalid.
10429
Transaction refused because of an invalid argument. See additional error messages for details
Tax total is invalid.
10430
Transaction refused because of an invalid argument. See additional error messages for details
Item amount is missing.
10431
Transaction refused because of an invalid argument. See additional error messages for details
Item amount is invalid.
10432
Transaction refused because of an invalid argument. See additional error messages for details
Invoice ID value exceeds maximum allowable length.
10433
Transaction refused because of an invalid argument. See additional error messages for details
Value of Order Description has been truncated.
10434
Transaction refused because of an invalid argument. See additional error messages for details
Value of Custom element has been truncated.
10436
Transaction refused because of an invalid argument. See additional error messages for details.
PageStyle value exceeds maximum allowable length.
10437
Transaction refused because of an invalid argument. See additional error messages for details.
cpp-header-image value exceeds maximum allowable length.
10438
Transaction refused because of an invalid argument. See additional error messages for details.
cpp-header-image value exceeds maximum allowable length.
10439
Transaction refused because of an invalid argument. See additional error messages for details.
cpp-header-image value exceeds maximum allowable length.
10440
Transaction refused because of an invalid argument. See additional error messages for details.
cpp-header-image value exceeds maximum allowable length.
10441
Transaction refused because of an invalid argument. See additional error messages for details
The NotifyURL element value exceeds maximum allowable length.
10442
ButtonSource value truncated.
The ButtonSource element value exceeds maximum allowable length.
10446
Transaction refused because of an invalid argument. See additional error messages for details.
Sale is only allowed PaymentAction.
10457
Error occurred in communicating to eBay
eBay API creation error
10458
Error occurred in communicating to eBay
eBay API unknown failure
10459
Error occurred in communicating to eBay
eBay API failure
10460
Error occurred in communicating to eBay
Parsing error
10461
Error occurred in communicating to eBay
Item number invalid, removed, or unavailable
10462
Error occurred in communicating to eBay
Order not found
10463
Error occurred in communicating to eBay
eBay user password incorrect
10464
Error occurred in communicating to eBay
Item ID and Transaction ID mismatch
10465
Error occurred in communicating to eBay
eBay user invalid
10467
Error occurred in communicating to eBay
Duplicate Item ID
10468
Transaction refused because of an invalid argument. See additional error messages for details
Duplicate Order ID
10469
PaymentAction of Order Temporarily Unavailable
Express Auctions is unavailable
10470
Wowo flag is off for ExpressO feature
Solution Type passed as Sole while ExpressO feature is turned off
10471
Transaction refused because of an invalid argument. See additional error messages for details
ReturnURL is missing
10472
Transaction refused because of an invalid argument. See additional error messages for details
CancelURL is missing
10473
Error occurred in communicating to eBay
Multiple Order IDs are not supported
10474
Invalid Data
This transaction cannot be processed. The country code in the shipping address must match the buyer's country of residence
10475
Transaction refused because of an invalid argument. See additional error messages for details
This transaction cannot be completed with PaymentAction of Sale
10476
Invalid Data
Maximum number of billing agreements exceeded
10477
Invalid Data
More than one billing agreement specified for reference transaction
10478
Invalid Data
Recurring payments profile description must be provided if the billing agreement type is recurring payments
10479
Invalid Data
Billing agreement types cannot be mixed in the same request
10480
Invalid Data
Invalid billing agreement type
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 your 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.
10725
Shipping Address Country Error
There was an error in the Shipping Address Country field
10727
Shipping Address1 Empty
The field Shipping Address1 is required
10728
Shipping Address City Empty
The field Shipping Address City is required
10729
Shipping Address State Empty
The field Shipping Address State is required
10730
Shipping Address Postal Code Empty
The field Shipping Address Postal Code is required
10731
Shipping Address Country Empty
The field Shipping Address Country is required
10736
Shipping Address Invalid City State Postal Code
A match of the Shipping Address City, State, and Postal Code failed.
10800
Invalid Data
Your request is too long. Check URLs and other long strings.
11001
Exceeds maximum length.
Value of NoteText element is truncated.
11001
Exceeds maximum length.
OtherPaymentMethodID exceeds maximum length.
11001
Exceeds maximum length.
OtherPaymentMethodLabel exceeds maximum length.
11001
Exceeds maximum length.
OtherPaymentMethodLabelDescription exceeds maximum length.
11001
Exceeds maximum length.
OtherPaymentMethodLongDescription exceeds maximum length.
11001
Exceeds maximum length.
OtherPaymentMethodLongDescriptionTitle exceeds maximum length.
11001
Exceeds maximum length.
OtherPaymentMethodIcon exceeds maximum length.
11547
Recurring payments temporarily unavailable; try again later
Recurring payments temporarily unavailable.
11601
Request for billing address failed
Billing address request is not enabled for merchant
11602
Request for billing address failed
Feature not yet available
11801
Invalid Data
You cannot pass both new and deprecated parameter address fields.
11802
Invalid Data
You cannot pass both the new and deprecated Custom parameter.
11803
Invalid Data
You cannot pass both the new and deprecated Invoice ID parameter.
11804
Invalid Data
You cannot pass both the new and deprecated order description.
11805
Invalid Data
You cannot pass both the new and deprecated order total or amount parameters.
11806
Invalid Data
You cannot pass both the new and deprecated ProfileAddressChangeDate parameter.
11807
Invalid Data
You cannot pass both the new and deprecated ShippingMethod parameter.
11810
Transaction refused because of an invalid argument. See additional error messages for details
Invalid Insurance Amount.
11811
Transaction refused because of an invalid argument. See additional error messages for details
Invalid Shipping Discount.
11812
Invalid Data
The value of Description parameter has been truncated.
11813
Transaction refused because of an invalid argument. See additional error messages for details
Invalid callback URL.
Callback URL is wrong type
Callback URL is wrong type; you must use the HTTPS
Ensure that your callback URL starts with https://.
11814
Invalid data
Invalid value for AllowNote.
11813
Callback URL not valid or longer than 1024 chars.
Invalid callback URL
11815
Transaction refused because of an invalid argument. See additional error messages for details
Item sales tax is invalid.
Callback options missing
You must specify callback options when you specify a callback URL
Invalid callback timeout
The callback timeout is is zero; you must specify a longer timeout
Line items missing
Line items are required when specify a callback URL for flate rate shipping options
Callback URL is too long
The callback URL must not exceed 1,024 characters
Multiple default shipping options specified
You can only specify one default shipping option at a time
No default shipping option specified
You must specify a default shipping option
Invalid shipping total
Invalid shipping total; it should equal the shipping amount of the default shipping option
Invalid shipping options
Invalid shipping options; you must specify a name and amount for each shipping option
11821
Invalid shipping options
Invalid shipping options; you must specify a name and amount for each shipping option type
11822
Multiple default shipping options specified
More than one shipping option type is marked as the default; you can only specify one default shipping option at a time
11823
No default shipping option specified
You must specify one shipping option type as the default
11824
Invalid callback timeout
The callback timeout is zero; you must specify a longer timeout value
11825
Flat-rate shipping options are missing
Flat-rate shipping options are missing; you must specify flat-rate shipping options when you specify a callback URL
11826
Invalid shipping total
Invalid shipping total; it should equal the shipping amount of the selected shipping option
11827
Line items missing
Line items missing; line items are required when you specify a callback URL for flat-rate shipping options
11828
Maximum amount of order not specified
Maximum amount of order not specified; you must specify the estimated value of the order when using a flat-rate shipping option
11829
Shipping total is missing
Shipping total is missing; you must specify a shipping total when using a flat-rate shipping option
11830
Insurance amount is missing
Insurance amount is missing; you have offered insurance but have not specified an amount.
11831
Callback URL is too long
Callback URL is too long; it must not exceed 1,024 characters
11832
Maximum amount of order is less than itemized amounts
Maximum amount of order is less than itemized amounts; the value of all items, including handling, shipping, tax, and insurance cannot be greater than the maximum amount of the order
12109
Option not supported.
Seller blocks payments via eBay checkout for all eBay items.
12124
Option not supported.
Express Checkout not supported for you.
12200
Buyer ID is not present.
Buyer ID must be specified to process an Immediate Payment item.
12201
Immediate Payment item was not found.
The item specified is either not valid or is not currently available for purchase as an Immediate Payment item.
Please check that the item is a valid Immediate Payment item.
12202
More than one eBay item is present.
Only one Immediate Payment item can be paid for in a single PayPal payment transaction.
12205
eBay Transaction ID and eBay Order ID must be null.
Requests for eBay Immediate Payment items should not contain either eBay transaction ID or eBay order ID. If the fields are present, they should contain null values.
12207
Cart ID is required for Immediate Payment item.
Cart ID is required for Immediate Payment item.
12208
eBay item amount does not match Express Checkout API item amount.
eBay item amount must match Express Checkout API item amount.
13100
Parallel payments functionality is not available
Parallel payments functionality is not available
13101
Invalid Data
Payment action of Order is only supported for parallel payments
13102
Payment Request ID is missing
Payment Request ID is mandatory for parallel payments
13103
Duplicate Payment Request ID passed
Payment Request ID must be unique for parallel payments
13104
Transaction refused because of an invalid argument. See Additional error messages for details.
Number of payment requests exceeds maximum number of supported requests.
13105
Invalid Data
Billing Agreement is not supported for parallel payments.
13106
Invalid Data
You cannot pass both the new and deprecated PaymentAction parameter.
13108
Merchant is not eligible.
Merchant is not eligible for parallel payments.
13110
Multi Payments Sale is Not allowed
Due to some technical diffculties the Multi Payments for Sale is not avaliable now please try again later.
13111
Mixed Payment action not supported
The Payment Action passed should be unique, mixed Payment Action not supported
13114
Buyer Didn't Complete
The Buyer returned without completing the payment
13115
Seller ID Missing
Seller ID is mandatory for parallel payments
13116
Transaction refused because of an invalid argument. See additional error messages for details.
The transaction is in progress for this token.
GetExpressCheckoutDetails API Errors
Table 5. GetExpressCheckoutDetails API Errors
Error Code
Short Message
Long Message
Correcting This Error...
10001
Internal Error
Internal Error
10001
Internal Error
Transaction failed due to internal error
10001
ButtonSource value truncated.
The transaction could not be loaded
10001
ButtonSource value truncated.
The transaction could not be loaded
10003
Missing argument.
OtherPaymentMethodID is missing.
10003
Missing argument.
OtherPaymentMethodLabel is missing.
10003
Missing argument.
OtherPaymentMethodType is missing.
10003
Missing argument.
One or more of these giropay URLs is missing: giropaySuccessURL, giropayCancelURL, BanktxnPendingURL.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Transaction refused because of an invalid argument. See additional error messages for details.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The transaction id is not valid
10004
Invalid transaction type
You can not get the details for this type of transaction
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The transaction could not be loaded
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The transaction id is not valid
10007
Permission denied
You do not have permission to make this API call
10007
Permission denied
You do not have permission to get the details of this transaction
10007
Permission denied
You do not have permission to make this API call
10408
Express Checkout token is missing.
Express Checkout token is missing.
10409
You’re not authorized to access this info.
Express Checkout token was issued for a merchant account other than yours.
10410
Invalid token
Invalid token.
10411
This Express Checkout session has expired.
This Express Checkout session has expired. Token value is no longer valid.
13112
Cannot Pay Seller.
The Buyer will not be able to Pay the seller for this transaction
13113
Buyer Cannot Pay.
The Buyer cannot pay with PayPal for this transaction.
13116
Transaction refused because of an invalid argument. See additional error messages for details.
The transaction is in progress for this token.
DoExpressCheckoutPayment API Errors
Table 6. DoExpressCheckoutPayment API Errors
Error Code
Short Message
Long Message
Correcting This Error...
10001
Internal Error
Transaction failed due to internal error
10001
Internal Error
Warning an internal error has occurred. The transaction id may not be correct
10001
ButtonSource value truncated.
The transaction could not be loaded
10001
Internal Error
Internal Error
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Transaction refused because of an invalid argument. See additional error messages for details.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The transaction id is not valid
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid item URL.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
SellerRegistrationDate is invalid.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay seller feedback overall positive count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay seller feedback overall negative count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay seller feedback total positive count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay seller feedback total negative count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay seller feedback recent positive count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay seller feedback recent negative count.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay item transaction date.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay item buyer protection type.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid eBay item payment hold risk.
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Multiple eBay order IDs not allowed.
10007
Permission denied
You do not have permissions to make this API call
10406
Transaction refused because of an invalid argument. See additional error messages for details.
The PayerID value is invalid.
10408
Express Checkout token is missing.
Express Checkout token is missing.
10409
You’re not authorized to access this info.
Express Checkout token was issued for a merchant account other than yours.
10410
Invalid token
Invalid token.
10411
This Express Checkout session has expired.
This Express Checkout session has expired. Token value is no longer valid.
10412
Duplicate invoice
Payment has already been made for this InvoiceID.
10413
Transaction refused because of an invalid argument. See additional error messages for details.
The totals of the cart item amounts do not match order amounts.
*
ItemTotal
*
ShippingTotal
*
HandlingTotal
*
TaxTotal
If you get this error, research why it might have occurred and modify your implementation of Express Checkout to ensure proper addition of the values. For the rules of this calculation, see the PayPal Express Checkout Integration Guide.
10414
Transaction refused because of an invalid argument. See additional error messages for details.
The amount exceeds the maximum amount for a single transaction.
10415
Transaction refused because of an invalid argument. See additional error messages for details.
A successful transaction has already been completed for this token.
10416
Transaction refused because of an invalid argument. See additional error messages for details.
You have exceeded the maximum number of payment attempts for this token.
10417
Transaction cannot complete.
The transaction cannot complete successfully. Instruct the customer to use an alternative payment method.
Instruct the customer that PayPal is unable to process the payment and redisplay alternative payment methods with which the customer can pay.
10418
Transaction refused because of an invalid argument. See additional error messages for details.
The currencies of the shopping cart amounts must be the same.
10419
Express Checkout PayerID is missing.
Express Checkout PayerID is missing.
10420
Transaction refused because of an invalid argument. See additional error messages for details.
Express Checkout PaymentAction is missing.
10421
This Express Checkout session belongs to a different customer.
This Express Checkout session belongs to a different customer. Token value mismatch.
Verify that your programs are properly associating the Tokens and PayerIDs.
10422
Customer must choose new funding sources.
The customer must return to PayPal to select new funding sources.
10424
Transaction refused because of an invalid argument. See additional error messages for details.
Shipping address is invalid.
If you receive this error message, PayPal recommends that you return your customer to PayPal to review and approve new valid funding sources. Although this error is rare, you should consider trapping the error to display a message to the customer describing what happened, along with a button or hyperlink to return to PayPal.
10426
Transaction refused because of an invalid argument. See additional error messages for details.
Item total is invalid.
10427
Transaction refused because of an invalid argument. See additional error messages for details.
Shipping total is invalid.
10428
Transaction refused because of an invalid argument. See additional error messages for details.
Handling total is invalid.
10429
Transaction refused because of an invalid argument. See additional error messages for details.
Tax total is invalid.
10431
Item amount is invalid.
Item amount is invalid.
10432
Transaction refused because of an invalid argument. See additional error messages for details.
Invoice ID value exceeds maximum allowable length.
10433
Transaction refused because of an invalid argument. See additional error messages for details.
Value of OrderDescription element has been truncated.
10434
Transaction refused because of an invalid argument. See additional error messages for details.
Value of Custom element has been truncated.
10435
Transaction refused because of an invalid argument. See additional error messages for details.
The customer has not yet confirmed payment for this Express Checkout session.
10441
Transaction refused because of an invalid argument. See additional error messages for details.
The NotifyURL element value exceeds maximum allowable length.
10442
ButtonSource value truncated.
The ButtonSource element value exceeds maximum allowable length.
10443
Transaction refused because of an invalid argument. See additional error messages for details.
This transaction cannot be completed with PaymentAction of Order.
10444
Transaction refused because of an invalid argument. See additional error messages for details.
The transaction currency specified must be the same as previously specified.
10445
This transaction cannot be processed at this time. Please try again later.
This transaction cannot be processed at this time. Please try again later.
10446
Unconfirmed email
A confirmed email is required to make this API call.
10474
Invalid Data
This transaction cannot be processed. The country code in the shipping address must match the buyer’s country of residence.
The buyer selects the country of residence when they sign up for their PayPal account. The country of residence is displayed after the dash in the title on the Account Overview page.
10481
Transaction refused because of an invalid argument. See additional error messages for details.
PaymentAction of Authorization is not allowed with Unilateral and Non-Credentialed authentication.
10482
Transaction refused because of an invalid argument. See additional error messages for details.
PaymentAction of Order is not allowed with Unilateral and Non-Credentialed authentication.
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 your 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.
10725
Shipping Address Country Error
There was an error in the Shipping Address Country field
10727
Shipping Address1 Empty
The field Shipping Address1 is required
10728
Shipping Address City Empty
The field Shipping Address City is required
10729
Shipping Address State Empty
The field Shipping Address State is required
10730
Shipping Address Postal Code Empty
The field Shipping Address Postal Code is required
10731
Shipping Address Country Empty
The field Shipping Address Country is required
10736
Shipping Address Invalid City State Postal Code
A match of the Shipping Address City, State, and Postal Code failed.
11001
Exceeds maximum length.
Value of NoteText element is truncated.
11610
Payment Pending your review in Fraud Management Filters
Payment Pending your review in Fraud Management Filters
11611
Transaction blocked by your settings in FMF
Transaction blocked by your settings in FMF
11612
Could not process your request to accept/deny the transaction
Could not process your request to accept/deny the transaction
11820
Transaction refused because of an invalid argument. See additional error messages for details
Invalid Order URL.
Invalid shipping amount
Invalid shipping amount; it should equal the shipping amount of the selected shipping option
Invalid shipping options
Invalid shipping options; you must specify a name and amount for each shipping option
11821
Invalid shipping options
Invalid shipping options; you must specify a name and amount for each shipping option type
11826
Invalid shipping total
Invalid shipping total; it should equal the shipping amount of the selected shipping option
12125
PP incentive no longer available.
There's a problem with the redemption code(s) you entered and can't be used at this time. Your payment has not been processed. Please go back to PayPal so that the code(s) can be removed, your order total can be updated and then you'll be able to complete checkout.
12126
Payment could not be processed at this time. Incentive temporarily unavailable.
We're having problems processing redemption codes at this time. Your payment has not been processed. You can try to check out again at a later time or complete your payment without the discount applied.
12201
Immediate Payment item was not found.
The item specified is either not valid or is not currently available for purchase as an Immediate Payment item.
Please check that the item is a valid Immediate Payment item.
12203
Payment rolled back because of pending item.
Payment was not created because it would have been in a pending state, which is unacceptable for Immediate Payment items.
12204
Transaction reversed.
Error occurred causing transaction reversal.
12206
The value of PaymentAction must be Sale for Immediate Payment item.
Order and Authorization are not acceptable values for PaymentAction when the item is an Immediate Payment
12207
Cart ID is required for Immediate Payment item.
Cart ID is required for Immediate Payment item.
12208
eBay item amount does not match Express Checkout API item amount.
eBay item amount does not match Express Checkout API item amount.
13100
Parallel payments functionality is not available
Parallel payments functionality is not available
13101
Invalid Data
Payment action of Order is only supported for parallel payments
13102
Payment Request ID is missing
Payment Request ID is mandatory for parallel payments
13103
Duplicate Payment Request ID passed
Payment Request ID must be unique for parallel payments
13104
Transaction refused because of an invalid argument. See Additional error messages for details.
Number of payment requests exceeds maximum number of supported requests.
13106
Invalid Data
You cannot pass both the new and deprecated PaymentAction parameter.
13107
Parallel payments partially successful.
One or more payment requests failed. Check individual payment responses for more information.
13110
Multi Payments Sale is Not allowed
Due to some technical diffculties the Multi Payments for Sale is not avaliable now please try again later.
13111
Mixed Payment action not supported
The Payment Action passed should be unique, mixed Payment Action not supported
13115
Seller ID Missing
Seller ID is mandatory for parallel payments
13116
Transaction refused because of an invalid argument. See additional error messages for details.
The transaction is in progress for this token.
Authorization and Capture API Errors
Table 7. Authorization & Capture API Error Messages
Error Code
Short Message
Long Message
Returned By API Call...
Correcting This Error...
10001
Internal Error
Internal Error
10001
Internal Error
Transaction failed due to internal error
10004
Internal Error
Invalid argument
10007
Permission denied
You do not have permissions to make this API call
10009
Transaction refused
Account is locked or inactive
Retry the request at a later time or close order.
10010
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid argument
10202
Exceed max
Transaction would exceed user’s monthly maximum
DoAuthorization
DoCapture
10600
Authorization voided.
Authorization is voided.
DoAuthorization
DoCapture
DoReauthorization
DoVoid
Close the order or authorization.
10601
Authorization expired.
Authorization has expired.
DoAuthorization
DoCapture
DoReauthorization
DoVoid
Close the order or authorization.
10602
Authorization completed.
Authorization has already been completed.
DoAuthorization
DoCapture
DoReauthorization
DoVoid
Close the order or authorization.
10603
The buyer is restricted.
The buyer account is restricted.
DoAuthorization
DoCapture
DoReauthorization
DoVoid
Contact the buyer.
10604
Authorization must include both buyer and seller.
Authorization transaction cannot be unilateral. It must include both buyer and seller to make an auth.
DoAuthorization
Review the order to ensure customer and seller are both PayPal members.
10605
Unsupported currency.
Currency is not supported.
DoAuthorization
DoCapture
Retry the request with a PayPal-supported currency.
10606
Buyer cannot pay.
Transaction rejected, please contact the buyer.
DoAuthorization
DoCapture
DoReauthorization
Contact the buyer.
10607
Auth&Capture unavailable.
Authorization & Capture feature unavailable.
DoAuthorization
DoCapture
DoReauthorization
DoVoid
Contact PayPal Customer Service.
10608
Funding source missing.
The funding source is missing.
DoAuthorization
DoCapture
DoReauthorization
Contact the buyer.
10609
Invalid transactionID.
Transaction id is invalid.
DoAuthorization
DoCapture
DoReauthorization
DoVoid
Check the validity of the authorization ID and reattempt the request.
10610
Amount limit exceeded.
Amount specified exceeds allowable limit.
DoAuthorization
DoCapture
DoReauthorization
Reattempt the request with a lower amount.
10611
Not enabled.
Authorization & Capture feature is not enabled for the merchant. Contact customer service.
DoAuthorization
DoCapture
DoReauthorization
Contact PayPal Customer Service.
10612
No more settlement.
Maxmimum number of allowable settlements has been reached. No more settlement for the authorization.
DoCapture
Close the order.
10613
Currency mismatch.
Currency of capture must be the same as currency of authorization.
DoCapture
Ensure that the currencies are the same, and retry the request.
10614
Cannot void reauth.
You can void only the original authorization, not a reauthorization.
DoVoid
Void the authorization.
10615
Cannot reauth reauth.
You can reauthorize only the original authorization, not a reauthorization.
DoReauthorization
Capture the reauthorization.
10616
Maximum number of reauthorization allowed for the auth is reached.
Maximum number of reauthorization allowed for the auth is reached.
DoReauthorization
Capture or close the authorization
10617
Reauthorization not allowed.
Reauthorization is not allowed inside honor period.
DoReauthorization
Capture the authorization or reauthorize outside of honor period.
10618
Transaction already voided or expired.
Transaction has already been voided or expired.
DoAuthorization
DoCapture
DoReauthorization
DoVoid
Close the order or authorization.
10619
Invoice ID value exceeds maximum allowable length.
Invoice ID value exceeds maximum allowable length.
DoCapture
Check the length of the invoice ID and reattempt the request.
10620
Order has already been voided, expired, or completed.
Order has already been voided, expired, or completed.
DoAuthorization
DoCapture
DoVoid
Close this order.
10621
Order has expired.
Order has expired.
DoAuthorization
DoCapture
DoVoid
Close this order.
10622
Order is voided.
Order is voided.
DoAuthorization
DoCapture
DoVoid
Close this order.
10623
Maximum number of authorization allowed for the order is reached.
Maximum number of authorization allowed for the order is reached.
DoAuthorization
DoCapture
DoReauthorization
DoVoid
Capture this order.
10624
Duplicate invoice
Payment has already been made for this Invoice ID.
DoAuthorization
Review the invoice ID and reattempt the request.
10625
Transaction refused because of an invalid argument. See additional error messages for details.
The amount exceeds the maximum amount for a single transaction.
DoAuthorization
DoCapture
DoReauthorization
Reattempt the request with a lower amount.
10626
Risk
Transaction refused due to risk model.
DoAuthorization
DoCapture
DoReauthorization
Contact the buyer.
10627
Transaction refused because of an invalid argument. See additional error messages for details.
The invoice ID field is not supported for basic authorizations.
DoAuthorization
DoReauthorization
DoVoid
The Invoice ID field can only be used with DoCapture.
10628
This transaction cannot be processed at this time. Please try again later.
This transaction cannot be processed at this time. Please try again later.
DoAuthorization
DoCapture
DoReauthorization
DoVoid
Retry the request at a later time.
10629
Reauthorization not allowed.
Reauthorization is not allowed for this type of authorization.
DoReauthorization
Use DoAuthorization to authorize the an order.
10630
Item amount is invalid.
Item amount is invalid.
DoAuthorization
DoCapture
Check the item amount to ensure that it is not zero or negative.
10631
Processor Warning.
The authorization is being processed.
DoAuthorization
11094
This authorization cannot be voided, reauthorized, or captured against.
This authorization can only be handled through the marketplace which created it. It cannot directly be voided, reauthorized, or captured against.
GetTransactionDetails API Errors
Table 8. GetTransactionDetails API Errors
Error Code
Short Message
Long Message
10001
Internal Error
Internal Error
TransactionSearch API Errors
Table 9. TransactionSearch API Errors
Error Code
Short Message
Long Message
10001
Internal Error
Internal Error
10001
ButtonSource value truncated.
The transaction could not be loaded
10003
Transaction refused because of an invalid argument. See additional error messages for details.
Start date is a required parameter
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Start date is invalid
10004
Transaction refused because of an invalid argument. See additional error messages for details.
End date is invalid
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Currency is not supported
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Transaction class is not supported
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Receipt id is not valid
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Payer email is invalid
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Auction item id is not valid
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Receiver email is invalid
10004
Transaction refused because of an invalid argument. See additional error messages for details.
You can not search for a transaction id and a receipt id
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Receiver can only be specified for payments you’ve received
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The transaction id is not valid
10007
Permission denied
You do not have permission to search for this transaction
10007
Permission denied
You do not have permission to make this API call
11002
Search warning
The number of results were truncated. Please change your search parameters if you wish to see all your results.
RefundTransaction API Errors
Table 10. RefundTransaction API Errors
Error Code
Short Message
Long Message
Correcting This Error...
10001
Internal Error
Internal Error
10001
Internal Error
Warning an internal error has occurred. The transaction id may not be correct
10001
ButtonSource value truncated.
The transaction could not be loaded
10001
Internal Error
Internal Error
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The partial refund amount must be a positive amount
10004
Transaction refused because of an invalid argument. See additional error messages for details.
You can not specify a partial amount with a full refund
10004
Transaction refused because of an invalid argument. See additional error messages for details.
A transaction id is required
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The partial refund amount must be a positive amount
10004
Transaction refused because of an invalid argument. See additional error messages for details.
You can not specify a partial amount with a full refund
10004
Transaction refused because of an invalid argument. See additional error messages for details.
A transaction id is required
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Transaction class is not supported
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The transaction id is not valid
10007
Permission denied
You do not have permission to refund this transaction
10007
Permission denied
You do not have permissions to make this API call
10009
Transaction refused
You do not have a verified ACH
This error can be caused by insufficient funds in your PayPal balance to cover the amount of the refund and either your not having yet verified the bank account associated with your PayPal account or your not having any bank account associated with your PayPal account at all.
Ensure that you have sufficient funds in your PayPal balance and that you have verified the associated bank account.
10009
Transaction refused
The partial refund amount must be less than or equal to the original transaction amount
10009
Transaction refused
The partial refund amount must be less than or equal to the remaining amount
10009
Transaction refused
The partial refund amount is not valid
10009
Transaction refused
Because a complaint case exists on this transaction, only a refund of the full or full remaining amount of the transaction can be issued
10009
Transaction refused
You are over the time limit to perform a refund on this transaction
10009
Transaction refused
Can not do a full refund after a partial refund
10009
Transaction refused
Account is locked or inactive
10009
Transaction refused
The partial refund must be the same currency as the original transaction
10009
Transaction refused
This transaction has already been fully refunded
10009
Transaction refused
Account is restricted
10009
Transaction refused
You can not refund this type of transaction
10009
Transaction refused
You can not do a partial refund on this transaction
10009
Transaction refused
The account for the counterparty is locked or inactive
10009
Transaction refused
You can not refund this type of transaction
10011
Invalid transaction id value
Transaction refused because of an invalid transaction id value
11001
Transaction refused because of an invalid argument. See additional error messages for details.
Transaction class is not supported
MassPay API Errors
Table 11. MassPay API Errors
Error Code
Short Message
Long Message
10001
Invalid account number.
The transaction failed as a result of an invalid credit card number. Check the number or attempt with another card.
10001
Internal Error
Internal Error
10001
Internal Error
The transaction could not be loaded
10001
ButtonSource value truncated.
The transaction could not be loaded
10001
Transaction refused because of an invalid argument. See additional error messages for details.
The masspay receiver_type is not a recognizable type
10002
Account locked
The user account is locked
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The number of input records is greater than maximum allowed
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The number of input records is less than or equal to zero
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The note string length exceeds the maximum limit of 4000 characters
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The amount is missing
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The currency is missing
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Currency is not supported
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The amount is not a valid number
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The amount exceeds the max limit of a single mass pay item
~1
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The amount is less than or equal to zero
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The unique id string length exceeds the maximum limit of 30 characters
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The unique id string contains a space as a character
10004
Transaction refused because of an invalid argument. See additional error messages for details.
The transaction id is not valid
10007
Permission denied
You do not have permissions to make this API call
10301
User not allowed
The user is not allowed to send money through Mass Pay
10303
Restricted account
Account is restricted
10304
Unconfirmed email
The user account has unconfirmed email
10305
Limit Exceeded
The user account needs to have its sending limit removed in order to make a mass payment.
10306
Limit Exceeded
The user’s international account needs to have its sending limit removed in order to make a mass payment
10307
Receive only account
The user account is receive only and therefore cannot send payments out
10308
Masspay server configuration error
There is some configuration error
10309
Masspay server unavailable
The mass pay server is unavailable
10310
Unable to create payment
Unable to create payments for masspay
10311
Unable to submit payment
Unable to submit payments for masspay
10312
Masspay server error
The masspay server has reported errors
10313
Masspay Invalid Data
The masspay input file includes invalid data
10314
Masspay input parse error
The input to the masspay server is incorrect. Please make sure that you are using a correctly formatted input.
10317
Masspay Invalid Email
The masspay input file includes invalid Email
10320
Internal Error
Internal Error
10321
Insufficient funds
The account does not have sufficient funds to do this masspay
10327
Masspay Invalid UserID
The masspay input file includes invalid UserID
Recurring Payments Errors
The following table lists errors for the following APIs that handle recurring payments profiles:
*
CreateRecurringPaymentsProfile
*
GetRecurringPaymentsProfileDetails
*
ManageRecurringPaymentsProfileStatus
*
UpdateRecurringPaymentsProfile
*
BillOutstandingAmount
SetCustomerBillingAgreement Errors
Table 12. SetCustomerBillingAgreement Errors
Error Code
Short Message
Long Message
Additional Information
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid argument; BillingType input field is set to None
10404
Transaction refused because of an invalid argument. See additional error messages for details.
ReturnURL is missing.
ReturnURL tag has no content
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid value for request billing address parameter.
10405
Transaction refused because of an invalid argument. See additional error messages for details.
CancelURL is missing.
CancelURL tag has no content
10407
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid buyer email address (BuyerEmail).
Invalid BuyerEmail (badly formatted or violates SMTP protocol defined email address format) or BuyerEmail is passed as an empty tag.
10436
Transaction refused because of an invalid argument. See additional error messages for details.
PageStyle value exceeds maximum allowable length.
PageStyle tag is too long
10437
Transaction refused because of an invalid argument. See additional error messages for details.
cpp-header-image value exceeds maximum allowable length.
cpp_header_image tag is too long; maximum length is 127
10438
Transaction refused because of an invalid argument. See additional error messages for details.
cpp-header-border-color value exceeds maximum allowable length.
cpp_header_border_color tag is too long; maximum length is 6
10439
Transaction refused because of an invalid argument. See additional error messages for details.
cpp-header-back-color value exceeds maximum allowable length.
cpp_header_back_color tag is too long; maximum length is 6
10440
Transaction refused because of an invalid argument. See additional error messages for details.
cpp-payflow-color value exceeds maximum allowable length.
cpp_payflow_color tag is too long; maximum length is 6
10471
Transaction refused because of an invalid argument. See additional error messages for details.
ReturnURL is invalid.
ReturnURL tag contains invalid URL
10472
Transaction refused because of an invalid argument. See additional error messages for details.
CancelURL is invalid.
CancelURL tag contains invalid URL
10476
Transaction refused because of an invalid argument. See additional error messages for details.
10477
Transaction refused because of an invalid argument. See additional error messages for details.
11452
Merchant not enabled for reference transactions
Merchant not enabled for reference transactions
This merchant is not enabled for Mark reference transaction. Warning only
11453
Reference transactions temporarily unavailable.
Reference transaction feature not currently available; try again later
Feature not enabled because system is running in standin mode. Warning only
11601
Request for billing address failed
Billing address request is not enabled for merchant
11602
Request for billing address failed
Feature not yet available
GetBillingAgreementCustomerDetails Errors
Table 13. GetBillingAgreementCustomerDetails Errors
Error Code
Short Message
Long Message
Additional Information
10408
Missing token
Token is missing
Token is missing
10409
You’re not authorized to access this info.
Express Checkout token was issued for a merchant account other than yours.
Token belongs to a different merchant
10410
Invalid token
Invalid token
Token invalid
10411
This Express Checkout session has expired.
This Express Checkout session has expired. Token value is no longer valid.
Token expired
CreateBillingAgreement Errors
Table 14. CreateBillingAgreement Errors
Error Code
Short Message
Long Message
Additional Information
10408
Missing token
Token is missing
Token is missing
10409
You’re not authorized to access this info.
Express Checkout token was issued for a merchant account other than yours.
Token belongs to a different merchant
10410
Invalid token
Invalid token
Token invalid
10411
This Express Checkout session has expired.
This Express Checkout session has expired. Token value is no longer valid.
Token expired
11455
Buyer did not accept billing agreement
Buyer did not accept billing agreement
Buyer has not agreed to the billing agreement.
11456
A successful Billing Agreement has already been created for this token.
Transaction refused because of an invalid argument. See additional error messages for details.
Token has already been used to create a billing agreement
10408
Missing token
Token is missing
Token is missing
10409
You’re not authorized to access this info.
Express Checkout token was issued for a merchant account other than yours.
Token belongs to a different merchant
10410
Invalid token
Invalid token
Token invalid
10411
This Express Checkout session has expired.
This Express Checkout session has expired. Token value is no longer valid.
Token expired
UpdateBillingAgreement Errors
Table 15. UpdateBillingAgreement Errors
Error Code
Short Message
Long Message
Additional Information
10001
Internal Error
Internal Error
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid argument; description field or custom field is empty and the status is active
Check the description and custom fields of the billing agreement. Either the description or custom field is empty and the status is active or the contents of one of these fields exceeds the maximum field length.
10201
Billing Agreement was cancelled
Billing Agreement was cancelled
Billing agreement has been cancelled
10204
User’s account is closed or restricted
User’s account is closed or restricted
10209
Disabled
Preapproved Payments not enabled.
Merchant pull is not enabled for the country or merchant is not enabled for merchant pull
10209
Disabled
Preapproved Payments not enabled.
Account number mismatch for the API caller and the account the billing agreement belongs to.
10211
Invalid billing agreement ID
Invalid transaction or billing agreement ID; could not find Billing Agreement in database
11451
Billing Agreement Id or transaction Id is not valid
Billing Agreement Id or transaction Id is not valid
ReferenceID field is empty.
11451
Billing Agreement Id or transaction Id is not valid
Billing Agreement Id or transaction Id is not valid
Reference id refers to an invalid transaction.
11452
Merchant not enabled for reference transactions
Merchant not enabled for reference transactions
This merchant is not enabled for Mark reference transaction
DoReferenceTransaction Errors
Table 16. All Reference Transactions-Related API Errors
Error Code
Short Message
Long Message
Additional Information
10001
Internal Error
Internal Error
10002
Authentication/Authorization Failed
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid payment type argument
10009
Transaction refused
The account for the counterparty is locked or inactive
Merchant is locked/close/restricted
10010
Invalid Invoice
Non-ASCII invoice id is not supported
Non-ASCII characters are used in InvoiceID field
10201
Agreement canceled
Billing Agreement was cancelled
Billing agreement is not active
10202
Exceed max
Transaction would exceed user’s monthly maximum
Transaction would exceed the monthly limit
10203
Action required
Transaction failed, action required by user
10204
User’s account is closed or restricted
User’s account is closed or restricted
10205
Risk
Transaction refused due to risk model
10206
Duplicate
Transaction was already processed
10207
Retry
Transaction failed but user has alternate funding source
Retry the transaction with an alternate funding source.
10209
Disabled
Preapproved Payments not enabled.
Merchants is not enabled for preapproved payments (PAP); applies only to legacy PAP billing agreements
10210
No Funding
Transaction failed because has no funding sources
Payee has no funding sources.
10211
Invalid MP ID
Invalid MP ID
10212
Profile preference setting
A profile preference is set to automatically deny certain transactions
A profile preference is set that automatically denies this kind of transaction
10213
Invalid Soft Descriptor
The soft descriptor passed in contains invalid characters
10214
Soft descriptor format error.
10215
Soft Descriptor truncated
The soft descriptor was truncated
10216
Transaction refused because a confirmed address is not available
10400
Transaction refused because of an invalid argument. See additional error messages for details.
Order total is missing.
TotalOrder amount is missing
10401
Transaction refused because of an invalid argument. See additional error messages for details.
Order total is invalid.
TotalOrder amount is invalid
10402
Authorization only is not allowed for merchant.
This merchant account is not permitted to set PaymentAction? to Authorization. Please contact Customer Service.
Merchant is not eligible for auth settlement
10406
Transaction refused because of an invalid argument. See additional error messages for details.
The PayerID? value is invalid.
Merchant account number is invalid
10412
Duplicate invoice
Payment has already been made for this InvoiceID?.
Payment already made for the invoice
10413
Transaction refused because of an invalid argument. See additional error messages for details.
The totals of the cart item amounts do not match order amounts.
Total of cart items does not match order total
10414
Transaction refused because of an invalid argument. See additional error messages for details.
The amount exceeds the maximum amount for a single transaction.
Amount exceeds the max amount for a single txn
10417
Transaction cannot complete.
The transaction cannot complete successfully. Instruct the customer to use an alternative payment method.
Account not associated with a usable funding source
10417
Transaction cannot complete.
The transaction cannot complete successfully. Instruct the customer to use an alternative payment method.
Credit card or Billing Agreement is required to complete payment
10418
Transaction refused because of an invalid argument. See additional error messages for details.
The currencies of the shopping cart amounts must be the same.
Currencies in the shopping cart must be the same
10420
Transaction refused because of an invalid argument. See additional error messages for details.
PaymentAction? tag is missing.
PaymentAction? tag is missing.
10426
Transaction refused because of an invalid argument. See additional error messages for details.
Item total is invalid.
ItemTotal amount is invalid.
10427
Transaction refused because of an invalid argument. See additional error messages for details.
Shipping total is invalid.
ShippingTotal amount is invalid.
10428
Transaction refused because of an invalid argument. See additional error messages for details.
Handling total is invalid.
HandlingTotal amount is invalid
10429
Transaction refused because of an invalid argument. See additional error messages for details.
Tax total is invalid.
TaxTotal amount is invalid.
10429
Transaction refused because of an invalid argument. See additional error messages for details.
Item sales tax is invalid
PaymentDetailsItem.Tax field is invalid. Warning only; API executes
10430
Transaction refused because of an invalid argument. See additional error messages for details.
Item amount is missing.
PaymentDetailsItem.Amount field is missing. Warning only; API executes
10431
Transaction refused because of an invalid argument. See additional error messages for details.
Item amount is invalid.
PaymentDetailsItem.Amount field is invalid. Warning only; API executes
10432
Transaction refused because of an invalid argument. See additional error messages for details.
Invoice ID value exceeds maximum allowable length.
InvoiceID field is too long; maximum length is 256
10433
Transaction refused because of an invalid argument. See additional error messages for details.
Value of OrderDescription element has been truncated.
OrderDescription field is too long; maximum length is 127. Warning only; API executes
10434
Transaction refused because of an invalid argument. See additional error messages for details.
Value of Custom element has been truncated.
Custom field is too long; maximum length is 256. Warning only; API executes
10441
Transaction refused because of an invalid argument. See additional error messages for details.
The NotifyURL element value exceeds maximum allowable length.
NotifyURL field is too long; maximum length for notify URL is 2048
10442
ButtonSource value truncated.
The ButtonSource element value exceeds maximum allowable length.
ButtonSource field is too long; maximum length is 32. Warning only; API executes
10504
The cvv2 is invalid.
This transaction cannot be processed. Please enter a valid Credit Card Verification Number.
CVV2 field is invalid.
10527
Invalid Data
This transaction cannot be processed. Please enter a valid credit card number and type.
CreditCardNumber and/or CreditCardType is invalid
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.
Transaction refused due to country monitor risk control
10538
Risk Control Max Amount Failure
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.
Payment declined by your Risk Controls settings: PayPal Risk Model.
Transaction declined by Risk Control settings: PayPal Risk model
10546
Gateway Decline
This transaction cannot be processed.
IP fraud models failed.
10560
Invalid Data
The issue number of the credit card is invalid.
IssueNumber is invalid.
10567
Invalid Data
A Start Date or Issue Number is required.
None of Start date or issue number is specified (only applies to Switch and Solo credit cards)
10600
Authorization voided
Authorization voided.
10601
Authorization expired.
Authorization has expired
10621
Order has expired.
Order has expired.
10622
Order is voided.
Order is voided.
10623
Maximum number of authorization allowed for the order is reached.
Maximum number of authorization allowed for the order is reached.
10725
Shipping Address Country Error
There was an error in the Shipping Address Country field
Shipping address error in country field
10727
Shipping Address1 Empty
The field Shipping Address1 is required
Shipping address error in address1 field
10728
Shipping Address City Empty
The field Shipping Address City is required
Shipping address error in city field
10729
Shipping Address State Empty
The field Shipping Address State is required
Shipping address error in state field
10730
Shipping Address Postal Code Empty
The field Shipping Address Postal Code is required
Shipping address error in postal code
10731
Shipping Address Country Empty
The field Shipping Address Country is required
Country code is empty in shipping address
10736
Shipping Address Invalid City State Postal Code
A match of the Shipping Address City, State, and Postal Code failed.
Match of shipping address, city, state, and postal code failed.
10747
Invalid Data
This transaction cannot be processed without a valid IP address.
IPAddress field is invalid.
10748
Invalid Data
This transaction cannot be processed without a Credit Card Verification number.
CVV2 field is missing.
10755
Unsupported Currency.
This transaction cannot be processed due to an unsupported currency.
11302
Cannot pay self
The transaction was refused because you cannot send money to yourself.
Cannot pay self. Merchant is referencing own transaction.
11451
Billing Agreement Id or transaction Id is not valid
Billing Agreement Id or transaction Id is not valid
Invalid reference id
11451
Billing Agreement Id or transaction Id is not valid
Billing Agreement Id or transaction Id is not valid
Reference transaction is not associated with a billing agreement.
11451
Billing Agreement Id or transaction Id is not valid
Billing Agreement Id or transaction Id is not valid
Reference id either not found or could not be decrypted
11451
Billing Agreement Id or transaction Id is not valid
Billing Agreement Id or transaction Id is not valid
Reference id either not found or could not be decrypted
11452
Merchant not enabled for reference transactions
Merchant not enabled for reference transactions
This merchant is not enabled for Mark reference transaction
11453
Reference transactions temporarily unavailable.
Reference transaction feature not currently available; try again later
Feature wired off
11453
Reference transactions temporarily unavailable.
Reference transaction feature not currently available; try again later
Feature not supported in standin
11454
Warning: Could not send email to the buyer
Warning: Could not send email to the buyer
Failed to send email to buyer. This error is not fatal and generates a warning.
11459
Invalid Data
The shipping address must match the user’s address in the PayPal account.
The shipping address on file does not match the requested shipping address.
11610
Payment Pending your review in Fraud Management Filters
Payment Pending your review in Fraud Management Filters
11611
Transaction blocked by your settings in FMF
Transaction blocked by your settings in FMF
11612
Could not process your request to accept/deny the transaction
Could not process your request to accept/deny the transaction
18014
Gateway Decline
This transaction cannot be processed.
This transaction cannot be processed without a Credit Card Verification number.
AddressVerify API Errors
Table 17. AddressVerify API Errors
Error Code
Short Message
Long Message
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid email format
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid street format
10004
Transaction refused because of an invalid argument. See additional error messages for details.
Invalid zip format
10009
The API is disabled.
The Address API is currently disabled
ManagePendingTransactionStatus API Errors
Table 18. ManagePendingTransactionStatus API Errors
Error Code
Short Message
Long Message
11614
Could not process your request to accept/deny the transaction
Could not process your request to accept/deny the transaction
11614
The transaction has already been Accepted/Denied and the status cannot be changed
The transaction has already been Accepted/Denied and the status cannot be changed