开始使用礼品卡和会员计划合作伙伴集成

第三方礼品卡和会员计划（奖励）合作伙伴集成在 Toast 上的工作方式 — 设置、切换提供商、禁用、重新启用以及故障排除。

注意：如果您想要 Toast 自有的第一方礼品卡或会员计划（而非第三方合作伙伴），请参阅 开始使用 Toast 礼品卡 或 开始使用 Toast 会员计划。

本文内容：

• 关于礼品卡和会员计划合作伙伴集成的简要说明
• 谁可以使用礼品卡和会员计划合作伙伴集成
• 所需模块、权限和硬件
• 工作原理
  • 设置合作伙伴礼品卡或会员计划集成
  • 在礼品卡或会员计划提供商之间切换
  • 在 Toast 上禁用或重新启用合作伙伴集成
  • 当出现故障时
• 已知限制
• 常见问题解答
  • 您的礼品卡或会员计划按钮未显示在 POS 上
  • 我可以同时运行两个礼品卡提供商吗？
  • 会员计划的 POS 工作流程是什么样的？
  • 礼品卡可以手动输入但无法成功刷卡
  • Toast 会员计划不断随机禁用
  • 我该如何确定礼品卡是否已被使用过？
  • 我可以将合作伙伴会员数据导入回 Toast 会员计划吗？
• 相关文章

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

Toast 与多家第三方礼品卡和会员（奖励）提供商合作——包括 Paytronix、Punchh、Como、Hang、Curate、Tacit、Peoplevine、Voucher Connect、Fishbowl、Incentivio 等——您可以直接通过 Toast 运行这些服务，而不是（或同时）使用 Toast 的自有计划。每个餐饮集团一次只能拥有一个有效的礼品卡提供商和一个有效的会员提供商。设置由您与合作伙伴发起，然后由合作伙伴联系 Toast 集成支持团队以完成后端配置。集成配置完成后，Toast POS 上会出现“礼品卡”和“奖励”按钮。

回到顶部

谁可以使用礼品卡和会员合作伙伴集成

Toast 合作伙伴礼品卡和会员集成适用于以下餐厅：

• 拥有第三方礼品卡或会员（奖励）合作伙伴的有效账户
• 为每个将使用该集成的地点拥有 Toast 合作伙伴集成访问权限（包含在 Restaurant Management Essentials 和 Restaurant Management Pro 套件中）
• 在 Toast Web 中拥有适当的用户权限以启用或禁用礼品卡和会员设置（见下文）

回到顶部

所需模块、权限和硬件

适用于：Toast Web, Toast POS

所需模块：

• 为每个将使用该集成的地点拥有 Toast 合作伙伴集成访问权限。包含在 Restaurant Management Essentials 或 Restaurant Management Pro 套件中。有关详细信息，请参阅 设置 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 后端启用该集成。

预期结果：发布更改后，礼品卡和会员计划按钮将出现在您礼品/会员组中每个地点的 Toast POS 上。如果它们未出现，请参阅 您的礼品卡或会员计划按钮未出现在 POS 上。

回到顶部

在礼品卡或会员计划提供商之间切换

餐厅通常会在四种方向之一中切换提供商。在下方找到您的场景。

如果您要从 Toast 礼品卡或 Toast 会员计划切换到第三方合作伙伴：

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

完整导出流程如下：

• 有关礼品卡，请参阅 导出 Toast 礼品卡数据以供第三方使用。
• 有关会员计划，请参阅 导出 Toast 会员计划数据以供第三方使用。

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

1. 请与当前合作伙伴及新合作伙伴协调，以便他们能够移交新合作伙伴所需的任何数据（会员余额、礼品卡余额等）。Toast 不执行此数据移交工作。
2. 按照 在 Toast 上禁用或重新启用合作伙伴集成 中的步骤，禁用 Toast 上当前的合作伙伴集成。
3. 按照 设置合作伙伴礼品卡或会员计划集成 中的步骤，开始新合作伙伴的设置。与新合作伙伴共享您的 Toast 餐厅 GUID。
4. 新合作伙伴联系 Toast 集成支持团队以完成后端配置。

