如何在 2026 年通过 Shopify 销售 eSIM：从无代码到 API 的 3 种方式

Q: 当 Shopify 重试 webhook 时，我该如何防止重复生成 eSIM？

在每个订单请求中发送一个 Idempotency-Key，该密钥由 Shopify 的订单 ID 和项目 ID 构建。TripoSIM Partner API 对于重复的密钥会返回相同的订单，而不会创建新订单。

Q: 我可以用自己的品牌销售 eSIM 吗？

可以。通过 API 集成，您的商店会以您的品牌发送 eSIM 电子邮件。我们的 分销商、转售商和白标模式指南 对这些选项进行了比较。

快速回答

您可以通过三种方式在 Shopify 上销售旅行 eSIM，从无需代码到全自动。 最快的方式是使用推荐链接：您将 eSIM 套餐添加到您的商店或博客中，并在每笔销售中赚取佣金，无需库存，也无需处理售后支持。第二种是手动履约：您将 eSIM 作为数字产品销售，并从合作伙伴控制面板发送每个 QR code。第三种是API 集成：当 Shopify 订单支付完成后，您的应用程序会通过 eSIM API 订购 eSIM，并在几秒钟内以您的品牌将 QR code 通过电子邮件发送给客户。无论您选择哪种方式，请将 eSIM 列为无需物流的数字产品，清晰地展示目的地和流量，并在买家付款前引导他们进行兼容性检查。

对于许多 Shopify 商店来说，旅行 eSIM 是一个天然的增值产品：例如旅行装备、行李箱、手机配件、旅行指南、旅行社和外籍人士服务。该产品是数字化的，交付是即时的，且客户每次旅行都会再次购买。本指南将解释将 eSIM 添加到 Shopify 商店的三种方式、API 集成的工作步骤，以及在上线前需要检查的事项。

在您开始之前

Shopify App Store 中没有官方的 TripoSIM app。以下选项使用推荐链接、合作伙伴账户，或连接 Shopify 与 TripoSIM Partner API 的您自己的小型应用程序。如果您不是开发人员，请从选项 1 或 2 开始。

关键事实

eSIM 是数字产品。 在 Shopify 中，请将其设置为不需要物流的产品。
三种模式： 推荐链接（赚取佣金，无需库存）、手动履约（以合作伙伴价格购买并发送 QR code）、API 集成（自动交付）。
通过 API 集成，交付仅需几秒钟： 当 Shopify 确认付款时，订单即被创建，您的客户会通过电子邮件收到 QR code。
使用幂等键 (idempotency keys)： TripoSIM Partner API 要求在生产订单和充值时使用 `Idempotency-Key` 请求头，这样重试的 webhook 永远不会创建第二个 eSIM。
先进行测试： Partner API 设有沙盒环境，因此您可以构建并测试整个流程而无需花费资金。
合规性： 请遵守您销售所在国家的制裁和消费者规则，不要向您的供应商不支持的目的地销售。

在 Shopify 上销售 eSIM 的三种方式

选项	工作原理	最适合	工作量
1. 推荐链接	在 eSIM 套餐中添加链接或按钮；客户在 eSIM 提供商的网站上购买，你赚取佣金	博客、旅游创作者、起步阶段的店铺	仅需几分钟，无需代码
2. 手动履约	在你的店铺中销售 eSIM 产品，然后在你的合作伙伴控制面板中订购每个 eSIM，并将 QR code 通过电子邮件发送给客户	小批量订单、测试需求	低，但每个订单都需要手动操作
3. API 集成	一个小型应用程序接收 Shopify 的已付款订单 webhook，通过 API 订购 eSIM 并通过电子邮件发送 QR code	有定期订单并希望拥有自己品牌的店铺	需要几天开发时间

选项 1：推荐链接？

这是最简单的入门方式。通过 TripoSIM Ambassador program，你会获得专属的链接和 QR code，将其添加到你的产品页面、博客文章或订单确认邮件中，即可通过你的链接销售赚取佣金。TripoSIM 会负责支付、交付和客户支持。更多详情请阅读我们的指南：通过分享旅游 eSIM 赚钱。

选项 2：手动履约？

你在 Shopify 中创建 eSIM 产品，例如“Japan eSIM, 10 GB, 30 days”，并设定自己的零售价格。当订单到达时，你使用合作伙伴控制面板中的预付余额购买 eSIM，并将 QR code 发送给你的客户。这种方式非常适合每周只有少量订单的情况，并能让你测试哪些目的地比较畅销。成为分销商以获取合作伙伴价格。

选项 3：API 集成？

对于定期订单，可以使用 TripoSIM Partner API 实现自动化交付。你的客户完成付款后，几秒钟内就会通过电子邮件收到他们的 eSIM，无需任何手动操作。下一节将解释其工作原理。

API 集成是如何工作的

