DoReferenceTransaction errors - 10001 to 18014

Error code Short and long messages User action
10001 Internal Error
Internal Error

Retry the transaction five more times at incremental intervals. If this continues to fail instruct the customer of the error. For assistance, contact Merchant Technical Support.

To learn more about possible causes and corrective actions, see What is API error code 10001?.

10002 Authentication/Authorization Failed
10002 Receiving Limit exceeded
You've exceeded the receiving limit. This transaction can't be completed.
10003 Missing argument
Item name, amount and quantity are required if item category is provided.
Scenario: Merchant passes item category as either Digital or Physical but does not also pass one of the following parameters: name, amount, or quantity.
10004 Transaction refused because of an invalid argument. See additional error messages for details.
You are not signed up to accept payment for digitally delivered goods.
Scenario: Merchant is not signed up for digital goods but passes item category as Digital.
10004 Cart item calculation mismatch.
Cart item calculation mismatch. The regular non-trial billing period amount is different than the sum of the amounts for each item in the cart.
Scenario: When the regular non-trial billing period amount is different than the sum of the amounts for each item in the cart.
10004 Tax calculation mismatch.
Tax calculation mismatch. The tax amount for the regular non-trial billing period is different than the sum of the tax for each item in the cart.
Scenario: When the regular non-trial billing period is different than the sum of the tax for each item in the cart.
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.
10014 API call was rate limited.
The API call has been denied as it has exceeded the permissible call rate limit.
10069 Payment refused due to risk; user notification necessary.
Payment could not be completed due to a sender account issue. Please notify the user to contact PayPal Customer Support.
Inform the customer that PayPal declined the transaction and to contact PayPal Customer Service.
10201 Agreement canceled
Billing Agreement was cancelled
Inform the customer that the billing agreement has been cancelled and the customer needs to create a new one. Offer the customer the chance to signup for a new billing agreement through Express Checkout.
10202 Exceed max
Transaction would exceed user's monthly maximum
The customer would exceed the monthly maximum allowed on the billing agreement. Offer the customer the chance to signup for a new billing agreement through Express Checkout.
10203 Action required
Transaction failed, action required by user
10204 User's account is closed or restricted
User's account is closed or restricted
Inform the customer that PayPal declined the transaction and to contact PayPal Customer Service.
10205 Risk
Transaction refused due to risk model
Inform the customer that PayPal declined the transaction and to contact PayPal Customer Service.
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 passed in was truncated
Warning
10216 Confirmed address required
Transaction refused because a confirmed address is not available
 
10217 Soft Descriptor City truncated
The SoftDescriptorCity field was truncated
Warning
10218 Soft Descriptor modified
Illegal characters were removed from the SoftDescriptor field
Warning
10219 Soft Descriptor City modified
Illegal characters were removed from the SoftDescriptorCity field
Warning
10220 Soft Descriptor's ignored
The Merchant is not enabled to pass SoftDescriptor or SoftDescriptorCity
Warning
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 transaction.
10417 Transaction cannot complete.
Instruct the customer to retry the transaction using an alternative payment method from the customer's PayPal wallet. The transaction did not complete with the customer's selected payment method.
Account not associated with a usable funding source. A credit card or Billing Agreement is required to complete payment. Inform the buyer that PayPal is unable to process the payment, and redisplay alternative payment methods with which the buyer can pay. You can also ask the buyer to contact PayPal Customer Service. For Automatic payments, this information can be sent via email to the customer.
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.
10422 Customer must choose new funding sources.
The customer must return to PayPal to select new funding sources.
Note: This page contains several table entries for this error code.

To learn more about possible causes and corrective actions, see What is API error code 10422?.

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 Item amount is invalid.
Item amount is invalid.
PaymentDetailsItemAmount 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.

10443

Transaction refused because of an invalid argument. See additional error messages for details.
This transaction cannot be completed with PaymentAction of Order.
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.

10474

