Skip to main content
B

Braintree Decline Codes

Braintree, a PayPal service, provides payment solutions for online and mobile commerce.

124Total Codes
25Retryable
99Non-Retryable
Category:
Retryable:

Showing 124 of 124 codes

2000
Do Not Honor
Soft Decline
Retryable

The customer's bank is unwilling to accept the transaction. The customer will need to contact their bank for more details regarding this generic decline.

3 common causes
View details
2001
Insufficient Funds
Soft Decline
Retryable

The account did not have sufficient funds to cover the transaction amount at the time of the transaction — subsequent attempts at a later date may be successful.

3 common causes
View details
2002
Limit Exceeded
Soft Decline
Retryable

The attempted transaction exceeds the withdrawal limit of the account. The customer will need to contact their bank to change the account limits or use a different payment method.

2 common causes
View details
2003
Cardholder's Activity Limit Exceeded
Soft Decline
Retryable

The attempted transaction exceeds the activity limit of the account. The customer will need to contact their bank to change the account limits or use a different payment method.

2 common causes
View details
2004
Expired Card
Hard Decline
Do Not Retry

The card is expired. The customer will need to use a different payment method.

1 common causes
View details
2005
Invalid Credit Card Number
Hard Decline
Do Not Retry

The customer entered an invalid payment method or made a typo in their credit card information. Have the customer correct their payment information and attempt the transaction again — if the decline persists, they will need to contact their bank.

2 common causes
View details
2006
Invalid Expiration Date
Hard Decline
Do Not Retry

The customer entered an invalid payment method or made a typo in their card expiration date. Have the customer correct their payment information and attempt the transaction again — if the decline persists, they will need to contact their bank.

2 common causes
View details
2007
No Account
Hard Decline
Do Not Retry

The submitted card number is not on file with the card-issuing bank. The customer will need to contact their bank.

2 common causes
View details
2008
Card Account Length Error
Hard Decline
Do Not Retry

The submitted card number does not include the proper number of digits. Have the customer attempt the transaction again — if the decline persists, the customer will need to contact their bank.

2 common causes
View details
2009
No Such Issuer
Hard Decline
Do Not Retry

This decline code could indicate that the submitted card number does not correlate to an existing card-issuing bank or that there is a connectivity error with the issuer. The customer will need to contact their bank for more information.

2 common causes
View details
2010
Card Issuer Declined CVV
Hard Decline
Do Not Retry

The customer entered an invalid security code or made a typo in their card information. Have the customer attempt the transaction again — if the decline persists, the customer will need to contact their bank.

2 common causes
View details
2011
Voice Authorization Required
Hard Decline
Do Not Retry

The customer's bank is requesting that the merchant call to obtain a special authorization code in order to complete this transaction. This can result in a lengthy process — we recommend obtaining a new payment method instead.

1 common causes
View details
2012
Processor Declined – Possible Lost Card
Fraud/Security
Do Not Retry

The card used has likely been reported as lost. The customer will need to contact their bank for more information.

1 common causes
View details
2013
Processor Declined – Possible Stolen Card
Fraud/Security
Do Not Retry

The card used has likely been reported as stolen. The customer will need to contact their bank for more information.

1 common causes
View details
2014
Processor Declined – Fraud Suspected
Fraud/Security
Do Not Retry

The customer's bank suspects fraud — they will need to contact their bank for more information.

2 common causes
View details
2015
Transaction Not Allowed
Hard Decline
Do Not Retry

The customer's bank is declining the transaction for unspecified reasons, possibly due to an issue with the card itself. They will need to contact their bank or use a different payment method.

2 common causes
View details
2016
Duplicate Transaction
Technical
Do Not Retry

The submitted transaction appears to be a duplicate of a previously submitted transaction and was declined to prevent charging the same card twice for the same service.

2 common causes
View details
2017
Cardholder Stopped Billing
Hard Decline
Do Not Retry

The customer requested a cancellation of a single transaction — reach out to them for more information.

1 common causes
View details
2018
Cardholder Stopped All Billing
Hard Decline
Do Not Retry

The customer requested the cancellation of a recurring transaction or subscription — reach out to them for more information.

