What Is a Braintree Processor Declined Error
Braintree is PayPal's payment gateway used by thousands of online stores. When a transaction is processed through Braintree, it can be declined at two distinct levels:
- Gateway decline — Braintree itself rejects the transaction before it ever reaches the bank (e.g., due to risk rules or invalid card data).
- Processor decline — The transaction was sent to the issuing bank or card network, but they declined it on their end.
A "processor declined" message means the second scenario: the gateway forwarded the request, but the bank or processor returned a refusal.
Why It Happens
A processor decline always comes with a response code. The most common codes and their meanings:
| Code | Meaning |
|---|---|
| 2000 | Do Not Honor — bank declined without specific reason |
| 2001 | Insufficient Funds |
| 2002 | Limit Exceeded |
| 2010 | Card Issuer Declined CVD — wrong CVV |
| 2038 | Not Permitted — transaction type not allowed |
| 2046 | Declined — generic bank refusal |
Common reasons include insufficient balance, daily spending limits, CVV mismatch, restrictions on foreign transactions, or the bank's fraud detection flagging the purchase.
Fix Steps
Check your card balance. Make sure you have enough funds to cover the purchase plus any fees.
Verify your CVV and billing address. The three-digit code on the back of your card and your billing address must exactly match what your bank has on file.
Call your bank. For code 2000 (Do Not Honor), your bank can often approve the transaction manually or explain the specific reason for the block.
Review your spending limits. Many banks set daily caps on international online payments. Check your limits in the mobile app or call support.
Enable international payments. Some banks disable cross-border transactions by default. Look for this toggle in your banking app settings.
Try a Marix virtual card. Marix cards are purpose-built for international payments and have no geographic restrictions by default.
FAQ
What is the difference between a gateway decline and a processor decline? A gateway decline happens inside Braintree (risk rules, invalid data). A processor decline is a response from your issuing bank or card network. They require different fixes.
Can I just retry the payment? If the code is 2001 (insufficient funds) or 2010 (wrong CVV), fix the underlying issue first. For code 2000, retrying without changes will most likely result in another decline.
How do I find the exact decline code? The code usually appears in the confirmation email from the store or in your bank's transaction details. The merchant can see the full code in the Braintree Control Panel.
If your cards are regularly declined on international sites, try Marix. Virtual cards designed for global payments work at hundreds of stores without geographic restrictions.