Why isn't the address merge feature working?

Issue

Customer addresses were not successfully merged or reused in Recharge. This may appear as:

• A new address was created instead of reusing an existing one
• Duplicate addresses for the same customer
• The address reuse feature is enabled but not working as expected.

Environment

Cause 

There are two common reasons why the address merge feature did not work:

1. Address fields do not match exactly

Recharge will only merge addresses if all compared fields match exactly. The following fields are checked:

• Address line 1
• Address line 2
• City
• Province/state
• ZIP/postal code
• Country code
• Payment method
• Presentment currency
• Discount ID
• Cart note (only if enabled in settings)

If any of these fields differ (including differences like "St." vs "Street"), the address will not be merged.

2. The address has charge errors 

Addresses associated with charge errors will not be merged.

This is because:

• Each address is linked to a Shopify contract
• Each contract is tied to a payment method

Merging addresses with different payment states would require Recharge to choose one payment method, which can lead to unintended outcomes, such as:

• Continued failed charges if an invalid payment method is used
• Charging previously failed subscriptions if a valid payment method is applied

To prevent incorrect billing or unintended reactivation, Recharge does not merge these addresses.

Resolution

To resolve the issue:

• Ensure all address fields match exactly across checkouts
• Confirm payment method, currency, and discount details are identical
• Resolve any charge errors associated with the existing address