1 common causes
View details
2019
Invalid Transaction
Hard Decline
Do Not Retry

The customer's bank declined the transaction, typically because the card in question does not support this type of transaction — for example, the customer used an FSA debit card for a non-healthcare related purchase. They will need to contact their bank for more information.

2 common causes
View details
2020
Violation
Hard Decline
Do Not Retry

The customer will need to contact their bank for more information.

1 common causes
View details
2021
Security Violation
Fraud/Security
Do Not Retry

The customer's bank is declining the transaction, possibly due to a fraud concern. They will need to contact their bank or use a different payment method.

2 common causes
View details
2022
Declined – Updated Cardholder Available
Hard Decline
Do Not Retry

The submitted card has expired or been reported lost and a new card has been issued. Reach out to your customer to obtain updated card information.

2 common causes
View details
2023
Processor Does Not Support This Feature
Technical
Do Not Retry

Your account can't process transactions with the intended feature — for example, 3D Secure or Level 2/Level 3 data. If you believe your merchant account should be set up to accept this type of transaction, contact Braintree support.

2 common causes
View details
2024
Card Type Not Enabled
Technical
Do Not Retry

Your account can't process the attempted card type. If you believe your merchant account should be set up to accept this type of card, contact Braintree support for assistance.

1 common causes
View details
2025
Set Up Error – Merchant
Technical
Retryable

Depending on your region, this response could indicate a connectivity or setup issue. Contact Braintree support for more information.

2 common causes
View details
2026
Invalid Merchant ID
Technical
Retryable

The customer's bank declined the transaction, typically because the card in question does not support this type of transaction. If this response persists across transactions for multiple customers, it could indicate a connectivity or setup issue.

2 common causes
View details
2027
Set Up Error – Amount
Technical
Do Not Retry

This rare decline code indicates an issue with processing the amount of the transaction. The customer will need to contact their bank for more details.

1 common causes
View details
2028
Set Up Error – Hierarchy
Technical
Do Not Retry

There is a setup issue with your account. Contact Braintree support for more information.

1 common causes
View details
2029
Set Up Error – Card
Hard Decline
Do Not Retry

This response generally indicates that there is a problem with the submitted card. The customer will need to use a different payment method.

1 common causes
View details
2030
Set Up Error – Terminal
Technical
Do Not Retry

There is a setup issue with your account. Contact Braintree support for more information.

1 common causes
View details
2031
Encryption Error
Technical
Do Not Retry

The cardholder's bank does not support $0.00 card verifications. Enable the "Retry All Failed $0" option to resolve this error.

2 common causes
View details
2032
Surcharge Not Permitted
Hard Decline
Do Not Retry

Surcharge amount not permitted on this card. The customer will need to use a different payment method.

2 common causes
View details
2033
Inconsistent Data
Technical
Do Not Retry

An error occurred when communicating with the processor. The customer will need to contact their bank for more details.

1 common causes
View details
2034
No Action Taken
Soft Decline
Retryable

An error occurred and the intended transaction was not completed. Attempt the transaction again.

1 common causes
View details
2035
Partial Approval For Amount In Group III Version
Soft Decline
Retryable

The customer's bank approved the transaction for less than the requested amount. Have the customer attempt the transaction again — if the decline persists, the customer will need to use a different payment method.

2 common causes
View details
2036
Authorization Could Not Be Found
Technical
Do Not Retry

An error occurred when trying to process the authorization. This response could indicate an issue with the customer's card or that the processor doesn't allow this action.

2 common causes
View details
2037
Already Reversed
Technical
Do Not Retry

The indicated authorization has already been reversed. If you believe this to be false, contact Braintree support for more information.

1 common causes
View details
2038
Processor Declined
Soft Decline
Retryable

The customer's bank is unwilling to accept the transaction. The reasons for this response can vary — customer will need to contact their bank for more details.

2 common causes
View details
2039
Invalid Authorization Code
Technical
Do Not Retry

The authorization code was not found or not provided. Have the customer attempt the transaction again — if the decline persists, they will need to contact their bank.

1 common causes
View details
2040
Invalid Store
Technical
Retryable

There may be an issue with the configuration of your account. Have the customer attempt the transaction again — if the decline persists, contact Braintree support for more information.