Invalid Data This transaction cannot be processed. The shipping country is not allowed by 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.
10502 Invalid Data
This transaction cannot be processed. Please use a valid credit card.
The credit card used is expired.
10504 The cvv2 is invalid.
This transaction cannot be processed. Please enter a valid Credit Card Verification Number.
The credit card verification code (CVC) provided is invalid. The CVC is between 3 and 4 digits long.
10507 Invalid Configuration
This transaction cannot be processed. Please contact PayPal Customer Service.
Inform the customer that PayPal declined the transaction and to contact PayPal Customer Service.
10525 Invalid Data
This transaction cannot be processed. The amount to be charged is zero.
The merchant entered an amount of zero.
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.
10554
(Since API version 122)
Payment declined by your AVS Risk Controls Setting.
This transaction cannot be processed.
10555
(Since API version 122)
Payment declined by your AVS Risk Controls Setting.
This transaction cannot be processed.
10556
(Since API version 122)
Payment declined by your AVS Risk Controls Setting.
This transaction cannot be processed.
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 credit cards).
10574
(Since API version 122)
Credit card verified.
This card authorization verification is not a payment transaction.
10600 Authorization voided
Authorization voided.
10601 Authorization expired.
Authorization has expired
10606 Buyer cannot pay.
Transaction rejected, please contact the buyer.
Inform the buyer that PayPal is unable to process the payment and redisplay alternative payment methods with which the buyer can pay or ask the buyer to contact PayPal Customer Service.
10606 Transaction cannot be processed.
Transaction cannot be processed.
 
10613 Unsupported Currency.
Currency is not supported.
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.

Redirect the buyer to the provided shipping information and allow them to update/change the shipping address.

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.
10752 Transaction cannot be processed.
Please use a different payment card.
The transaction was declined by the issuing bank, not PayPal. The merchant should attempt another card. One possibile cause for this error is your business category is not allowed by American Express.
10755 Unsupported Currency.
This transaction cannot be processed due to an unsupported currency.
11084 User does not have a good funding source with which to pay.
User does not have a good funding source with which to pay.
Scenario: The credit card associated with the account could not be used and there is no other funding source with which to complete the transaction.
Inform the customer that PayPal declined the transaction and to contact PayPal Customer Service.
11091 The transaction was blocked as it would exceed the sending limit for this buyer.
The transaction was blocked as it would exceed the sending limit for this buyer.
Inform the customer that PayPal declined the transaction and to contact PayPal Customer Service.
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.
Check that the Billing Agreement ID is correct. If it is, instruct the customer that a new billing agreement is needed. Offer the customer the chance to signup for a new billing agreement through Express Checkout.
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.
Check that the Billing Agreement ID is correct. If it is, instruct the customer that a new billing agreement is needed. Offer the customer the chance to signup for a new billing agreement through Express Checkout.
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.
Check that the Billing Agreement ID is correct. If it is, instruct the customer that a new billing agreement is needed. Offer the customer the chance to signup for a new billing agreement through Express Checkout.
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 stand in.
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.
11457 Referenced transaction or order is too old
The Reference ID refers to a transaction or order that is more than 730 days old
11458 Invalid Data
Credit card details section must be empty; you cannot specify credit card information in a non-direct payment (DCC) reference transaction.
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.
11607 Duplicate request for specified Message Submission ID.
The specified Message Submission ID (specified in MSGSUBID parameter) is a duplicate; result parameters of the original request are attached.
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
13109 Transaction cannot complete due to Amex Restriction.
The transaction cannot complete successfully. Instruct the customer to use a non AMEX card.
13122 Transaction refused
This transaction cannot be completed because it violates the PayPal User Agreement.
13701 Invalid Data
Item Category value is invalid. Only Digital or Physical are allowed.
Scenario: When merchant passes an item category value other than Digital or Physical.
15012 CE agreement is not accepted
The CE agreement for processing Mastercard is not accepted.
 
18014 Gateway Decline
This transaction cannot be processed.
This transaction cannot be processed without a Credit Card Verification number.

Additional information