Error Codes and Messages for All PayPal APIs

General API Errors

 

Table A.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 permissions 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	Token is not valid
10002	Authentication/Authorization Failed	API access is disabled for this account
10002	Authentication/Authorization Failed	Client certificate is disabled
10002	Restricted account	Account is restricted

Authorization and Capture API Errors

 

Table A.2

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 ro reauthorize outside of honor period.
10618	Transaction already voided or expired.	Transaction has already been voided or expired.	DoAuthorization DoCapture DoReauthorization DoVoid	Close the orde or authorizationr.
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 InvoiceID.	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.
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.

Direct Payment API Errors

 

Table A.3

Direct Payment 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 an value for the PaymentAction field that is not supported.
10512	Invalid Data	This transaction cannot be processed. Please enter a first name.	The first name of the buyer is required for this merchant.
10513	Invalid Data	This transaction cannot be processed. Please enter a last name.	The last name of the buyer is required for this merchant.
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 merchant's account is not able to process transactions.	The merchant account attempting the transaction is not able to process Direct Payment transactions. Contact PayPal for more information.
10550	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.
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. Contact PayPal for more information.
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.

Express Checkout API Errors

 

Table A.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
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.
10007	Permission denied	You do not have permissions to make this API call
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.
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.	The token returned by SetExpressCheckout response expires after three hours. If you attempt to send the DoExpressCheckoutPayment after that time, you will receive error code 10411 in the DoExpressCheckoutPayment response. 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.
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.
10425	Express Checkout has been disabled for this merchant.	Express Checkout has been disabled for this merchant. Please contact Customer Service.
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.
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.
10471	Transaction refused because of an invalid argument. See additional error messages for details.	ReturnURL: Invalid parameter
10472	Transaction refused because of an invalid argument. See additional error messages for details.	CancelURL is invalid.
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 project.
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.
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

Table A.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
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 permissions 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 permissions 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.

Table A.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
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.	If you include any of the following element values with DoExpressCheckoutPayment, the sum of their values must equal the value of OrderTotal. l ItemTotal l ShippingTotal l HandlingTotal l 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.
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.	You can send a maximum of 10 DoExpressCheckoutPayment API calls for any single token value, after which the token becomes invalid.
10417	Transaction cannot complete.	The transaction cannot complete successfully. Instruct the customer to use an alternative payment method.	It is possible that the payment method the customer chooses on PayPal might not succeed when you send DoExpressCheckoutPayment. The most likely cause is that the customer’s credit card failed bank authorization. Another possible, though rare, cause is that the final OrderTotal is significantly higher than the original estimated OrderTotal you sent with SetExpressCheckout at Integration Point 1, and the final OrderTotal does not pass PayPal’s risk model analysis. If the customer has no other PayPal funding source that is likely to succeed, DoExpressCheckoutPayment response returns error code 10417. 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.	When your customer logs into PayPal, the PayPal PayerID is associated with the Express Checkout token. This error is caused by mixing tokens for two different PayerIDs. The Token and PayerID returned for any particular customer by GetExpressCheckoutDetails response must be the same ones you send with DoExpressCheckoutPayment. 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.	It is possible that the payment method the customer chooses on PayPal might not succeed when you send DoExpressCheckoutPayment request. If the customer has a different PayPal funding source that is likely to succeed, DoExpressCheckoutPayment response returns error code 10422 so you can redirect the customer back to PayPal.
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. For the rules of this calculation, see the chapter about best practices in the PayPal Express Checkout Integration Guide
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.
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.

GetTransactionDetails API Errors

 

Table A.7

GetTransactionDetails API Errors

Error Code	Short Message	Long Message
10001	Internal Error	Internal Error

MassPay API Errors

 

Table A.8

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

RefundTransaction API Errors

 

Table A.9

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

TransactionSearch API Errors

 

Table A.10

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 permissions to search for this transaction
10007	Permission denied	You do not have permissions 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.

Recurring Payments and Reference Transactions API Errors

Recurring Payments Errors

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

