Braintree · Decline codes
What does Braintree 2103 “PIN try exceeded” mean?
Checked
Braintree 2103 “PIN try exceeded” means the shopper entered a wrong PIN more times than the bank allows. Braintree types it soft and maps it to Visa category 3. The card will not accept PIN payments until the bank resets it, so the shopper should pay another way or contact the bank.
- Type
- Soft decline
- Who declined
- The shopper's bank
- Retry
- Not right away. Visa category 3: max 15 in 30 days
- Shopper action
- Use another card or contact the bank
- Merchant action
- Ask for another payment method
What PlatformDTC does
PlatformDTC does not connect to Braintree. Stripe's pin_try_exceeded (Visa 75) is the same answer; PlatformDTC never retries it, at checkout or on renewals, because an online payment cannot take a PIN: the renewal is held and the subscriber is asked for another card.
Why it happens
Repeated wrong PINs triggered the bank's lock.
What the store can do
Ask for another card or payment method.
For developers
Braintree returns processor_response_code 2103 with processor_response_text “PIN try exceeded” and processor_response_type “soft_declined” on the Transaction object. Braintree maps it to Visa category 3 (issuer cannot approve with these details): at most 15 retries in 30 days.
Frequently asked questions
- How does the shopper unlock the card after Braintree 2103?
- By contacting their bank.
- Can I keep retrying 2103?
- No; ask for another method until the bank resets the card.
Sources
- Declines: authorization decline codes — Braintree (PayPal)
- Transaction response object — Braintree (PayPal)
- Mapping to Visa system integrity fee categories — Adyen
- Decline codes — Stripe
Related
- 2102 — The PIN entered was wrong.
- 2104 — The bank declined the payment offline.
- 2105 — Refused: card data invalid for its life cycle (try later).
- 2106 — Refused for a policy reason (try later).
- 2107 — The card is new and hasn't been activated yet.
- 2108 — The card account is closed.
- 2109-2999 — A bank refusal in Braintree's catch-all processor declined range.