开始使用礼品卡和忠诚度合作伙伴集成

上次更新时间：2026年5月19日 10:16

了解如何请求礼品卡和忠诚度合作伙伴集成或禁用当前正在使用的礼品卡或忠诚度合作伙伴集成。

第三方礼品卡和忠诚度（奖励）合作伙伴集成在Toast上的工作原理——设置、切换提供商、禁用、重新启用和故障排除。

 

注意：如果您想要Toast自己的第一方礼品卡或忠诚度计划——而不是第三方合作伙伴——请参见开始使用Toast礼品卡或开始使用Toast忠诚度。

在本文中：

 

关于礼品卡和忠诚合作伙伴集成的简要说明

Toast与多个第三方礼品卡和忠诚（奖励）提供商合作——Paytronix、Punchh、Como、Hang、Curate、Tacit、Peoplevine、Voucher Connect、Fishbowl、Incentivio等——您可以通过Toast运行这些提供商，而不是（或与）Toast的第一方程序一起使用。每个餐厅集团一次只能有一个活跃的礼品卡提供商和一个活跃的忠诚提供商。设置由您与您的合作伙伴发起，随后合作伙伴联系Toast集成支持以完成后端配置。集成配置完成后，礼品卡和奖励按钮会出现在Toast POS上。

 

返回顶部

 

谁可以使用礼品卡和忠诚合作伙伴集成

Toast合作伙伴的礼品卡和忠诚集成适用于以下餐厅：

  • 与第三方礼品卡或忠诚（奖励）合作伙伴有活跃账户
  • 每个使用集成的地点都拥有Toast合作伙伴集成访问权限（包含在餐厅管理基础和餐厅管理专业套件中）
  • 在Toast Web中拥有适当的用户权限以启用或禁用礼品卡和忠诚设置（见下文）

 

返回顶部

 

所需模块、权限和硬件

适用范围：Toast Web，Toast POS

 

所需模块：

  • 每个使用集成的地点都需要Toast合作伙伴集成访问权限。包含在餐厅管理基础或餐厅管理专业套件中。有关详细信息，请参见 设置 Toast 合作伙伴集成。

 

所需权限：

  • 在礼品/奖励组级别的支付设置权限 — 启用或禁用礼品卡集成所需。
  • 在礼品/奖励组级别的营销信息权限 — 启用或禁用忠诚度集成所需。

 

有关 Toast 权限的更多信息，请参见 权限参考指南。

 

返回顶部

 

它是如何工作的

在 Toast 上的合作伙伴礼品卡或忠诚度集成有四个客户询问的时刻：初始设置、切换到或从合作伙伴、在 Toast 上禁用或重新启用集成，以及在出现问题时进行故障排除。下面的子部分涵盖每个方面。

 

设置合作伙伴礼品卡或忠诚度集成

您将完成的内容：将您的 Toast 餐厅连接到第三方礼品卡或忠诚度（奖励）合作伙伴，以便在 Toast POS 上显示礼品卡和奖励按钮。

 

有三个高级步骤。步骤 1 和 2 在您和合作伙伴之间。步骤 3 在合作伙伴和 Toast 之间。

 

步骤 1：确认 谁可以使用礼品卡和忠诚度合作伙伴集成 中列出的先决条件。

 

步骤 2：与您的礼品卡或忠诚度合作伙伴联系，并分享您的 Toast 餐厅 GUID。

为您希望启用的每个位置提供您的 Toast 餐厅 GUID。合作伙伴使用GUID在他们的系统中映射您的餐厅。

 

注意：要找到您的Toast餐厅GUID，请参见查找我的餐厅GUID。作为备用，您可以通过在浏览器中打开此URL下载完整的餐厅GUID报告：https://www.toasttab.com/restaurants/admin/export/restaurantidmapping。

 

步骤3：合作伙伴联系Toast集成支持以完成配置。

在收到您的GUID后，合作伙伴完成他们的入职（在他们的系统中映射您的GUID），然后直接联系Toast集成支持以启用Toast后端的集成。

 

重要：步骤3中的后端配置由Toast执行——不是由餐厅，也不是由合作伙伴单独执行。在Toast完成配置后，集成将在您的Toast合作伙伴集成门户中显示，路径为Toast Web > 集成 > 集成管理 > 浏览和购买集成，并且礼品卡和/或奖励按钮将在Toast POS上可用。

 

预期结果：在发布您的更改后，礼品卡和奖励按钮将在您礼品/奖励组的每个位置的Toast POS上出现。如果它们没有出现，请参见您的礼品卡或忠诚按钮未在POS上。

 

返回顶部

 

在礼品卡或忠诚提供商之间切换

餐厅通常在四个方向之间切换提供商。请在下面找到您的场景。

 

如果您要从Toast礼品卡或Toast忠诚切换到第三方合作伙伴：

在您在Toast Web中进行任何更改之前，请导出您现有的数据，以便合作伙伴可以将其导入他们的系统。在合作伙伴导入数据后，合作伙伴联系Toast集成支持以启用他们的集成（这会自动禁用该组的Toast礼品卡或Toast忠诚）。

 