创建合作伙伴账户并获取您的 API 凭据。首先在沙盒环境中进行构建和测试。
将每个 Shopify 产品或变体映射到来自目录 API 的 TripoSIM 套餐 ID，并在 Shopify 中保留您的零售价格。
订阅 Shopify 的 paid-order webhook，并在信任每个 webhook 之前验证其签名。
为每条 eSIM 线路通过 Partner API 创建订单。发送一个由 Shopify 订单和行项目 ID 构建的 `Idempotency-Key`，并将您的 Shopify 订单号作为外部参考。
将 API 响应中的安装详情（QR code、SM-DP+ 地址和激活码）通过电子邮件发送给您的客户，然后将 Shopify 订单标记为已履行。
订阅 TripoSIM webhooks，例如 order.completed、order.failed、esim.activated、esim.depleted 和 wallet.low_balance，以处理延迟交付、使用量警报和余额不足的情况。

一些细节决定了演示 Demo 与可靠商店之间的区别：

重试是正常的。 Shopify 可能会多次发送同一个 webhook。幂等键（idempotency key）可以使重复的请求返回相同的订单，而不是购买第二个 eSIM。
有些订单需要更长的时间。 如果订单仍处于待处理状态，请等待 order.completed webhook（或稍后检查订单）后再给客户发送电子邮件。
保持余额不足警报。 API 订单是从预付费余额中支付的，因此请在余额用尽前进行充值，或者使用 wallet.low_balance webhook。
提供充值服务。 数据用尽的客户可以为同一个 eSIM 购买更多流量，这对您来说是第二次销售。
也要验证 TripoSIM webhooks： 每个 webhook 都有签名，因此在执行操作前请检查签名。

包含代码示例和 SDK 的完整参考文档请访问 docs.triposim.com。如需更深入的技术演练，请参阅我们的 eSIM 经销商 API 集成指南和 eSIM API 中需要测试的 12 个功能。

准备好保持连接了吗？

获取覆盖 200 多个目的地的旅行 eSIM——二维码即时发送至邮箱，无漫游费，结账时自动享受折扣。

浏览 eSIM 套餐

在您的 eSIM 产品页面上应该放什么

清晰的产品页面可以减少退款和支持邮件：

目的地和覆盖范围： 国家或地区，以及区域套餐所包含的国家列表。
流量和有效期： 例如 30 天内 10 GB，或无限量套餐的每日全速流量。
仅限数据： 明确说明该 eSIM 提供移动数据，而不是用于通话和 SMS 的电话号码。
兼容性： 链接到手机兼容性检查并提醒买家，手机不得锁定运营商。
套餐何时开始： 大多数套餐在 eSIM 首次在目的地连接时开始，因此客户可以在旅行前进行安装。
仅安装一次： 说明 QR code 通常仅用于一次安装，因此不应在两部手机上扫描。

定价与利润

拥有合作伙伴账户后，您可以按合作伙伴价格购买并设置自己的零售价格。TripoSIM 合作伙伴层级会根据您的业务量提供零售价折扣：Starter、Professional 和 Enterprise。许多商店将 eSIM 定价为接近市场价，并通过充值和回头客获得额外利润。请查看经销商计划以了解当前的层级。

常见问题解答

有用于销售 eSIM 的 Shopify app 吗？

Shopify App Store 中目前没有官方的 TripoSIM app。您可以通过推荐链接进行销售，通过合作伙伴控制面板进行手动履约，或者通过将 Shopify 连接到 TripoSIM Partner API 的自有小型 app 进行销售。

销售 eSIM 需要囤货吗？

不需要。eSIM 是在下单时创建的。使用推荐链接时，您无需处理产品；使用 API 时，每当您的客户付款时，就会订购一个 eSIM。

客户收到 eSIM 的速度有多快？

通过 API 集成，通常在付款后几秒钟内即可收到。如果是手动履约，则取决于您处理每个订单的速度。

当 Shopify 重试 webhook 时，我该如何防止重复生成 eSIM？

在每个订单请求中发送一个 `Idempotency-Key`，该密钥由 Shopify 的订单 ID 和项目 ID 构建。TripoSIM Partner API 对于重复的密钥会返回相同的订单，而不会创建新订单。

我可以用自己的品牌销售 eSIM 吗？

可以。通过 API 集成，您的商店会以您的品牌发送 eSIM 电子邮件。我们的分销商、转售商和白标模式指南对这些选项进行了比较。

我可以在不支付真实 eSIM 费用的情况下进行测试吗？

可以。TripoSIM Partner API 提供了一个沙盒环境，您可以在正式上线前创建测试订单并模拟事件。

总结

从最适合您商店的方案开始：如果您想零工作量，请使用推荐链接；如果您想测试需求，请使用手动履约；如果您想以自己的品牌进行自动交付，请使用 API 集成。在沙盒中进行构建，使用 idempotency keys，验证每个 webhook，并编写带有兼容性链接的清晰产品页面。准备就绪后，可以申请转售商计划或探索 Partner API。