Braintree · Decline codes
What does Braintree 2069 “PayPal Blocking Duplicate Order IDs” mean?
Checked
Braintree 2069 “PayPal Blocking Duplicate Order IDs” means this PayPal payment looks like a duplicate of one already submitted, so PayPal declined it to avoid charging the account twice. It is a hard decline. Check whether the first payment went through; if this is a genuine new order, send a unique order ID.
- Type
- Hard decline
- Who declined
- PayPal
- Retry
- Only with a new, unique order ID
- Shopper action
- Nothing
- Merchant action
- Send a unique order/invoice ID
What PlatformDTC does
PlatformDTC does not connect to Braintree; its PayPal rail talks to PayPal directly; there PayPal reports the same block as DUPLICATE_INVOICE_ID when the account setting requires a unique invoice ID per transaction.
Why it happens
The order or invoice ID matched one PayPal already processed.
What the store can do
Make order IDs unique per attempt, and check for an existing payment first.
For developers
Braintree returns processor_response_code 2069 with processor_response_text “PayPal Blocking Duplicate Order IDs” and processor_response_type “hard_declined” on the Transaction object.
Frequently asked questions
- Was the buyer charged twice on Braintree 2069?
- No, PayPal declined the duplicate. Check whether the first one succeeded.
- How do I stop 2069?
- Send a unique order ID with every new PayPal transaction.
Sources
- Declines: authorization decline codes — Braintree (PayPal)
- Transaction response object — Braintree (PayPal)
- Orders v2 API errors — PayPal
Related
- 2016 — This looks like a duplicate of a payment just made.
- 2070 — The buyer cancelled their pre-approved PayPal payments.
- 2071 — The receiving PayPal account isn't set up or confirmed.
- 2072 — The PayPal email address is badly formatted.
- 2073 — PayPal couldn't validate the transaction.
- 2074 — The card or bank inside the buyer's PayPal was declined.
- 2075 — The buyer's PayPal account is locked or closed.