对局结束通知

由商户实现，平台调用

POST {MERCHANT_URL}/v1/round-events，使用交付的 secret 签名，Idempotency-Key 等于 event_id。

一局游戏结束时，平台发送本通知。单一钱包商户必须实现；转账钱包商户登记了回调地址时也会收到。

这是非资金事件，不带金额。它不表示玩家退出游戏，也不表示这局所有资金都已结清——之后仍可能到达这一局的派奖或退款。商户可以用它来触发对账、刷新余额展示等。

请求参数（body）

参数	必填	类型	说明
event_id	是	string	事件 ID，永久唯一，商户按它去重
external_player_id	是	string	商户侧玩家 ID
currency	是	string	币种代码
round_id	是	string	对局 ID，与资金请求中的 round_id 一致
parent_round_id	否	string	免费局等子局所属的父局
type	是	string	固定为 ROUND_ENDED
occurred_at	是	string	对局结束时间，UTC RFC3339

{
  "event_id": "0192f6e3-5d6c-7f80-a1b2-8c9d0e1f2a3b",
  "external_player_id": "merchant-user-1",
  "currency": "USD",
  "round_id": "r-20260923-000123",
  "type": "ROUND_ENDED",
  "occurred_at": "2026-09-23T08:00:05Z"
}

输掉的一局只有 BET 没有 PAYOUT，结束时同样会发送本通知。

成功响应 200

字段	类型	说明
event_id	string	与请求相同
accepted_at	string	商户接收时间，UTC RFC3339

{
  "data": { "event_id": "0192f6e3-5d6c-7f80-a1b2-8c9d0e1f2a3b", "accepted_at": "2026-09-23T08:00:05Z" },
  "request_id": "b3f1c2d4-round-0001"
}

重复通知

同一个 event_id 再次到达时，返回首次的接受结果。没有返回 200 时，平台按重试节奏用同一个 event_id 重发。