1 common causes
View details
2041
Declined – Call For Approval
Hard Decline
Do Not Retry

The card used for this transaction requires customer approval — they will need to contact their bank.

1 common causes
View details
2042
Invalid Client ID
Technical
Retryable

There may be an issue with the configuration of your account. Have the customer attempt the transaction again — if the decline persists, contact Braintree support for more information.

1 common causes
View details
2043
Error – Do Not Retry, Call Issuer
Hard Decline
Do Not Retry

The card-issuing bank will not allow this transaction. The customer will need to contact their bank for more information.

1 common causes
View details
2044
Declined – Call Issuer
Hard Decline
Do Not Retry

The card-issuing bank has declined this transaction. Have the customer attempt the transaction again — if the decline persists, they will need to contact their bank for more information.

1 common causes
View details
2045
Invalid Merchant Number
Technical
Do Not Retry

There is a setup issue with your account. Contact Braintree support for more information.

1 common causes
View details
2046
Declined
Soft Decline
Retryable

The customer's bank is unwilling to accept the transaction. For card payments contact your bank, for PayPal transactions contact PayPal Support, and for Venmo transactions contact Venmo Support.

1 common causes
View details
2047
Call Issuer. Pick Up Card
Fraud/Security
Do Not Retry

The customer's card has been reported as lost or stolen by the cardholder and the card-issuing bank has requested that merchants keep the card and call the number on the back to report it. As an online merchant, obtain a different payment method from the customer.

1 common causes
View details
2048
Invalid Amount
Technical
Retryable

The authorized amount is set to zero, is unreadable, or exceeds the allowable amount. Make sure the amount is greater than zero and in a suitable format.

3 common causes
View details
2049
Invalid SKU Number
Technical
Do Not Retry

A non-numeric value was sent with the attempted transaction. Fix errors and resubmit the transaction with the proper SKU Number.

1 common causes
View details
2050
Invalid Credit Plan
Hard Decline
Do Not Retry

There may be an issue with the customer's card or a temporary issue at the card-issuing bank. The customer will need to contact their bank for more information or use a different payment method.

1 common causes
View details
2051
Credit Card Number Does Not Match Method of Payment
Hard Decline
Do Not Retry

There may be an issue with the customer's credit card or a temporary issue at the card-issuing bank. Have the customer attempt the transaction again — if the decline persists, ask for a different card or payment method.

1 common causes
View details
2052
Invalid Level III Purchase
Technical
Retryable

Level III Data is inaccurate or missing.

1 common causes
View details
2053
Card Reported As Lost or Stolen
Fraud/Security
Do Not Retry

The card used was reported lost or stolen. The customer will need to contact their bank for more information or use a different payment method.

1 common causes
View details
2054
Reversal Amount Does Not Match Authorization Amount
Technical
Do Not Retry

Either the refund amount is greater than the original transaction or the card-issuing bank does not allow partial refunds.

2 common causes
View details
2055
Invalid Transaction Division Number
Technical
Do Not Retry

Contact Braintree support for more information regarding this error message.

1 common causes
View details
2056
Transaction Amount Exceeds The Transaction Division Limit
Hard Decline
Do Not Retry

Contact Braintree support for more information regarding this error message.

1 common causes
View details
2057
Issuer or Cardholder Has Put a Restriction on the Card
Soft Decline
Retryable

The customer will need to contact their issuing bank for more information.

3 common causes
View details
2058
Merchant Not Mastercard SecureCode Enabled
Technical
Do Not Retry

The attempted card can't be processed without enabling 3D Secure for your account. Contact Braintree support for more information or ask the customer for a different payment method.

2 common causes
View details
2059
Address Verification Failed
Hard Decline
Do Not Retry

PayPal was unable to verify that the transaction qualifies for Seller Protection because the address was improperly formatted. The customer should contact PayPal for more information or use a different payment method.

2 common causes
View details
2060
Address Verification and Card Security Code Failed
Hard Decline
Do Not Retry

Both the AVS and CVV checks failed for this transaction. The customer should contact PayPal for more information or use a different payment method.

1 common causes
View details
2061
Invalid Transaction Data
Hard Decline
Do Not Retry

