集成
通过遵循本节中的步骤,无缝集成 Checkout 到您的 BigCommerce 商店:
开始
首先完成我们的 注册表单。一旦您的账户协议到位,入职将开始。
入职
在注册后的 24 小时内,一位专门的入职代表将与您联系,启动量身定制的集成过程。
重要: 以下列出的步骤供您参考,您将由您的入职代表引导完成。
安装应用
必须安装 Checkout 和 Hello,以确保 Checkout 正常工作,因为 Hello 将通知何时将国际客户重定向到我们的 Checkout。
- 从 BigCommerce Marketplace 安装 Checkout 应用,点击 获取此应用。
- 从 BigCommerce Marketplace 安装 Hello 应用,点击 获取此应用。
配置 Checkout
安装完两个应用后,配置您的设置:
- 在您的 BigCommerce 后台,转到 应用 → 我的应用 → Zonos Checkout。
- 输入您的集成凭据,将您的 Dashboard 设置链接到您的 BigCommerce 网站。
- 在测试模式或实时模式下启用应用:
- 在 Zonos Checkout 下,选择 启用。
- 在 测试模式 下,选择 启用。启用此模式时,您必须在 URL 后附加
?zonos=true
以启用 Zonos 功能,从而允许您在购物者仍然体验您本地流程的同时测试 Zonos。准备上线时,将其更改为 禁用。
- 根据您的网站需求自定义我们的应用:
- 在 订单导入时创建客户 下,选择您的偏好。
- 在 在 checkout 期间保留产品库存 下,选择 启用,如果您希望 Zonos 在我们的 Checkout 中保留产品库存。了解此功能在本页面底部的常见问题解答中是如何工作的。
- 在 将支付提供商显示为自定义 下,选择 启用,如果您希望所有 Zonos 订单在 BigCommerce 中显示 自定义 作为支付提供商。
- 点击 更新设置 以保存您的选择。
配置 Hello
- 在您的 BigCommerce 后台,转到 应用 → 我的应用 → Zonos Hello。
- 从 Dashboard 复制您的 Hello API 密钥,并将其输入为 站点密钥。
- 通过将 Hello 切换为 启用 来启用 Zonos Hello 应用。Hello 可以在 Checkout 之前启用,除非 Zonos Checkout 也被启用,否则不会重定向到 Checkout。
- 将 关税和税费报价 切换为 启用。
- 如果您希望 Zonos 利用 BigCommerce 货币转换,将 货币转换 切换为 启用。这样将允许 Hello 在 设置 → 货币 中为您启用货币。检查那里的货币设置,以确保支付将以您首选的货币进行。
- 点击 更新设置 以保存您的选择。
添加缺失的产品信息
在 V3 之前的 BigCommerce 版本中,它们传递给 Zonos 的 landed cost 报价数据存在限制。了解 Zonos 从每个版本的 BigCommerce 接收哪些产品信息,以及何时必须使用 Zonos Catalog 来添加我们计算所需的特定产品信息。
可选产品信息
特定产品信息并不是 Zonos 返回报价所必需的。Zonos 可以使用您的账户默认的 HS 代码和原产国,使用自定义因子估算重量,并在没有尺寸的情况下报价。然而,提供的特定产品信息越多,我们的计算就会越准确。
从 BigCommerce 传递的产品信息
- 重量
- 尺寸
- HS 代码*
- 原产国*
*仅在使用 BigCommerce V3 产品体验时导入
如果您没有使用 BigCommerce V3,请将您的产品及其 HS 代码和原产国添加到 Catalog。了解 如何使用 Catalog。
如果您将重量、尺寸、HS 代码或原产国添加到 Catalog,Catalog 将始终使用这些字段。如果您的电子商务平台和 Catalog 中都存在任何信息,则在运行我们的计算时,Catalog 中的信息将覆盖从电子商务平台发送的信息。例如,假设某个产品的重量在 Shopify 和 Catalog 中都存在。在这种情况下,Zonos 将使用 Catalog 中的重量来计算运费。
测试您的集成
现在您已经设置好您的账户和应用程序,您可以 测试您的集成。在测试时,您需要在 BigCommerce 中启用 Checkout 和 Hello。操作步骤如下:
- 在您的 BigCommerce 后台,转到 Apps → My apps → Zonos Hello。
- 将 Zonos Hello 切换为 启用。
- 然后转到 Apps → My apps → Zonos Checkout。
- 在 Zonos Checkout 下,选择 启用。
- 在 测试模式 下,选择 启用。
启用此模式后,您必须在 URL 后附加 ?zonos=true
以启用 Zonos 功能,从而允许您在购物者仍然体验您本地流程的同时测试 Zonos。
完成测试后,通过将 测试模式 设置为 禁用 来启用 Zonos。
一些需要记住的事项:
- De minimis—如果您的订单的购物车小计低于发货国家的 De minimis,则可能不需要支付任何关税或税款。这在我们的计算中有所反映。
- 退款和取消—我们正在收取付款,因此如果您需要进行任何退款或取消,请在 Dashboard 中处理这些事务。
- 标签—在 Dashboard 中为所有国际订单打印标签,除非您已获得在 Dashboard 之外打印标签的认证。这使我们能够代表您支付关税和税款。
**注意:**如果您需要我们进行调整,请联系 Zonos 支持 寻求帮助。
高级设置选项
隐藏国内元素
如果您有需要仅对国际用户隐藏的元素,例如仅限美国的支付提供商、运输估算器、仅限美国消息的横幅等,请使用以下步骤在 Zonos Hello 国家为国际时隐藏它们。要解决此问题,请转到 BigCommerce 管理面板 -> Storefront -> Script Manager -> Create Script。
要隐藏国内元素,请按照以下步骤操作:
-
转到 BigCommerce Storefront -> Script Manager -> Create Script。
-
创建一个新的 Zonos 自定义脚本,使用以下内容:
- 脚本名称:Zonos 自定义 - [脚本相关名称]
- 描述:[此脚本的功能]
- 放置位置:页脚
- 位置:所有页面
- 脚本类别:必需
- 脚本类型:脚本
- 脚本内容:复制以下内容并粘贴到脚本内容中。
-
在下面的脚本中,通过以下方式编辑
var domesticElements =
中的选择器:- 找到您希望在当前 BigCommerce 网站上对国际用户隐藏的元素选择器。
- 一旦您有了这些选择器,将它们添加到
.hide-me
的位置。 - 确保用引号包围每个选择器,并用逗号分隔,参见以下示例:
[".hide-1", ".hide-2", ".hide-3", ".hide-4"]
- 一旦脚本准备好并保存,测试通过访问隐藏元素的页面,并将 Zonos Hello 国家从美国切换到国际,然后再切换回美国。当选择国际国家时,这些元素应该被隐藏。
Zonos 集成脚本
<script>
var domesticElements = ['.hide-me'];
let cssElement = document.createElement('style'),
sheet;
document.head.appendChild(cssElement);
sheet = cssElement.sheet;
let count = 0;
for (let domesticHide of domesticElements) {
sheet.insertRule(`.z-intl ${domesticHide} { display:none; }`, count);
count++;
}
</script>
故障排除
Checkout 按钮未重定向
如果 Zonos Checkout 处于测试模式或设置为实时(并且 checkout 按钮未重定向到 Zonos),可能是 checkout 按钮选择器的问题。我们的 Zonos Checkout 应用使用一组默认的 checkout 按钮选择器。如果国际用户未被重定向,则可能需要调整这些选择器。
要解决此问题,请按照以下步骤操作:
-
转到 BigCommerce 管理面板 -> 商店前端 -> 脚本管理器 -> 创建脚本。
-
为 Zonos 创建一个新的自定义脚本,使用以下内容:
- 名称:Zonos 自定义 - [脚本相关名称]
- 描述:[此脚本的功能]
- 页面位置:页脚
- 选择将添加脚本的页面:所有页面
- 脚本内容:复制以下内容并粘贴到脚本内容中。
-
一旦您在脚本内容中有了以下代码,您需要调整其中一个选择器以匹配您当前的 checkout 按钮,或者您可以向列表中添加一个新的选择器。
-
确保保存此新脚本并测试网站。
Zonos 集成脚本
<script>
window.onload = () => {
selectors = {
'.previewCartCheckout .button--primary': 'checkout',
'.cart-actions .button--primary': 'Check out',
'.previewCartAction-checkout': 'Check out now',
'.ProceedToCheckout .btn': 'Proceed To Checkout',
'.CheckoutLink': 'Checkout',
'.button--primary': 'Checkout',
'.button-checkout': 'Checkout',
'.btn': 'Proceed To Checkout',
'.CheckoutButton': 'Proceed To Checkout',
};
for (let key in selectors) {
let button = contains(key, selectors[key]);
for (i = 0; i < button.length; i++) {
button[i].addEventListener('click', function (e) {
zonosCheckout(e);
});
}
}
};
</script>
常见问题解答
我如何知道我是否在使用 Stencil 主题?
要确定您是否使用 Stencil 主题,请在 BigCommerce 管理面板中查看,如果 Storefront -> Footer Scripts 是一个选项,则您的商店正在使用 Stencil 主题。
我应该提供哪些产品信息,以便获得最准确的关税、税费和运费报价?
产品信息会影响应付的关税和税费金额以及运费。您向 Zonos 提供的产品信息越多,返回的报价就会越精确。Zonos 即使在没有这些信息的情况下也可以生成报价,但建议提供以下关键产品细节以提高准确性:
- 重量: 重量会影响您的运费,这可能会影响关税或税费。您在 BigCommerce 产品列表中的重量会在存在时自动被 Zonos 使用。
- 尺寸: 尺寸可能会影响您的运费,这可能会影响关税或税费。Zonos 可以利用在 BigCommerce 中为每个产品设置的产品尺寸(长度、宽度和高度)。
- HS 代码: HS 代码会影响关税税率,有时也会影响税费。BigCommerce 无法将 HS 代码发送给 Zonos,因此必须使用 Zonos Catalog 添加。如果您使用的是 BigCommerce V3 产品体验,则会接收 HS 代码。
- 原产国: 产品的原产国会影响关税税率,并可能影响税费。BigCommerce 无法将原产国发送给 Zonos,因此必须使用 Zonos Catalog 添加。如果您使用的是 BigCommerce V3 产品体验,则会接收原产国信息。
BigCommerce 通过 Zonos 传递的产品细节
产品细节 | 重量 | 尺寸 | HS 代码 | 原产国 |
---|---|---|---|---|
自动传递 | ||||
通过 Catalog 添加 |
BigCommerce V3 通过 Zonos 传递的产品细节
产品细节 | 重量 | 尺寸 | HS 代码 | 原产国 |
---|---|---|---|---|
自动传递 |
注意: 另外,您可以将上述任何信息输入 Catalog,覆盖从 BigCommerce 存储和传递的信息。
了解更多 关于各平台的产品信息。
Checkout for BigCommerce
集成 Checkout 插件到 BigCommerce。在集成 Checkout 之前,请确保它能按预期工作。当您使用 Checkout 时: