Braintree · Decline codes
What does Braintree 2102 “Incorrect PIN” mean?
Checked
Braintree 2102 “Incorrect PIN” means the PIN entered for the card was wrong. It is a soft decline from in-person card payments. The shopper can try again with the right PIN. Braintree maps it to Visa category 3, which counts retries toward Visa's limit of 15 in 30 days.
- Type
- Soft decline
- Who declined
- The shopper's bank
- Retry
- Yes, with the correct PIN. Visa category 3: at most 15 retries in 30 days
- Shopper action
- Re-enter the PIN
- Merchant action
- Let the shopper retry
What PlatformDTC does
PlatformDTC does not connect to Braintree. Stripe's matching code is incorrect_pin, which Stripe documents as applying only to card-reader payments; PlatformDTC classes it as an error the shopper must fix and never moves it to a backup processor.
Why it happens
A mistyped or forgotten PIN.
What the shopper can do
Enter the PIN again carefully, or pay another way if unsure.
What the store can do
Let the shopper retry carefully; after too many tries the card locks (2103).
For developers
Braintree returns processor_response_code 2102 with processor_response_text “Incorrect PIN” 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
- Does Braintree 2102 happen online?
- PINs are entered on card readers, so it comes from in-person payments.
- How many PIN tries are allowed?
- The bank decides; when exceeded, Braintree returns 2103.
Sources
- Declines: authorization decline codes — Braintree (PayPal)
- Transaction response object — Braintree (PayPal)
- Mapping to Visa system integrity fee categories — Adyen
- Decline codes — Stripe
Related
- 2103 — Too many wrong PIN attempts.
- 2078 — PIN encryption error.
- 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.