Braintree · Decline codes
What does Braintree 2059 “Address Verification Failed” mean?
Checked
Braintree 2059 “Address Verification Failed” means PayPal could not verify that the transaction qualifies for Seller Protection because the address was improperly formatted. It is a hard decline. The buyer should contact PayPal or use a different payment method; you can also check how your checkout formats addresses.
- Type
- Hard decline
- Who declined
- PayPal
- Retry
- Not with the same address
- Shopper action
- Fix the address with PayPal or pay another way
- Merchant action
- Ask the buyer to check the address
What PlatformDTC does
PlatformDTC does not connect to Braintree; its PayPal rail talks to PayPal directly, so PayPal's own address and Seller Protection checks apply there in the same way. Its checkout also blocks risky payments by country, email domain and device rules the store sets.
Why it happens
The address sent was badly formatted, so PayPal could not match it for Seller Protection.
What the store can do
Check address fields (state, postcode, country codes) in your integration. Ask the buyer to try another method.
For developers
Braintree returns processor_response_code 2059 with processor_response_text “Address Verification Failed” and processor_response_type “hard_declined” on the Transaction object.
Frequently asked questions
- Is Braintree 2059 a card AVS failure?
- Braintree describes it as PayPal failing to verify the address for Seller Protection.
- Can I fix 2059 in my checkout?
- Often, by sending addresses in a clean, complete format.
Sources
- Declines: authorization decline codes — Braintree (PayPal)
- Transaction response object — Braintree (PayPal)
- Orders v2 API errors — PayPal
Related
- 2060 — Both the address and security code checks failed.
- 2061 — The transaction data was invalid.
- 2062 — The tax amount sent was invalid.
- 2063 — Your PayPal account preferences blocked this payment type.
- 2064 — Your account isn't set up for this currency.
- 2065 — PayPal refunds must happen within 180 days.