When does Braintree 2082 occur?

When buyer and merchant are in different countries but PayPal requires a domestic transaction.

Braintree · Decline codes

What does Braintree 2082 “PayPal Domestic Transaction Required” mean?

Checked October 31, 2026

Braintree 2082 “PayPal Domestic Transaction Required” means this transaction requires the buyer to be a resident of the same country as the merchant. It is a hard decline. Ask the buyer for a different payment method, such as a card.

Type: Hard decline
Who declined: PayPal
Retry: No
Shopper action: Use another method
Merchant action: Offer another method

What PlatformDTC does

PlatformDTC does not connect to Braintree; its PayPal rail talks to PayPal directly; there PayPal reports the same rule as DOMESTIC_TRANSACTION_REQUIRED, which a different payment method rather than a retry resolves.

Why it happens

PayPal rules for this payment require a domestic transaction.

What the store can do

Offer a card or another method to buyers from other countries.

For developers

Braintree returns processor_response_code 2082 with processor_response_text “PayPal Domestic Transaction Required” and processor_response_type “hard_declined” on the Transaction object.

Frequently asked questions

When does Braintree 2082 occur?: When buyer and merchant are in different countries but PayPal requires a domestic transaction.
Can the buyer fix 2082?: Only by using another method.

Sources

Declines: authorization decline codes — Braintree (PayPal)
Transaction response object — Braintree (PayPal)
Orders v2 API errors — PayPal