集成检查清单
按照此综合检查清单设置您的 Zonos Dashboard 账户并为 WooCommerce 集成 Zonos Checkout 扩展。
创建 Zonos 账户
要开始使用,请联系我们的销售团队创建账户并签署协议。签署协议后,您将收到两笔需要验证的微额存款。
请将这些微额存款金额发送至 accounting@zonos.com,并附上您的 Dashboard 商店 ID(抄送您的销售代表)。
验证完成后,您的银行详情将显示在 Dashboard -> Settings -> Billing。
配置 Dashboard 和 Checkout 设置
创建 Zonos 账户后,您需要在 Dashboard 中配置设置以确保 Checkout 能够正常与您的商店配合使用。本部分介绍了所有必要的 Dashboard 配置。
设置打款
连接银行账户以从 Checkout 及时收到打款。打款在捕获付款后的 2 天内每天处理一次。要执行此操作,请按照以下步骤操作:
- 导航到 Dashboard -> Settings -> Checkout settings 。
- 单击添加银行账户。
- 您将被转到 Stripe 门户以完成设置并提供以下信息:
- 银行账户信息。
- 公司 EIN。
- 25% 公司所有者的社会保险号。有关为什么需要此信息,请参阅 Stripe 的文档。
**注意:**如果您需要更新打款计划,请联系 support@zonos.com
设置允许的域
Zonos Checkout 出于安全目的需要允许的域名列表。这可防止未经授权的网站加载 Checkout 并确保它仅在您批准的域上运行。如果没有此配置,Checkout 将返回权限错误。
要设置此功能:
- 导航到 Dashboard -> Settings -> Checkout settings。
- 在 URLs 下,添加您的完整域和将使用 Checkout 的任何子域。例如,如果您的域是
example.com,您应该添加example.com和test.example.com。
自定义品牌设置
在 Dashboard 中配置您的品牌设置以匹配您的商店的外观。
要执行此操作,请按照以下步骤操作:
- 导航到 Dashboard -> Settings -> Checkout settings -> Branding
- 配置以下设置:
- 徽标。
- 品牌和强调色。
- 主题、样式和字体。
有关品牌设置的更多信息,请参阅我们的文档。
连接运输承运人
要在结账时报价运费,您需要将运输承运人连接到您的 Zonos 账户。这将允许您在结账时启用特定的运输服务级别。
要连接运输承运人,请按照以下步骤操作:
- 导航到 Dashboard -> Settings -> Shipping -> Rates。
- 单击添加承运人。
- 按照承运人设置说明进行操作。
有关连接承运人账户的更多详细信息,请参阅我们的文档。
设置运输区域
运输区域允许您配置哪些运输承运人和服务级别可用于世界不同地区。
要设置运输区域,请按照以下步骤操作:
- 导航到 Dashboard -> Settings -> Shipping -> Locations。
- 单击新建区域。
- 输入区域名称并选择您要运送的国家/地区。
- 选择要提供的承运人和服务级别。
有关运输区域的更多详细信息,请参阅我们的文档。
设置备用原产国和 HS 代码
原产国和 HS 代码用于计算准确的关税和税款。
如果您未提供特定的原产国或 HS 代码,我们将使用在 Dashboard 中设置的备用选项。
要设置您的备用原产国和 HS 代码:
为 WooCommerce 安装和配置 Checkout 扩展
按照以下步骤为 WooCommerce 安装和配置 Checkout 扩展。
安装扩展
- 登录您的 WordPress 后台。
- 在插件下,搜索 WooCommerce Zonos Checkout 扩展。
- 单击安装并激活。
将扩展连接到您的 Zonos 账户
-
在您的 WordPress 后台中,单击左侧导航栏中的 Zonos Checkout 扩展。
-
单击常规设置。
-
输入您的私有 API 密钥和商店 ID 以将您的 Zonos Dashboard 设置链接到您的 WooCommerce 网站。
-
在测试模式下启用应用。
- 默认情况下,测试模式已打开。启用测试模式后,购物者将不会被定向到 Zonos Checkout。
配置您的国际结账按钮
您有两个选项来配置国际购物者如何访问 Zonos Checkout。
对国内和国际购物者使用您当前的结账按钮:
配置您当前的结账按钮以自动将国际购物者重定向到 Zonos Checkout,同时保持国内购物者在您的标准结账流程中。要执行此操作,请按照以下步骤操作:
- 在扩展的常规设置中,输入您的结账按钮的 CSS 选择器(例如,
#checkout-button或.woocommerce-checkout-button)。 - 单击保存常规设置。
要找到您的 CSS 选择器,请右键单击您的结账按钮,选择"检查",然后查找 HTML 中的 id 或 class 属性。如果您有多个结账按钮,请包括每个按钮的 CSS 选择器或将所有按钮配置为重定向到购物车页面,然后使用购物车页面的结账按钮选择器。
添加专用的国际结账按钮
创建专用的国际结账按钮,如果您有许多 VPN 用户或需要运送到国际地址的美国购物者,这是理想的。
要为国际购物者创建单独的按钮:
-
在扩展的常规设置中,输入您的结账按钮的 CSS 选择器(例如,
#checkout-button或.woocommerce-checkout-button)。 -
将国际结账按钮切换到右侧。
-
配置按钮外观:
- 输入按钮文本(例如,"国际结账"或"全球结账")。
- (可选)添加自定义 CSS 以匹配您的商店设计,如下面的示例所示。如果未提供自定义 CSS,按钮将默认使用您的商店主要色彩方案。我们建议在台式机和移动设备上测试按钮的外观。
-
单击保存常规设置。
**在运输区域中启用美国:**启用后,专用的国际结账按钮将对所有购物者显示。要允许美国购物者使用国际结账(例如,使用 VPN 或运送到国际地址时),您必须在 Dashboard 中的运输区域中启用美国。如果没有此设置,美国购物者将不会被重定向到 Zonos Checkout。
映射 WooCommerce 设置
自定义 Zonos 以与您的 WooCommerce 商店无缝集成,确保准确的关税、税款和运费计算。使用映射设置选项卡来对齐产品详情和属性与您的电子商务设置。虽然提供了默认值,但您可以配置这些设置以满足您商店的独特需求。
产品详情、自定义详情、重量和尺寸
这些字段映射到默认的常见值。标有星号 (*) 的值是必需的。如果您使用的第三方应用覆盖任何 (*) 字段,请确保这些 (*) 字段正确映射到第三方应用使用的值。
产品属性
如果您的产品具有应用于变体的独特属性(如颜色或尺寸),您需要在 Zonos 扩展中映射这些属性。这可确保订单履行时,您的 WooCommerce 商店和库存使用已运送的正确产品进行更新。要映射属性,请按照我们的 WooCommerce 产品属性映射文档中列出的步骤进行操作。
**注意:**如果您对映射产品变体有疑问或需要帮助,请联系 support@zonos.com。
测试您的集成
现在您已设置好账户和应用,您已准备好测试您的集成。
要在结账处下达测试订单:
- 将
?zonosTestMode=1添加到您的商店 URL,以被定向到 Zonos Checkout。 - 通过单击 Hello 标志并选择您要测试的国家/地区来将 Zonos Hello 更改为您要测试的国家/地区。否则,如果使用单一结账按钮,您将不会被重定向到 Zonos Checkout。您可以通过更改 URL 中的 zCountry= 来更新 Hello,更改为您要测试的任何国家/地区。例如,如果您想测试加拿大,您会输入 CA 在 zCountry=CA 中。
- 完成结账流程并下达订单。有关更多详细信息,请参阅我们的常规测试文档。
- 完成测试后,通过将测试模式切换为关闭来启用 Zonos。这将使您的集成上线并允许国际购物者使用 Zonos Checkout。
需要记住的一些事项:
- 最低限额—如果订单的购物车小计低于目的地国家/地区的最低限额,可能不会有任何关税或税款。这反映在我们的计算中。
- 退款和取消—我们正在收集付款,因此如果您需要进行任何退款或取消,请在 Dashboard 中处理这些。
- 标签—为 Dashboard 中的所有国际订单打印标签,除非您已被认证可以在 Dashboard 外打印标签。这是必需的,以便 Zonos 可以代表您支付关税和税款。
集成后
您的 Zonos 扩展将自动将订单从 Zonos 导入到 WooCommerce。但是,在极少数情况下,订单可能无法导入或 WooCommerce 中的订单状态可能与 Dashboard 不同步。您可以使用扩展中的以下功能来手动导入订单、同步订单状态并启用高级设置以排除故障。
手动导入订单
如果 Zonos 订单未导入到 WooCommerce 中,您可以使用订单导入选项卡将订单手动导入到 WooCommerce 中:
- 登录 Dashboard。
- 导航到订单。
- 单击需要导入的订单,并复制 Zonos 订单编号。
- 在 WordPress 后台中,导航到 Zonos 扩展中的订单导入选项卡,并将 Zonos 订单编号输入到Zonos 订单编号字段中。
- 单击导入订单。如果订单成功导入,订单将在 WooCommerce 中显示,您将在页面顶部看到"订单成功导入"横幅。如果订单导入失败,您将看到带有错误消息详细信息的横幅。
手动同步订单
如果 WooCommerce 中的订单状态与 Zonos 中的状态不匹配,您可以手动同步订单。
- 登录 Dashboard。
- 导航到订单。
- 单击需要导入的订单,并复制 Zonos 订单编号。
- 在 WordPress 后台中,导航到 Zonos 扩展中的订单同步选项卡,并将 Zonos 订单编号输入到Zonos 订单编号字段中。
- 单击同步订单。WooCommerce 中的订单状态应现在与 Dashboard 中的订单状态匹配。
高级设置
调试模式
打开调试模式以将 Zonos 详细日志发送给您,以帮助您诊断任何问题并改进您的集成性能。
速率限制
每分钟每个 IP 地址允许的最大 Webhook 请求数。默认值为 30,以防止潜在的滥用。
常见故障排除
如果您使用 WP Rockett 等缓存应用,您需要在对 Zonos 扩展进行更改时清除缓存。
常见问题
为了对关税、税款和运费成本获得最准确的报价,我应该提供什么产品信息?
产品信息可能会影响应付的关税和税款金额,以及总运费。您向 Zonos 提供的产品信息越多,返回的报价就越精确。即使此信息不可用,Zonos 也可以生成报价,但建议提供以下关键产品详情以提高准确性:
- **重量:**重量影响您的运费,这可能会影响关税或税款。您的 WooCommerce 产品清单中的重量在映射时由 Zonos 自动使用。您还可以在 Dashboard 中向 Catalog 添加重量以确保准确的运费计算。
- **尺寸:**尺寸用于计算体积重量。承运人将根据实际重量和体积重量中的较大者收费。Zonos 可以利用在 WooCommerce 中为每件产品设置的产品尺寸(长、宽和高)来计算体积重量,以确保您从客户那里收集正确的运费金额。您还可以在 Dashboard 中向 Catalog 添加尺寸以确保准确的运费计算。
- **HS 代码:**HS 代码影响关税率,有时可能会影响税款。您可以在 WooCommerce 中映射 HS 代码值或在 Dashboard 中使用 Catalog。
- **原产国:**产品的原产国影响关税率并可能影响税款。您可以在 WooCommerce 中映射原产国值或在 Dashboard 中使用 Catalog。
WooCommerce Zonos Checkout
为 WooCommerce 集成 Checkout 扩展。