There may be an issue with the customer's card or a temporary issue at the card-issuing bank. Have the customer attempt the transaction again — if the decline persists, ask for a different card or payment method.

1 common causes
View details
2062
Invalid Tax Amount
Technical
Retryable

There may be an issue with the customer's card or a temporary issue at the card-issuing bank. Have the customer attempt the transaction again — if the decline persists, ask for a different card or payment method.

1 common causes
View details
2063
PayPal Business Account Preference Resulted in the Transaction Failing
Hard Decline
Do Not Retry

You can't process this transaction because your account is set to block certain payment types, such as eChecks or foreign currencies.

2 common causes
View details
2064
Invalid Currency Code
Hard Decline
Do Not Retry

There may be an issue with the configuration of your account for the currency specified. Contact Braintree support for more information.

2 common causes
View details
2065
Refund Time Limit Exceeded
Hard Decline
Do Not Retry

PayPal requires that refunds are issued within 180 days of the sale. This refund can't be successfully processed.

1 common causes
View details
2066
PayPal Business Account Restricted
Hard Decline
Do Not Retry

Contact PayPal's Support team to resolve this issue with your account. Then, you can attempt the transaction again.

1 common causes
View details
2067
Authorization Expired
Hard Decline
Do Not Retry

The PayPal authorization is no longer valid.

1 common causes
View details
2068
PayPal Business Account Locked or Closed
Hard Decline
Do Not Retry

You'll need to contact PayPal's Support team to resolve an issue with your account. Once resolved, you can attempt to process the transaction again.

1 common causes
View details
2069
PayPal Blocking Duplicate Order IDs
Technical
Do Not Retry

The submitted PayPal transaction appears to be a duplicate of a previously submitted transaction. This decline code indicates an attempt to prevent charging the same PayPal account twice for the same service.

1 common causes
View details
2070
PayPal Buyer Revoked Pre-Approved Payment Authorization
Hard Decline
Do Not Retry

The customer revoked authorization for this payment method. Reach out to the customer for more information or a different payment method.

1 common causes
View details
2071
PayPal Payee Account Invalid or Does Not Have a Confirmed Email
Hard Decline
Do Not Retry

Customer has not finalized setup of their PayPal account. Reach out to the customer for more information or a different payment method.

2 common causes
View details
2072
PayPal Payee Email Incorrectly Formatted
Hard Decline
Do Not Retry

Customer made a typo or is attempting to use an invalid PayPal account.

2 common causes
View details
2073
PayPal Validation Error
Technical
Do Not Retry

PayPal can't validate this transaction. Contact Braintree support for more details.

1 common causes
View details
2074
Funding Instrument in the PayPal Account Was Declined by the Processor or Bank
Hard Decline
Do Not Retry

The customer's payment method associated with their PayPal account was declined. Reach out to the customer for more information or a different payment method.

1 common causes
View details
2075
Payer Account Is Locked or Closed
Hard Decline
Do Not Retry

The customer's PayPal account can't be used for transactions at this time. The customer will need to contact PayPal for more information or use a different payment method.

1 common causes
View details
2076
Payer Cannot Pay for This Transaction with PayPal
Hard Decline
Do Not Retry

The customer should contact PayPal for more information or use a different payment method. You may also receive this response if you create transactions using the email address registered with your PayPal Business Account.

2 common causes
View details
2077
Transaction Refused Due to PayPal Risk Model
Fraud/Security
Do Not Retry

PayPal has declined this transaction due to risk limitations. You'll need to contact PayPal's Support team to resolve this issue.

1 common causes
View details
2078
Invalid Secure Payment Data
Technical
Do Not Retry

PIN cryptographic error found during decryption.

1 common causes
View details
2079
PayPal Merchant Account Configuration Error
Technical
Do Not Retry

You'll need to contact Braintree support to resolve an issue with your account. Once resolved, you can attempt to process the transaction again.

1 common causes
View details
2080
Invalid User Credentials
Technical
Do Not Retry

Invalid user credentials.

1 common causes
View details
2081
PayPal Pending Payments Are Not Supported
Technical
Do Not Retry