预期结果：旧的合作伙伴集成将从您的 Toast 合作伙伴集成门户中移除，新合作伙伴将会显示，并且 POS 上的“礼品卡”和/或“奖励”按钮将反映新合作伙伴的信息。请预留时间让两个发布事件在各个地点同步完成。

如果您要从第三方合作伙伴切换回 Toast 礼品卡或 Toast 会员计划：

联系 Toast 客户服务部申请切换回原设置。在集团层面重新启用 Toast 礼品卡或 Toast 会员计划之前，必须先禁用您的合作伙伴集成。切换完成后，请参阅 Toast 礼品卡入门 或 Toast 会员计划入门 进行第一方设置。

如果您要将现有的合作伙伴集成扩展到 Toast 线上点餐 Pro：

在集成于 POS 上生效后，通过以下步骤将其扩展到 Toast 线上点餐 Pro：

• 对于会员计划，请遵循 Toast 线上点餐 Pro：启用第三方忠诚度计划。
• 对于礼品卡，请遵循 为在线订购 Pro 设置第三方礼品卡。在线订购 Pro 上的第三方礼品卡仅支持 Valutec、Paytronix、eCard Systems 和 Giftrocker 合作伙伴。

回到顶部

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

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

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

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

预期结果：在每个地点发布后，POS 上的“礼品卡”按钮将被移除（或恢复），并且与礼品卡合作伙伴的数据传输将停止或恢复。

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

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

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

注意：禁用合作伙伴礼品卡或会员计划集成属于集团层面的更改 — 它不会从您的 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 门店”
  • “我在新地点的 [partner] 集成无法正常工作”

POS 上缺少礼品卡或忠诚度按钮，最常见的原因是配置更改尚未发布到该地点，或者 POS 应用程序自集成启用以来尚未刷新。解决方法：

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

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

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

也问：

• • “是否可以在 TOAST 上同时运行 Valuetec 和 Paytronix 礼品卡？”

不可以——每个餐厅集团只能运行一个礼品卡提供商和一个忠诚度计划提供商。只能存在一个礼品卡和忠诚度组，并且“礼品卡设置”或“忠诚度设置”中的“已启用”设置在集团级别上对于不同提供商是互斥的。如果您需要切换提供商，请参阅 在礼品卡或忠诚度提供商之间切换。

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

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

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

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

Toast 会员计划不断随机禁用

也问：

• • “Toast 会员计划不断随机关闭”

Toast 会员计划不断随机禁用，最常见的原因是另一位拥有“营销信息”权限的用户在共享的多地点会员组上更改了“启用会员计划”设置，或者是因为某个已关闭的地点导致该设置发生变动。与 Toast 客户服务部发起聊天以进行调查，并在必要时限制权限。

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

要检查礼品卡是新的（需要激活）还是之前已售出（需要充值）：

1. 在 Toast POS 上，选择“礼品卡”，然后选择“余额查询”。
2. 刷卡或输入卡号以查询余额。
   • 如果 POS 显示余额，则说明该卡已被使用过——选择“添加金额”进行充值。
   • 如果 POS 显示“卡片未激活”错误，则该卡为新卡——选择“售卡”以激活它。

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

我可以将合作伙伴的会员数据导回 Toast 会员计划吗？

也问：

• • “我拥有来自 [partner] 的历史会员和营销信息，并希望将该信息导入 Toast 会员计划”

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

1. 以 CSV 格式从合作伙伴处导出您的会员数据。
2. 与 Toast 客户服务部发起聊天，并请求进行 Toast 会员计划数据导入。
3. 在收到提示时提供导出的 CSV 文件。客户服务部会将请求转交给负责会员数据导入的团队。

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

回到顶部

相关文章

• 设置 Toast 合作伙伴集成
• 添加或移除 Toast 合作伙伴集成
• 获取第三方礼品卡交易错误的帮助
• 查找我的餐厅的 GUID
• 服务中断和故障：Toast 会员计划和礼品卡

回到顶部