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

# Webhook 事件类型和数据类型

> WaaS 2.0 中 Webhook 事件类型的综合列表，详细说明每个事件的目的和数据结构。

<Tip>
  即刻安装 [Cobo WaaS Skill](/developers/v2_cn/guides/overview/cobo-waas-skill)，在 Claude Code、Cursor 等 AI 开发环境中使用自然语言集成 WaaS API，显著提升开发效率 🚀
</Tip>

## Webhook 事件类型

可用的 webhook 事件类型如下：

<Info>本文所指交易为所有类型的交易，包括转账，合约调用和消息签名。</Info>

### 支付相关事件

支付相关的 Webhook 事件，请参考[事件与状态](/developers/v2_cn/payments/status-and-events)。

### 交易类事件（充币/提币/合约调用/消息签名）

<Note>以下事件适用于所有类型的交易，包括充币、提币、合约调用以及消息签名等。</Note>

<table class="table-three-cols">
  <thead>
    <tr>
      <th>事件类型</th>
      <th>事件数据类型</th>
      <th>发生时机</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>wallets.transaction.created</code></td>
      <td><code>Transaction</code></td>
      <td>在区块链上检测到交易并生成记录。此事件不代表交易已成功。</td>
    </tr>

    <tr>
      <td><code>wallets.transaction.updated</code></td>
      <td><code>Transaction</code></td>
      <td>交易的状态或确认数发生变化。<Note>`wallets.transaction.updated` 涵盖交易的整个生命周期，包括创建、完成和失败。如果您想跟踪每个状态变化，订阅此事件即可。</Note></td>
    </tr>

    <tr>
      <td><code>wallets.transaction.succeeded</code></td>
      <td><code>Transaction</code></td>
      <td>交易已成功完成。</td>
    </tr>

    <tr>
      <td><code>wallets.transaction.failed</code></td>
      <td><code>Transaction</code></td>
      <td>交易失败。</td>
    </tr>

    <tr>
      <td><code>token.suspended.deposit</code></td>
      <td><code>SuspendedToken</code></td>
      <td>充币已暂停。</td>
    </tr>

    <tr>
      <td><code>token.suspended.withdraw</code></td>
      <td><code>SuspendedToken</code></td>
      <td>提币已暂停。</td>
    </tr>
  </tbody>
</table>

### Fee Station 相关事件

<table class="table-three-cols">
  <thead>
    <tr>
      <th>事件类型</th>
      <th>事件数据类型</th>
      <th>发生时机</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>fee\_station.transaction.created</code></td>
      <td><code>Transaction</code></td>
      <td>Fee Station 交易已创建。</td>
    </tr>

    <tr>
      <td><code>fee\_station.transaction.updated</code></td>
      <td><code>Transaction</code></td>
      <td>Fee Station 交易的状态发生变化。</td>
    </tr>

    <tr>
      <td><code>fee\_station.transaction.failed</code></td>
      <td><code>Transaction</code></td>
      <td>Fee Station 交易失败。</td>
    </tr>

    <tr>
      <td><code>fee\_station.transaction.succeeded</code></td>
      <td><code>Transaction</code></td>
      <td>Fee Station 交易已完成。</td>
    </tr>
  </tbody>
</table>

### MPC 钱包 TSS 请求事件

<table class="table-three-cols">
  <thead>
    <tr>
      <th>事件类型</th>
      <th>事件数据类型</th>
      <th>发生时机</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>wallets.mpc.tss\_request.created</code></td>
      <td><code>TSSRequest</code></td>
      <td>创建了 TSS 请求。</td>
    </tr>

    <tr>
      <td><code>wallets.mpc.tss\_request.updated</code></td>
      <td><code>TSSRequest</code></td>
      <td>TSS 请求的状态发生变化。</td>
    </tr>

    <tr>
      <td><code>wallets.mpc.tss\_request.succeeded</code></td>
      <td><code>TSSRequest</code></td>
      <td>请求的操作已完成。</td>
    </tr>

    <tr>
      <td><code>wallets.mpc.tss\_request.failed</code></td>
      <td><code>TSSRequest</code></td>
      <td>请求的操作失败。</td>
    </tr>
  </tbody>
</table>

### 钱包与地址管理事件

<table class="table-three-cols">
  <thead>
    <tr>
      <th>事件类型</th>
      <th>事件数据类型</th>
      <th>发生时机</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>wallets.addresses.created</code></td>
      <td><code>Addresses</code></td>
      <td>已创建新的钱包地址。</td>
    </tr>

    <tr>
      <td><code>wallets.created</code></td>
      <td><code>WalletInfo</code></td>
      <td>已创建新的钱包。</td>
    </tr>

    <tr>
      <td><code>mpc\_vaults.created</code></td>
      <td><code>MPCVault</code></td>
      <td>已创建新的 MPC Vault。</td>
    </tr>
  </tbody>
</table>

<Note>激活 Solana 代币子地址（Associated Token Account）不会触发 `wallets.addresses.created` 事件。为激活该地址而发生的租金转账也不会触发任何 `wallets.transaction.*` 事件，且不会生成充币或交易记录。因此，Solana 代币账户的激活及其租金无法通过 webhook 感知。详情请参阅 [Solana 代币账户租金](/developers/v2_cn/guides/transactions/solana-token-account-rent)。</Note>

### 代币与链管理事件