Braintree received an unsupported Pending Verification response from PayPal. Contact Braintree Support to resolve a potential issue with your account settings.

1 common causes
View details
2082
PayPal Domestic Transaction Required
Hard Decline
Do Not Retry

This transaction requires the customer to be a resident of the same country as the merchant. Reach out to the customer for a different payment method.

1 common causes
View details
2083
PayPal Phone Number Required
Hard Decline
Do Not Retry

This transaction requires the payer to provide a valid phone number. The customer should contact PayPal for more information or use a different payment method.

1 common causes
View details
2084
PayPal Tax Info Required
Hard Decline
Do Not Retry

The customer must complete their PayPal account information, including submitting their phone number and all required tax information.

1 common causes
View details
2085
PayPal Payee Blocked Transaction
Fraud/Security
Do Not Retry

Fraud settings on your PayPal business account are blocking payments from this customer. These can be adjusted in the Block Payments section of your PayPal business account.

1 common causes
View details
2086
PayPal Transaction Limit Exceeded
Hard Decline
Do Not Retry

The settings on the customer's account do not allow a transaction amount this large. They will need to contact PayPal to resolve this issue.

1 common causes
View details
2087
PayPal Reference Transactions Not Enabled for Your Account
Technical
Do Not Retry

PayPal API permissions are not set up to allow reference transactions. You'll need to contact PayPal's Support team to resolve this.

1 common causes
View details
2088
Currency Not Enabled for Your PayPal Seller Account
Hard Decline
Do Not Retry

This currency is not currently supported by your PayPal account. You can accept additional currencies by updating your PayPal profile.

1 common causes
View details
2089
PayPal Payee Email Permission Denied for This Request
Technical
Do Not Retry

PayPal API permissions are not set up between your PayPal business accounts. Contact Braintree support for more information.

1 common causes
View details
2090
PayPal or Venmo Account Not Configured to Refund More Than Settled Amount
Hard Decline
Do Not Retry

Your PayPal or Venmo account is not set up to refund amounts higher than the original transaction amount. Contact PayPal's Support team for information on how to enable this.

1 common causes
View details
2091
Currency of This Transaction Must Match Currency of Your PayPal Account
Hard Decline
Do Not Retry

Your PayPal account can only process transactions in the currency of your home country. Contact PayPal's Support team for more information.

1 common causes
View details
2092
No Data Found – Try Another Verification Method
Soft Decline
Retryable

The processor is unable to provide a definitive answer about the customer's bank account. Please try a different US bank account verification method.

1 common causes
View details
2093
PayPal Payment Method Is Invalid
Hard Decline
Do Not Retry

The PayPal payment method has either expired or been canceled.

1 common causes
View details
2094
PayPal Payment Has Already Been Completed
Technical
Do Not Retry

Your integration is likely making PayPal calls out of sequence. Check the error response for more details.

2 common causes
View details
2095
PayPal Refund Is Not Allowed After Partial Refund
Hard Decline
Do Not Retry

Once a PayPal transaction is partially refunded, all subsequent refunds must also be partial refunds for the remaining amount or less. Full refunds are not allowed after a PayPal transaction has been partially refunded.

1 common causes
View details
2096
PayPal Buyer Account Can't Be the Same as the Seller Account
Technical
Do Not Retry

PayPal buyer account can't be the same as the seller account.

1 common causes
View details
2097
PayPal Authorization Amount Limit Exceeded
Hard Decline
Do Not Retry

PayPal authorization amount is greater than the allowed limit on the order.

1 common causes
View details
2098
PayPal Authorization Count Limit Exceeded
Hard Decline
Do Not Retry

The number of PayPal authorizations is greater than the allowed number on the order.

1 common causes
View details
2099
Cardholder Authentication Required
Soft Decline
Retryable

The customer's bank declined the transaction because a 3D Secure authentication was not performed during checkout. Have the customer authenticate using 3D Secure, then attempt the authorization again.

1 common causes
View details
2100
PayPal Channel Initiated Billing Not Enabled for Your Account
Technical
Do Not Retry

Your PayPal permissions are not set up to allow channel initiated billing transactions. Contact PayPal's Support team for information on how to enable this.

