如何使用Ecwid APIs实现Wix站Ecwid商店按用户国家切换货币

所有相关代码都需要部署在Wix站点侧，Ecwid后台不需要添加自定义代码。因为Ecwid是作为嵌入式组件集成在Wix页面中的，获取用户地理位置、调用Ecwid前端API控制货币切换的逻辑都需要在Wix的页面上下文里执行。

• 前置配置：先登录Ecwid后台，进入「设置→货币」页面，开启所有你需要支持的结算货币，配置好对应的汇率或者针对不同货币的固定商品定价，保存设置。
• 第一步：获取用户所属国家。直接调用Wix官方提供的wix-location-frontend模块的定位能力即可拿到用户的ISO国家代码，不需要额外接入第三方IP定位服务。
• 第二步：配置国家-货币映射规则。提前按照业务需求整理好国家ISO代码和对应Ecwid货币代码的映射表，比如美国对应USD、日本对应JPY、欧盟国家对应EUR等。
• 第三步：监听Ecwid组件加载完成，调用Ecwid前端API切换货币。Ecwid完全加载后会在全局暴露ecwid对象，调用ecwid.storefront.setCurrency(目标货币代码)即可完成货币自动切换。

打开Wix站点对应嵌入Ecwid商店的页面的代码面板，输入以下代码即可：

// 导入Wix前端定位模块
import wixLocationFrontend from 'wix-location-frontend';

// 自定义国家-货币映射表，可根据实际业务需求增删修改
const countryCurrencyMap = {
  'US': 'USD',
  'GB': 'GBP',
  'JP': 'JPY',
  'DE': 'EUR',
  'FR': 'EUR',
  'CN': 'CNY',
  'AU': 'AUD'
};

// 页面加载完成后执行逻辑
$w.onReady(async function () {
  // 优先读取用户手动切换过的货币记录（可选逻辑，避免每次刷新重置货币）
  const userSelectedCurrency = localStorage.getItem('ecwid_user_currency');
  if (userSelectedCurrency) {
    initEcwidCurrency(userSelectedCurrency);
    return;
  }

  // 无手动选择记录则通过地理位置判断
  try {
    const geolocation = await wixLocationFrontend.getGeolocation();
    const userCountry = geolocation.country;
    const targetCurrency = countryCurrencyMap[userCountry] || 'USD'; // 未匹配到国家则使用默认货币USD
    initEcwidCurrency(targetCurrency);
  } catch (e) {
    // 定位失败时使用默认货币
    initEcwidCurrency('USD');
  }
});

// 切换Ecwid货币的封装方法
function initEcwidCurrency(currencyCode) {
  // 轮询检测Ecwid是否加载完成
  const ecwidLoadTimer = setInterval(() => {
    if (window.ecwid && window.ecwid.storefront) {
      clearInterval(ecwidLoadTimer);
      window.ecwid.storefront.setCurrency(currencyCode);
      // 监听用户手动切换货币的事件，保存到本地存储（可选）
      window.ecwid.storefront.on('currencyChanged', (e) => {
        localStorage.setItem('ecwid_user_currency', e.currency);
      });
    }
  }, 100);
}

• 如果你的Ecwid是通过Wix官方应用市场的Ecwid插件集成的，无需额外配置Ecwid的嵌入参数，上述代码可直接生效
• 欧元区所有国家可以统一映射到EUR货币，不需要逐个国家单独配置映射规则
• 如果你需要针对部分国家强制使用指定货币，直接修改映射表即可，不需要调整其他逻辑

内容的提问来源于stack exchange，提问作者Suyog Yadav