Black Friday All Access $999 $399 lifetime or 30% off any plugin with Ends in -- See deals
View Categories

Payment Methods by Location Settings Reference

This reference lists every setting in Conditional Payment Methods by Location for WooCommerce, with its label, option ID, default and Free/Pro status. Settings are at WPFactory > Payment Gateways by Customer Location (also reachable at WooCommerce > Settings > Payment Gateways by Customer Location) in five sections.

General section #

Label Option ID Default Free/Pro
Detect country by (Billing country, Shipping country, Country by IP) alg_wc_gateways_by_location_country_type Billing country Free
Detect state by (Billing state, Shipping state) alg_wc_gateways_by_location_state_type Billing state Free
Detect city by (Billing city, Shipping city) alg_wc_gateways_by_location_cities_type Billing city Free
Detect postcode by (Billing postcode, Shipping postcode) alg_wc_gateways_by_location_postcodes_type Billing postcode Free
Advanced Options: Force JavaScript checkout update (Billing/Shipping state, city, postcode) alg_wc_gateways_by_location_force_js_checkout_update None selected Free

Location sections #

Each location section has an on/off switch plus an Include and an Exclude field for every payment gateway, listed by the gateway’s admin name. Per-gateway values are stored in one option per field, keyed by gateway ID, for example alg_wc_gateways_by_location_country_include[cod].

Section Label Option ID Default Free/Pro
Countries Gateways by country: Enable section alg_wc_gateways_by_location_country_section_enabled Yes Free
Countries Include countries / Exclude countries (multiselect, includes European Union and Netherlands Antilles) alg_wc_gateways_by_location_country_include, alg_wc_gateways_by_location_country_exclude Empty Free
States Gateways by state: Enable section alg_wc_gateways_by_location_state_section_enabled Yes Free
States Include states / Exclude states (multiselect, base country states only) alg_wc_gateways_by_location_state_include, alg_wc_gateways_by_location_state_exclude Empty Free
Cities Gateways by city: Enable section alg_wc_gateways_by_location_city_section_enabled Yes Free
Cities Include cities / Exclude cities (text area, one city per line) alg_wc_gateways_by_location_city_include, alg_wc_gateways_by_location_city_exclude Empty Free
Postcodes Gateways by postcode: Enable section alg_wc_gateways_by_location_postcode_section_enabled Yes Free
Postcodes Include postcodes / Exclude postcodes (text area, one per line, wildcards and numeric ranges) alg_wc_gateways_by_location_postcode_include, alg_wc_gateways_by_location_postcode_exclude Empty Free
Every section Reset Settings: Reset section settings alg_wc_gateways_by_location_{section}_reset No Free

An empty Include or Exclude field is ignored. Turning a section off with Enable section skips that location type entirely, even if values are saved.

Free and Pro #

In version 1.8.0 the free and Pro builds contain the same settings, and the free version works with any payment gateway. Every setting above is available in both.

wpf payment gateways by customer location for woocommerce icon

Conditional Payment Methods for WooCommerce

Get more from Conditional Payment Methods for WooCommerce

See every feature and the pricing on the Conditional Payment Methods for WooCommerce plugin page.

Need a hand? Our team answers every ticket on the Payment Methods by Location support forum.