1 common causes
View details
2101
Additional Authorization Required
Soft Decline
Retryable

This transaction requires additional customer credentials for authorization. The customer should insert their chip.

1 common causes
View details
2102
Incorrect PIN
Soft Decline
Retryable

The entered PIN was incorrect.

1 common causes
View details
2103
PIN Try Exceeded
Soft Decline
Retryable

The allowable number of PIN tries has been exceeded.

1 common causes
View details
2104
Offline Issuer Declined
Soft Decline
Retryable

The transaction was declined offline by the issuer. The customer will need to contact their bank for more information.

1 common causes
View details
2105
Cannot Authorize at This Time (Life Cycle)
Soft Decline
Retryable

The transaction is refused due to invalid card data. Please try again later.

1 common causes
View details
2106
Cannot Authorize at This Time (Policy)
Soft Decline
Retryable

The transaction is refused due to a policy reason. Please try again later.

1 common causes
View details
2107
Card Not Activated
Hard Decline
Do Not Retry

The transaction is from a new cardholder, and the card has not been properly unblocked.

1 common causes
View details
2108
Closed Card
Hard Decline
Do Not Retry

The account is closed. Re-validate the account number for accuracy and do not reattempt with the same card number or token.

1 common causes
View details
3000
Processor Network Unavailable – Try Again
Technical
Retryable

This response could indicate a problem with the back-end processing network, not necessarily a problem with the payment method. Have the customer attempt the transaction again — if the decline persists, contact Braintree support for more information.

2 common causes
View details
4001
Settlement Declined
Hard Decline
Do Not Retry

The processor declined to settle the sale or refund request.

1 common causes
View details
4003
Already Captured
Technical
Do Not Retry

The transaction has already been fully captured.

1 common causes
View details
4004
Already Refunded
Technical
Do Not Retry

The transaction has already been fully refunded.

1 common causes
View details
4005
PayPal Risk Rejected
Fraud/Security
Do Not Retry

The sale request was rejected by PayPal risk.

1 common causes
View details
4006
Capture Amount Exceeded Allowable Limit
Hard Decline
Do Not Retry

The specified capture amount exceeded the amount allowed by the processor.

1 common causes
View details
4018
PayPal Pending Payments Not Supported
Technical
Do Not Retry

PayPal returned a pending sale or refund response which is disallowed by Braintree. This failure is likely due to a misconfiguration in your PayPal account.

1 common causes
View details
4019
PayPal Refund Transaction with an Open Case Not Allowed
Hard Decline
Do Not Retry

PayPal declined to settle the refund request as there is an open dispute against the transaction.

1 common causes
View details
4020
PayPal Refund Attempt Limit Reached
Hard Decline
Do Not Retry

PayPal's maximum number of refund attempts for this transaction has been exceeded.

1 common causes
View details
4021
PayPal Refund Transaction Not Allowed
Hard Decline
Do Not Retry

PayPal does not allow you to refund this type of transaction.

1 common causes
View details
4022
PayPal Refund Invalid Partial Amount
Hard Decline
Do Not Retry

The partial refund amount is not valid.

1 common causes
View details
4023
PayPal Refund Merchant Account Missing ACH
Technical
Do Not Retry

Your PayPal account does not have an associated verified bank account.

1 common causes
View details
4024
Refund Time Limit Exceeded
Hard Decline
Do Not Retry

PayPal requires that refunds are issued within 180 days of the sale. This refund can't be successfully processed.

1 common causes
View details
4025
Payer Account Is Locked or Closed
Hard Decline
Do Not Retry

The customer's PayPal account can't be used for transactions at this time. The customer will need to contact PayPal's Support team for more information or use a different payment method.

1 common causes
View details
4026
PayPal or Venmo Account Not Configured to Refund More Than Settled Amount
Hard Decline
Do Not Retry

Your PayPal or Venmo account is not set up to refund amounts higher than the original transaction amount. Contact PayPal's Support team for information on how to enable this.

1 common causes
View details

Automate Braintree Payment Recovery

Slicker integrates with Braintree to automatically retry failed payments at the optimal time.

Get a Demo

Cookie preferences

Your privacy matters

We use analytics to understand how you use our site and improve your experience. Privacy Policy