自定义集成

首先，请联系我们的销售团队来创建帐户并签署协议。签署协议后，您将收到两笔小额定期存款，需要进行验证。

请将这些小额定期存款的金额发送至 accounting@zonos.com，并提供您的 Dashboard 商店 ID（抄送给您的销售代表）。

验证后，您的银行账户详情将显示在 Dashboard -> Settings -> Billing。

创建 Zonos 帐户后，您需要在 Dashboard 中配置设置以确保 Checkout 与您的商店正常运行。本部分涵盖所有必需的 Dashboard 配置。

设置付款

连接银行账户以接收来自 Checkout 的及时付款。付款在捕获后 2 天内每日处理。请按照以下步骤进行操作：

1. 导航至 Dashboard -> Settings -> Checkout settings
2. 点击 Add bank account
3. 您将被转到 Stripe 门户以完成设置并提供以下信息：
   • 银行账户信息。
   • 公司 EIN。
   • 拥有 25% 公司的社会安全号码。有关为什么需要这些信息的详细信息，请参阅 Stripe 的文档。

注意： 如果您需要更新付款日程，请联系 support@zonos.com

设置允许的域

Zonos JS 脚本出于安全目的需要允许的域名列表。这可防止未授权网站加载该脚本，并确保它仅在您批准的域上运行。没有此配置，该脚本将返回权限错误。

要进行此设置：

1. 导航至 Dashboard -> Settings -> Checkout settings
2. 在 URLs 下，添加您的完整域以及将使用 Checkout 的任何子域。例如，如果您的域是 example.com，您应该添加 example.com 和 test.example.com。

自定义品牌设置

在 Dashboard 中配置您的品牌设置以匹配您的商店的外观和感觉。

要进行此操作，请按照以下步骤进行操作：

1. 导航至 Dashboard -> Settings -> Checkout settings -> Branding
2. 配置以下设置：
   • 徽标。
   • 品牌和强调色。
   • 主题、风格和字体。

有关品牌设置的详细信息，请参阅我们的文档。

连接运费提供商

要在结账时引用运费，您需要将运费提供商连接到您的 Zonos 帐户。这将允许您在结账时启用特定运费服务等级。

要连接运费提供商，请按照以下步骤进行操作：

1. 导航至 Dashboard -> Settings -> Shipping -> Rates
2. 点击 Add carrier
3. 按照运费提供商设置说明进行操作。

有关连接运费提供商帐户的详细信息，请参阅我们的文档。

设置运费地区

运费地区允许您配置不同世界地区可用的运费提供商和服务等级。

要设置运费地区，请按照以下步骤进行操作：

1. 导航至 Dashboard -> Settings -> Shipping -> Locations
2. 点击 New zone
3. 输入区域名称并选择您想要运送到的国家。
4. 选择您想提供的运费提供商和服务等级。

有关运费地区的详细信息，请参阅我们的文档。

设置备用原产国和 HS 代码 

原产国和 HS 代码用于计算准确的税费和关税。

如果您没有提供特定的原产国或 HS 代码，我们将使用在 Dashboard 中设置的备用值。

要设置您的备用原产国和 HS 代码：

1. 导航至 Dashboard -> Settings -> Shipping -> Catalog。
2. 对于原产国，选择您大部分产品制造的国家。
3. 对于 HS 代码，输入您最常见产品的 HS 代码。如果您没有 HS 代码，请导航至 Dashboard 中的Classify并输入您的产品名称和描述以生成准确的 HS 代码。

Zonos JS 片段是一个客户端 JavaScript 集成，在您的网站上启用全球结账功能。它充当您的电子商务平台和 Zonos 服务之间的桥梁，处理：

• Checkout 体验：呈现结账 UI 并处理支付。
• 位置服务：检测访客位置并管理货币转换。
• 购物车集成：与您现有的购物车和订单系统相连。
• 安全：验证域并验证 API 请求。

该片段异步加载以防止对网站性能的任何影响。它使用您的商店的 API 凭据进行初始化，并安全地处理所有客户端交互。该实现设计为非侵入式的，只需对现有结账流程进行最少更改。

下面是一个完整示例，包括脚本加载、初始化和事件处理，供集成 Checkout 时参考。

4. 通过您的 Checkout customHTML 传递相应的 ID，以便中继知道针对哪个属性/像素触发：

有关分步 iframe 说明、完整事件参考（包括 purchase / Purchase 有效载荷映射）和调试提示，请参阅：

• Google Analytics 4 for iframe Checkout
• Facebook Pixel for iframe Checkout

要在您的系统和 Zonos Dashboard 之间同步订单，请实现这些 API 调用和 webhook：

必需的变更

必需的 Webhook 

在使用您的 Checkout 集成上线之前，重要的是彻底测试集成的所有方面，以确保顺畅的客户体验。这包括测试结账流程、支付处理、订单创建和 webhook 功能。

按照我们的测试指南验证您的集成工作正常，并识别和修复任何问题，然后启动到生产环境。

以下是有关集成流程的一些常见问题。

Zonos 如何处理订单确认？ 

在 Dashboard -> Settings -> Checkout settings 下的 Success page type 中配置售后体验。提供三个选项：

• Show Zonos success page（默认，推荐）— Zonos 在下单后显示内置感谢页面。即使订单无法导入到您的系统中，该页面也始终显示，因此购物者始终会获得确认。
• Redirect to a success page — Zonos 等待简短的"订单完成"屏幕，直到订单被创建，然后重定向到您配置的成功 URL，并将 zOrderNumber（和旧购物车的 orderId）作为查询参数附加。
• Close the checkout modal — 一旦支付被捕获，Zonos 就会关闭其模态框。如果您还配置了成功 URL，Zonos 会在 Stripe 收集支付后立即重定向到该 URL — 不等待订单创建 — 并将 zonosCheckoutSessionId 作为查询参数附加。当您想要最快的交接回到您自己的成功页面时，请使用此选项。

从 zonosCheckoutSessionId 查找订单 

当您使用关闭结账模态框与重定向 URL 时，订单可能需要几秒钟才能在重定向后附加到结账会话。从 URL 读取 zonosCheckoutSessionId 并使用您的秘密凭据令牌从服务器轮询 checkoutSession GraphQL 查询，直到订单准备就绪。永远不要从浏览器调用此 — 秘密凭据令牌必须保持服务器端。

将查询发送至 https://api.zonos.com/graphql，并从 Dashboard -> Settings -> Integrations 传递您的秘密凭据令牌作为 credentialToken 请求标头。

我可以在创建订单时收到通知吗？

是的。如果您想在创建订单时收到通知，在 Dashboard 的 Checkout settings 的 Email 部分中，您可以输入应在创建、运送或取消订单时收到通知的团队成员的电子邮件地址。