重要：在更改您的Toast礼品卡或忠诚配置之前，请下载您的数据。在合作伙伴集成启用后，Toast礼品卡和忠诚报告将不再可访问。如果切换已经发生而您仍然需要文件，请联系Toast客户服务以暂时切换回Toast模块以下载它们。

 

完整的导出程序：

 

如果您正在从一个合作伙伴提供商切换到另一个合作伙伴提供商：

  1. 与您当前的合作伙伴和新合作伙伴协调，以便他们可以交接新合作伙伴所需的任何数据（忠诚度会员余额、礼品卡余额等）。Toast不执行此数据交接。
  2. 使用禁用或重新启用Toast上的合作伙伴集成中的步骤禁用当前的合作伙伴集成。
  3. 使用设置合作伙伴礼品卡或忠诚度集成中的步骤开始新的合作伙伴设置。与新合作伙伴分享您的Toast餐厅GUID。
  4. 新合作伙伴联系Toast集成支持以完成后端配置。

 

预期结果：旧的合作伙伴集成从您的Toast合作伙伴集成门户中移除，新合作伙伴出现，POS上的礼品卡和/或奖励按钮反映新合作伙伴。允许时间让两个发布事件在各个地点传播。

 

如果您正在从第三方合作伙伴切换回Toast礼品卡或Toast忠诚度：

联系Toast客户服务请求切换回去。在集团层面重新启用Toast礼品卡或Toast忠诚度之前，必须禁用您的合作伙伴集成。切换完成后，请参见开始使用Toast礼品卡或开始使用Toast忠诚度进行第一方设置。

 

如果您正在将现有的合作伙伴集成扩展到Toast在线订购专业版：

在POS上集成上线后，通过以下方式将其扩展到Toast在线订购专业版：

 

返回顶部

 

禁用或重新启用 Toast 上的合作伙伴集成

您可以随时在 Toast 上禁用合作伙伴礼品卡或忠诚度集成。禁用是礼品/奖励组级别的更改——它会关闭该集成，适用于组内的每个位置。

 

重要：确保在更改设置后立即在礼品/奖励组的每个位置保存并发布更改。使用 发布配置 一次性在所有位置发布。在您发布之前，更改尚未生效——而且 礼品卡 或 奖励 按钮不会从未发布的位置中移除（或添加）。

 

要禁用或重新启用礼品卡集成：

  1. 在 Toast Web 中，导航到 财务 > 支付 > 礼品卡 > 礼品卡设置。
  2. 将启用设置设置为否以禁用，或是是以重新启用。
  3. 选择保存，然后发布您的更改。使用发布配置在礼品/奖励组的每个位置发布。

 

预期结果：在每个位置发布后，礼品卡按钮将从 POS 中移除（或恢复），并且数据传输到您的礼品卡合作伙伴将停止或恢复。

 

要禁用或重新启用忠诚度集成：

  1. 在 Toast Web 中，导航到 Toast Web > 市场营销 > 忠诚度 > 忠诚度设置。
  2. 将启用忠诚度设置更改为否以禁用，或是是以重新启用。
  3. 如果您正在重新启用忠诚度集成，并且您的餐厅使用总账代码，请在同一页面上将忠诚度集成项目折扣和忠诚度集成支票折扣映射到 GL 代码。请参见 创建和映射总账代码。如果您不使用GL代码，请跳过此步骤。
  4. 选择保存，然后发布您的更改。

 

GL代码

 

预期结果：在每个位置发布后，奖励按钮将从POS中移除（或恢复），并且与您的忠诚合作伙伴的数据传输将停止或恢复。

 

注意：禁用合作伙伴礼品卡或忠诚度集成是一个集团级别的更改——它不会从您的Toast合作伙伴集成门户中移除该集成。要完全移除集成（该图块本身），请参见与Toast合作伙伴集成添加或移除集成。

 

返回顶部

 

当某些东西无法正常工作

如果合作伙伴礼品卡或忠诚度集成出现问题，请先决定需要联系谁。

 

重要：Toast可以排查您的Toast账户与第三方提供商之间的连接。Toast无法访问排查与您的第三方账户相关的任何具体问题（卡余额、忠诚会员记录、合作伙伴侧配置等）。对于这些，请直接联系您的第三方提供商。

 

常见场景及起始点：

  • 怀疑是Toast一侧的故障，或合作伙伴卡支付间歇性失败。检查Toast或设备是否处于离线模式——请参见故障和中断：Toast忠诚度和礼品卡。
  • 第三方礼品卡上的特定交易错误。请参见获取第三方礼品卡交易错误的帮助。POS上的错误详细信息窗口显示卡的最后4位、交易GUID和合作伙伴的错误文本——将所有这些提供给您的合作伙伴。
  • 集成已在您的Toast合作伙伴集成列表中设置，但POS按钮缺失。请参见您的礼品卡或忠诚按钮未在POS上。
  • 您怀疑该集成是由其他用户在多地点共享忠诚度中禁用的。与Toast客户服务开始聊天以解决问题——请参见忠诚计划随机禁用。
  • 合作伙伴表示集成应该已经上线，但您在Toast合作伙伴集成列表中没有看到它。请与合作伙伴确认他们已联系Toast集成支持以完成设置合作伙伴礼品卡或忠诚度集成的第3步。如果他们确认，请与Toast客户服务开始聊天。

 