l	CreateRecurringPaymentsProfile

l	GetRecurringPaymentsProfileDetails

l	ManageRecurringPaymentsProfileStatus

l	UpdateRecurringPaymentsProfile

l	BillOutstandingAmount

Table A.11

Recurring Payments Errors

Error Code	Short Message	Long Message	Additional Information
10001	Invalid account number	The transaction failed as a result of invalid credit card number. Check the number or attempt with another credit card.
10478	Invalid Data	Recurring payments profile description must be provided if the billing agreement type is recurring payments.
10501	Invalid Configuration	This transaction cannot be processed due to an invalid merchant configuration.	Occurs when the billing agreement is disabled or inactive.
10502	Invalid Data	This transaction cannot be processed. Please use a valid credit card.	The credit card used is expired.
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 an value for the PaymentAction field that is not supported.
10512	Invalid Data	This transaction cannot be processed. Please enter a first name.	The first name of the buyer is required for this merchant.
10513	Invalid Data	This transaction cannot be processed. Please enter a last name.	The last name of the buyer is required for this merchant.
10535	Gateway decline	This transaction cannot be processed. Please enter a valid credit card number and type.
10548	Invalid Configuration	This transaction cannot be processed. The merchant's account is not able to process transactions.	The merchant account attempting the transaction is not a business account at PayPal. Check your account settings.
10550	Invalid Configuration	This transaction cannot be processed.	Access to Direct Payment was disabled for your account. Contact PayPal for more information.
10561	Invalid Data	There's an error with this transaction. Please enter complete billing address.
10565	Merchant country unsupported	The merchant country is not supported.
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.
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.
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.
10748	Invalid Data	This transaction cannot be processed without a Credit Card Verification Number.	The merchant's configuration requires a CVV to be entered, but no CVV was provided with this transaction. Contact PayPal if you wish to change this setting.
10751	Invalid Data	There's an error with this transaction. Please enter a valid state in the billing address.	The merchant provided an address either in the United States or Canada, but the state provided is not a valid state in either country.
10752	Gateway Decline	This transaction cannot be processed.	The transaction was declined by the issuing bank, not PayPal. The merchant should attempt another card.
10760	Invalid Configuration	This transaction cannot be processed. The country listed for your business address is not currently supported.	The merchant's country of residence listed in their PayPal account is not currently supported to allow Direct Payment transactions.
11089	Transaction Refused.	Account is locked or inactive.
11501	Invalid merchant country	The merchant's country is currently not supported
11502	The token is missing or is invalid	The token is missing or is invalid	Missing token
11503	Missing subscription details	Missing subscription details	One or more subscription detail fields are missing from the request.
11504	Missing schedule details	Missing schedule details	One or more schedule detail fields are missing from the request.
11505	Start date should be greater than current date	Subscription start date should be greater than current date
11506	Invalid max failed payments	Max failed payments, if supplied, must be >= 0
11507	Invalid trial amount	Trial amount must be >= 0
11508	Invalid trial total billing cycles	Trial total billing cycles must be > 0
11509	Invalid trial billing period	Trial billing period must be one of Day, Week, Month, SemiMonth, or Year
11510	Invalid trial amount	Trial amount must be >= 0
11511	Invalid currency for trial amount	This currency is currently not supported for trial amount.	Currency must be USD.
11512	Invalid trial shipping amount	Trial shipping amount must be >= 0	If a trial shipping amount is supplied, it must be >= 0.
11513	Invalid currency for trial shipping amount	This currency is currently not supported for trial shipping amount	Currency must be USD.
11514	Invalid profile status	The profile status is invalid.
11515	Invalid currency for trial tax amount	This currency is currently not supported for trial tax amount	Currency must be USD.
11516	Invalid billing frequency	Billing Frequency must be > 0 and be less than or equal to one year	The combination of billing frequency and billing period cannot exceed one year.
11517	Invalid total billing cycles	Total billing cycles must be >= 0 (0 means continuous)
11518	Invalid billing period	Billing period must be one of Day, Week, Month, SemiMonth, or Year
11519	Invalid amount	Bill amount must be greater than 0
11520	Invalid currency for amount	This currency is currently not supported for amount	Currency must be USD.
11521	Invalid shipping amount	Shipping amount must be >= 0
11522	Invalid currency for shipping amount	This currency is currently not supported for shipping amount	Currency must be USD.
11523	Invalid tax amount	Tax amount must be >= 0
11524	Invalid currency for tax amount	This currency is currently not supported for tax amount	Currency must be USD.
11531	Invalid profile status	The profile status must be one of (A)ctive, (C)ancelled, or e(X)pired
11543	Invalid payer country	The payer’s country is currently not supported
11544	Invalid period status	The trial period status must be one of (A)ctive or (C)ancelled
11545	Denied	Payer’s account is denied
11546	Denied	Merchant account is denied
11547	This feature is ot available at this time	Recurring payments feature is not currently available; try again later
11548	Invalid currency code	Invalid currency code, all currency codes much match
11549	Start Date is required	Subscription start date is required
11550	Start Date should be valid	Subscription start date should be valid
11551	Profile ID is missing from the request	Profile ID is missing from the request
11552	Invalid profile ID	The profile ID is invalid
11553	Invalid action value provided	Invalid action value provided
11554	Note is missing from the request	Note is missing from the request
11555
11556	Invalid profile status for cancel action; profile should be active or suspended	Invalid profile status for cancel action; profile should be active or suspended
11557	Invalid profile status for suspend action; profile should be active	Invalid profile status for suspend action; profile should be active
11558	Invalid profile status for reactivate action; profile should be suspended	Invalid profile status for reactivate action; profile should be suspended
11560	Invalid activation type	The activation type is invalid
11561	Invalid initial amount	The initial amount is invalid
11562	Invalid auto bill type	auto bill type is invalid
11564	The number of failed payments should be greater than the current number of failed payments	The number of failed payments should be greater than the current number of failed payments
11567	The time of the update is too close to the billing date	The time of the update is too close to the billing date
11568	Invalid currency for delinquent amount	Invalid currency for delinquent amount
11569	Cannot increase delinquent amount	Cannot increase delinquent amount
11570	The maximum number of failed payments should be greater than the current number of failed payments	The maximum number of failed payments should be greater than the current number of failed payments
11571	The total amount cannot exceed 120% increment per 180 days	The total amount cannot exceed 120% increment per 180 days
11576	Bill amount is greater than outstanding balance	Bill amount is greater than outstanding balance
11577	Another outstanding payment is scheduled	Another outstanding payment is scheduled
11578	Bill outstanding amount not processed because of scheduled payment	Recurring payment scheduled within 24 hours, so we are not processing the bill outstanding amount
11579	Payment is failing	Payment is failing
11582	No payment in queue	No scheduled payment has been found.
11583	DPRP feature is unavailable	DPRP feature is unavailable
11584	Inactive profile	Profile is not active
11585	Missing Token or buyer credit card	Missing token or payment source
11586	DPRP is disabled	DPRP is disabled for this merchant.
11587	Billing Address is Partial	Billing Address is Partial
11590	Profile update is not required	Based on your input request, profile already up to date.
15004	Gateway Decline	This transaction cannot be processed. Please enter a valid Credit Card Verification Number.

SetCustomerBillingAgreement Errors

 

Table A.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 A.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

DoReferenceTransaction Errors

 

Table A.14

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.
18014	Gateway Decline	This transaction cannot be processed.	This transaction cannot be processed without a Credit Card Verification number.

Fraud Management Filters API Errors

Fraud Management Filters API errors consist of errors returned by the ManagePendingTransactionStatus API and FMF-related errors returned by the following APIs: BillUser, DoDirectPayment, DoExpressCheckoutPayment, and DoReferenceTransaction.

Table A.1

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

Table A.2

FMF-Related API Errors for BillUser, DoDirectPayment, DoExpressCheckoutPayment, and DoReferenceTransaction

Error Code	Short Message	Long Message
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