> ## Documentation Index
> Fetch the complete documentation index at: https://docs.igamingace.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bonus Call Cancel

使用此接口可在奖励局自然结束前终止进行中的奖励局。取消奖励后，尚未使用的免费旋转次数或尚未派发的保底赢额将被没收。仅可取消当前仍处于进行中的奖励；若尝试取消已结束的奖励，将返回 `BONUSCALL_ALEADY_ENDED` 错误。

## Request

**Endpoint:** `POST /v1/bonus-call/cancel`

**Headers**

| Name            | Value                |
| :-------------- | :------------------- |
| `Authorization` | `Bearer <API_TOKEN>` |
| `Content-Type`  | `application/json`   |
| `Accept`        | `application/json`   |

### Request body

<ParamField body="playerId" type="string" required>
  玩家的唯一标识符。
</ParamField>

<ParamField body="issueId" type="long" required>
  要取消的奖励局唯一标识符，由 [Register Bonus](https://docs.igamingace.com/zh/mainapi/bonus-call-register) 接口返回。
</ParamField>

### Example request

```bash theme={null}
curl --request POST \
  --url https://api.igamingace.com/v1/bonus-call/cancel \
  --header 'Authorization: Bearer <API_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{
	"playerId": "player_88888",
    "issueId": 9887
  }'
```

<Warning>
  取消操作不可撤销。尚未进行的免费旋转，或尚未发放的保底赢额，均将被没收。代玩家取消前，请先与玩家确认。
</Warning>

***

## 奖励生命周期

奖励局会经历以下状态：

| 状态        | 说明                   | 可否取消？                             |
| :-------- | :------------------- | :-------------------------------- |
| Active    | 奖励已注册并等待触发，或当前正在进行中。 | Yes                               |
| Completed | 所有旋转已完成，或保底金额已派发。    | 不可以 — 返回 `BONUSCALL_ALEADY_ENDED` |

若尝试取消已完成的奖励，API 将返回错误码 `BONUSCALL_ALEADY_ENDED`。

***

## Response

<ResponseField name="success" type="boolean">
  奖励成功取消时为 `true`。
</ResponseField>

<ResponseField name="message" type="string">
  一段简短确认字符串，通常为 `"OK"`。
</ResponseField>

### Example response

```json theme={null}
{
  "success": true,
  "message": "OK"
}
```