Braintree · Decline codes
What does Braintree 2025 “Set Up Error – Merchant” mean?
Checked
Braintree 2025 “Set Up Error – Merchant” means a connectivity or setup issue on the merchant side stopped the payment, depending on your region. Braintree types it soft. A single occurrence can be a connection hiccup; if it keeps appearing across customers, contact Braintree because your account setup needs fixing.
- Type
- Soft decline (merchant setup)
- Who declined
- Your Braintree account or its connection
- Retry
- Yes, if it was a connection blip; contact Braintree if it repeats
- Shopper action
- Try again shortly
- Merchant action
- Contact Braintree
What PlatformDTC does
PlatformDTC does not connect to Braintree. Its rule for faults like this is to never blame the subscriber: a fault on the account side rather than the card (a revoked key, lost access to the store's account, an outage) is not booked as the customer's decline: the renewal stays due, is re-charged by a 15-minute sweep once fixed, and the subscriber gets no “payment failed” email.
Why it happens
Braintree attributes it to a connectivity or account setup issue, varying by region.
What the store can do
If you see it on many transactions, contact Braintree. Do not treat these customers as declined.
For developers
Braintree returns processor_response_code 2025 with processor_response_text “Set Up Error – Merchant” and processor_response_type “soft_declined” on the Transaction object.
Frequently asked questions
- Is Braintree 2025 a card decline?
- No, it points to the merchant's setup or connection.
- Should I email the customer about 2025?
- No. It is not their card; fix the account or wait for the connection to recover.
Sources
- Declines: authorization decline codes — Braintree (PayPal)
- Transaction response object — Braintree (PayPal)
Related
- 2026 — The bank refused for an invalid merchant ID or unsupported transaction type.
- 2040 — Your account configuration may be wrong (invalid store).
- 2042 — Your account configuration may be wrong (invalid client ID).
- 2027 — The bank had a problem with the amount.
- 2028 — Your account has a setup problem (hierarchy).
- 2029 — Something is wrong with the card itself.
- 2030 — Your account has a terminal setup problem.
- 2031 — The bank doesn't support $0 card checks.