Digital Wallets – filter_checkout_fields priority too low

Hi @ninomiho,

Thanks again for your patience while we reviewed this internally.

We’ve taken a closer look, and it appears the issue stems from a misunderstanding of how WooCommerce handles locale‑based address requirements.

WooCommerce loads its address rules from the core locale database. This means the checkout dynamically adjusts based on the customer’s selected country:

• Countries like the US require a state.
• Countries like Ireland do not.
• Wallets generally follow similar logic, though they don’t use the exact same database.
  Over the years there have been a few mismatches between Apple Pay and WooCommerce for specific countries, and those were corrected as they surfaced.

The woocommerce_checkout_fields filter on the other hand, is intentionally set at the default priority of 10. This is expected behavior.
If a plugin needs to override WooCommerce’s defaults, it should adjust its own filter priority, either earlier or later, depending on what it needs to achieve. WooCommerce itself must remain at the default priority; otherwise, it wouldn’t be the default.

To help us pinpoint the mismatch, could you confirm:

• Which country is being used when the issue occurs?
• Which wallet (Apple Pay, Google Pay) and which gateway is processing it?

Once we have that, we can check whether this is a country‑specific mismatch between the wallet’s data and WooCommerce’s locale rules.

Hi there!

Thank you for the udpate. It’s possible that there is a mismatch between what Apple has for Croatia and what WooCommerce expects.

In WooCommerce, the State field for Croatia is currently:

• Required
• Visible (shown as a dropdown with 21 Croatian counties)
• Using the default label “State / County”

If you need to make the state field optional for Croatia, you can add a locale override entry for HR in the locale array with required set accordingly.

For testing purposes, could you please install the Code Snippets plugin and add the following snippet?

/**
 * Override WooCommerce locale settings for Croatia (HR)
 * Make state field optional instead of required
 */
add_filter( 'woocommerce_get_country_locale', function( $locale ) {
    $locale['HR'] = array(
        'state' => array(
            'required' => false,
            'label'    => __( 'County', 'woocommerce' ), // Optional: customize label
        ),
    );
    return $locale;
}, 10, 1 );

Let us know if that work for you.

Hi there!

Thanks for the update we completely understand your concern.

You’re absolutely right that using a snippet isn’t an ideal long-term solution, especially since it would require maintaining a list of countries that don’t use a “state” field and would only address the issue on your site. We also appreciate you pointing out that this works as expected when using WooPayments, which is a very helpful comparison.

We’ll share all of this information with our development team so they can review the behavior and investigate a proper fix at the plugin level, rather than relying on a workaround.

In the meantime, thank you for testing the snippet and for clearly explaining the limitations you’re seeing that context is extremely valuable for our developers.

We’ll follow up once we have more information or an update to share.

Before you go, If you’re happy with the support you received today, would you consider leaving us a quick review? It really helps us out: https://ww.wp.xz.cn/support/plugin/woocommerce-square/reviews/#new-post