<table class="table-three-cols">
  <thead>
    <tr>
      <th>事件类型</th>
      <th>事件数据类型</th>
      <th>发生时机</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>wallet.token.enabled</code></td>
      <td><code>Tokens</code></td>
      <td>一种或多种代币已被启用。</td>
    </tr>

    <tr>
      <td><code>wallet.token.disabled</code></td>
      <td><code>Tokens</code></td>
      <td>一种或多种代币已被禁用。</td>
    </tr>

    <tr>
      <td><code>wallet.chain.enabled</code></td>
      <td><code>Chains</code></td>
      <td>一条或多条链已被启用。</td>
    </tr>

    <tr>
      <td><code>wallet.chain.disabled</code></td>
      <td><code>Chains</code></td>
      <td>一条或多条链已被禁用。</td>
    </tr>

    <tr>
      <td><code>wallets.token\_listing.failed</code></td>
      <td><code>TokenListing</code></td>
      <td>上币请求失败。</td>
    </tr>

    <tr>
      <td><code>wallets.token\_listing.succeeded</code></td>
      <td><code>TokenListing</code></td>
      <td>上币请求已成功处理，代币当前已可用。</td>
    </tr>
  </tbody>
</table>

### 余额更新事件

<table class="table-three-cols">
  <thead>
    <tr>
      <th>事件类型</th>
      <th>事件数据类型</th>
      <th>发生时机</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>wallet.mpc.balance.updated</code></td>
      <td><code>BalanceUpdateInfo</code></td>
      <td>MPC 钱包余额更新。</td>
    </tr>

    <tr>
      <td><code>wallet.web3.balance.updated</code></td>
      <td><code>BalanceUpdateInfo</code></td>
      <td>全托管钱包（Web3 钱包）余额更新。</td>
    </tr>
  </tbody>
</table>

### 合规事件

<table class="table-three-cols">
  <thead>
    <tr>
      <th>事件类型</th>
      <th>事件数据类型</th>
      <th>发生时机</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>compliance.disposition.status.updated</code></td>
      <td><code>ComplianceDisposition</code></td>
      <td>合规处置的状态发生变化。</td>
    </tr>

    <tr>
      <td><code>compliance.kyt.screenings.status.updated</code></td>
      <td><code>ComplianceKytScreenings</code></td>
      <td>KYT 扫描的状态发生变化。</td>
    </tr>
  </tbody>
</table>

### `ComplianceKytScreenings` 事件数据

`compliance.kyt.screenings.status.updated` 事件携带 `ComplianceKytScreenings` 负载（`KytScreeningsEventData`）。该负载报告两个独立的状态字段 `review_status` 和 `funds_status`。请分别跟踪它们：`review_status` 反映案件的扫描与审核进度，`funds_status` 反映相关资金的状态。

**`review_status`（`ReviewStatusType`）**

| 值                  | 含义                         |
| ------------------ | -------------------------- |
| `PendingScreening` | 扫描案件已创建，正在等待 AML/KYT 扫描运行。 |
| `Screened`         | 案件的 AML/KYT 扫描已完成。         |
| `PendingDecision`  | 扫描已完成，案件正在等待决策。            |
| `PendingReview`    | 案件在做出决策前需要人工审核。            |
| `Approved`         | 案件已批准。                     |
| `Rejected`         | 案件已拒绝。                     |
| `Unsupported`      | 案件涉及扫描不支持的链或代币。            |
| `Bypassed`         | 案件的扫描已被跳过。                 |

**`funds_status`（`FundsStatusType`）**

| 值                  | 含义                  |
| ------------------ | ------------------- |
| `Frozen`           | 相关资金已被冻结。           |
| `Refunding`        | 资金退款正在进行中。          |
| `Refunded`         | 资金已退款。              |
| `RefundFailed`     | 退款尝试失败。             |
| `Unfreezing`       | 资金正在解冻中。            |
| `Unfrozen`         | 资金已解冻。              |
| `UnfreezingFailed` | 资金解冻尝试失败。           |
| `Isolating`        | 资金正在隔离中。            |
| `Isolated`         | 资金已隔离。              |
| `IsolationFailed`  | 资金隔离尝试失败。           |
| `CoboDisposition`  | 资金正在通过 Cobo 处置进行处理。 |
| `Normal`           | 资金处于正常状态，未应用任何合规操作。 |

驱动这些状态变化的案件决策由 `KytScreeningsDecisionsType` 表示，其取值包括 `Approval`、`ApprovalWithAlert`、`Rejection` 和 `ManualReview`。

## Webhook 事件数据结构

有关 webhook 事件数据和其数据结构的完整介绍，请参阅 Retrieve event information 操作的响应中的 [data](/developers/v2/api-references/developers--webhooks/retrieve-event-information#response-data) 属性或 List all webhook events 操作的响应中的 [data.data](/developers/v2/api-references/developers--webhooks/list-all-webhook-events#response-data-data) 属性。

<img src="https://mintcdn.com/cobo-docs/jI6Qi6XMVoZeeN6L/v2/images/guides/webhook_data_structure.png?fit=max&auto=format&n=jI6Qi6XMVoZeeN6L&q=85&s=25f0b10d3c17b3f44daba0daa215179c" className="screenshot_full_screen" alt="Webhook 数据结构截图" width="2816" height="1557" data-path="v2/images/guides/webhook_data_structure.png" />

您可以在事件数据类型之间切换来查看每个事件数据类型的数据结构。

另外，您可以在 **Cobo Portal** > **开发者** > **Webhook 事件** 中查看团队中的所有 webhook 事件。