Braintree Decline Codes

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.

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.

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.

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.

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

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.

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.

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

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.

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.

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.

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.

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

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

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

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.

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.

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

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

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.

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

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.

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.

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.

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.

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

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.

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.

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

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

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

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

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

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

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

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.

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.

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

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.

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.

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.

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

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.

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

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.

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

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.

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.

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.

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

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.

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.

Level III Data is inaccurate or missing.

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.

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

Contact Braintree support for more information regarding this error message.

Contact Braintree support for more information regarding this error message.

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

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.

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.

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

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.

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.

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

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

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

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

The PayPal authorization is no longer valid.

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.

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.

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

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

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

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

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.

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.

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.

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

PIN cryptographic error found during decryption.

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

Invalid user credentials.

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

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.

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.

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

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.

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.

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

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

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

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.

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

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

The PayPal payment method has either expired or been canceled.

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

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.

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

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

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

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.

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.

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

The entered PIN was incorrect.

The allowable number of PIN tries has been exceeded.

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

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

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

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

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

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.

The processor declined to settle the sale or refund request.

The transaction has already been fully captured.

The transaction has already been fully refunded.

The sale request was rejected by PayPal risk.

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

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.

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

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

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

The partial refund amount is not valid.

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

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

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.

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.