返回顶部

 

已知限制

  • 每个餐厅集团只能有一个提供商。每个餐厅集团只能存在一个礼品卡和忠诚度组，并且一次只能启用一个礼品卡提供商和一个忠诚度提供商。您不能同时运行两个礼品卡提供商（例如，Valutec和Paytronix）。
  • 一个Toast配置与合作伙伴报告。一旦您切换到合作伙伴礼品卡提供商，所有礼品卡报告仅在合作伙伴端可用——Toast不显示这些报告。
  • 后端配置仅限于Toast。第3步后端配置（在Toast端启用合作伙伴集成）由Toast集成支持执行。餐厅无法独立完成此步骤。
  • Toast与合作伙伴之间的数据迁移不是自动的。忠诚度余额、礼品卡余额和其他数据必须从一方手动导出并导入到另一方。
  • 在线订购专业第三方礼品卡仅支持Valutec、Paytronix、eCard Systems和Giftrocker合作伙伴。

 

返回顶部

 

常见问题解答

 

您的礼品卡或忠诚度按钮不在POS上

也被问到：

    • "我在我的Paytronix集成中设置了礼品卡，但我在我的POS上没有看到礼品卡按钮"
    • "我正在尝试将我的合作伙伴礼品卡链接到我的Toast商店"
    • "我在新地点与[合作伙伴]的集成无法正常工作"

您的礼品卡或忠诚度按钮在POS上缺失，通常是因为配置更改尚未发布到该地点，或者因为自集成启用以来POS应用尚未刷新。要解决此问题：

  1. 通过联系Toast集成支持，确认合作伙伴已完成设置合作伙伴礼品卡或忠诚度集成的第3步。
  2. 在Toast Web中，导航到财务 > 支付 > 礼品卡 > 礼品卡设置（或Toast Web > 市场营销 > 忠诚度 > 忠诚度设置用于忠诚度），并确认启用设置为“是”。
  3. 选择保存，然后发布——并运行发布配置以在礼品/奖励组的每个位置发布。在受影响地点的Toast POS上，注销并重新登录以刷新设备的图块布局。
  4. 如果按钮仍然不出现，请与Toast客户服务聊天。

预期结果：礼品卡或奖励按钮在每个已发布位置的POS支付屏幕上出现。

 

我可以同时运行两个礼品卡提供商吗？

也被问到：

    • "是否可以同时使用Valuetec和Paytronix礼品卡与TOAST？"

不——每个餐厅组只能运行一个礼品卡提供商和一个忠诚度提供商。只能存在一个礼品卡和忠诚度组，并且在组级别上，礼品卡设置或忠诚度设置的启用设置在提供商之间是互斥的。如果您需要切换提供商，请参见在礼品卡或忠诚度提供商之间切换。

 

忠诚度的POS工作流程是什么样的？

Toast POS应用中忠诚度交易的用户界面工作流程记录在忠诚度POS工作流程中。

 

礼品卡可以手动输入但无法成功刷卡

手动输入时有效但刷卡时失败的礼品卡通常表明是读卡器问题——而不是集成问题。联系Toast客户服务以排查读卡器问题。

 

 

忠诚计划不断随机禁用

也被问到：

    • "忠诚计划不断随机关闭"

忠诚计划最常随机禁用是因为另一个拥有市场信息权限的用户正在更改共享多地点忠诚组的启用忠诚设置，或者因为一个关闭的位置导致设置翻转。与Toast客户服务开始聊天以调查并在需要时限制权限。

 

我如何确定礼品卡是否已被使用过？

要检查礼品卡是新的（需要激活）还是之前已售出（需要添加资金）：

  1. 在Toast POS上，选择礼品卡，然后选择余额查询。
  2. 刷卡或输入卡号以检查余额。
    • 如果POS显示余额，则该卡之前已被使用——选择添加价值以重新加载。
    • 如果POS显示卡未激活错误，则该卡是新的——选择出售卡以激活。

 

余额查询

要通过导入的号码查找导入的礼品卡余额，请参见使用导入的礼品卡号码查找礼品卡余额。

我可以将合作伙伴的忠诚数据导入Toast忠诚计划吗？

也被问到：

    • "我有来自[合作伙伴]的历史忠诚和市场信息，想将这些信息导入Toast忠诚计划"

是的——来自第三方合作伙伴的历史忠诚会员数据可以导入到Toast忠诚计划中，但导入由Toast客户服务发起，并取决于您的合作伙伴可以导出的数据字段。要请求Toast忠诚导入：

  1. 以CSV格式从合作伙伴导出您的忠诚会员数据。
  2. 与Toast客户服务开始聊天并请求Toast忠诚数据导入。
  3. 在提示时提供导出的CSV。客户服务将把请求转发给处理忠诚数据导入的团队。

在请求期间确认确切的字段映射和支持的数据类型——这些因合作伙伴而异。

 

返回顶部

相关文章

 

返回顶部