奖金记录

支持奖金入账的端点是支持 Fast Track 基本集成的必要条件。如何发送这些端点的说明如下所列。

奖金服务采用**"至少一次"交付语义设计。 这意味着该服务将始终尝试至少一次**发送每个奖金事件。例如，如果运营商 API 响应 500 错误，奖金服务将重试发送事件直到成功。
为了确保您端的幂等性，我们建议使用 Fast Track 发送的每个请求中包含的 x-fasttrack-id 标头。
此标头为每个奖金事件提供唯一标识符，允许您安全地处理重试而不会重复奖金处理。

⬆️ POST /bonus/credit

运营商需要向 Fast Track 提供奖金入账端点，以确保 FT CRM 能够自动化奖金入账。
这应该立即激活或使玩家有资格获得奖金。这取决于运营商如何处理与其玩家的奖金交互。

注意事项

  1. 例如，如果玩家需要在网站上选择加入奖金，此端点应使玩家有资格选择加入。其余逻辑应由运营商处理
  2. 可以添加新字段从 FT CRM 传递给运营商（例如 validity_amount）。

请求

响应代码

200 OK - FT 收到运营商 API 确认奖金已被接受。
40X ERROR - 这意味着运营商 api 已响应，但无法将奖金入账给玩家。这被归类为失败操作。
50X ERROR - 这是服务器错误，运营商 api 未响应。FT 将继续尝试通过 FT 内置的重试机制入账奖金。请参考页面顶部描述的幂等性检查。

⬇️ GET /bonus/list

此端点可以通过从运营商加载可用奖金列表来帮助改进设置奖金活动的流程。通过在字段配置中选择_动态下拉菜单_，此下拉菜单可以随时在后台手动添加。

响应

载荷区分大小写，请确保载荷与以下示例对齐。
200 OK
ERROR

⬆️ POST /bonus/credit/funds

此端点可用于立即向玩家钱包入账资金。 使用示例是能够自动化现金返还的入账。

请求

响应代码

200 OK - FT 收到运营商 API 确认奖金已被接受。
40X ERROR - 这意味着运营商 api 已响应，但无法将奖金入账给玩家。这被归类为失败操作。
50X ERROR - 这是服务器错误，运营商 api 未响应。FT 将继续尝试通过 FT 内置的重试机制入账奖金。请参考页面顶部描述的幂等性检查。

​📈‍ 奖金报告

Fast Track 将在针对您的运营商 API 的所有传出请求中包含以下标头。这些应该被存储并在奖金事件中发送回来，这将允许最终用户在 Fast Track Data Studio 中查看每个活动的奖金成本报告。
每个标头的描述： X-Fasttrack-Actioncommunicationprofileid = 使用的通信配置文件（翻译） X-Fasttrack-Actiongroupid = 包含操作的操作组 X-Fasttrack-Actionid = 操作的 Id（例如发送短信或奖金入账） X-Fasttrack-Activityid = 活动本身的 Id X-Fasttrack-Id = 每个触发器、每个用户的唯一 Id X-Fasttrack-Triggerhash = Triggerhash 用于识别来自同一事件的唯一发送。即您应该只收到一个具有相同 activity_id、action_id、user_id 和 Triggerhash 的操作。如果您使用基于时间的活动来定位比如 100 个玩家，所有这 100 个玩家将具有相同的 activity_id、action_id 和 Triggerhash。