> ## 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.

# 交易状态和子状态

> WaaS 2.0 API 中交易状态的指南，包括状态类型及其含义。

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

WaaS 2.0 定义了各种交易状态和子状态，以反映不同的处理阶段。本页面提供了所有状态的完整列表，并描述了根据每个状态可以执行的操作。

## 状态参考表格

### 充币交易

下表提供了 WaaS 2.0 服务中充币交易的状态及其对应的子状态的概述。

<table className="table-three-cols">
  <tr>
    <th>状态</th>
    <th>子状态</th>
    <th>描述</th>
  </tr>

  <tr>
    <td rowspan="2">PendingScreening（合规检查中）</td>
    <td>PendingScreeningAppCheck（等待 Screening App 检查）</td>
    <td>交易正在由 [Screening App](https://manuals.cobo.com/en/apps/screening/introduction) 审核。</td>
  </tr>

  <tr>
    <td>PendingCoboKYTCheck（等待 Cobo 审查）</td>
    <td>交易正在等待 Cobo 的 KYT 检查。</td>
  </tr>

  <tr>
    <td>Confirming（确认中）</td>
    <td>PendingBlockConfirmations（等待链上确认数）</td>
    <td>交易正在等待所需的确认数。</td>
  </tr>

  <tr>
    <td>Completed（已完成）</td>
    <td>N/A</td>
    <td>交易已完成。</td>
  </tr>

  <tr>
    <td rowspan="2">Rejected（已拒绝）</td>
    <td>RejectedByCoboKYT</td>
    <td>交易被拒绝，因为未通过 Cobo 的 KYT 检查。</td>
  </tr>

  <tr>
    <td>RejectedByScreeningApp</td>
    <td>交易被拒绝，因为未通过 Screening App 的检查。</td>
  </tr>
</table>

### 提币交易

下表提供了 WaaS 2.0 服务中提币交易的状态及其对应的子状态的概述。

<table className="table-three-cols">
  <tr>
    <th>状态</th>
    <th>子状态</th>
    <th>描述</th>
  </tr>

  <tr>
    <td rowspan="1">Submitted（已提交）</td>
    <td>N/A</td>
    <td>交易已提交。</td>
  </tr>

  <tr>
    <td rowspan="4">PendingScreening（合规检查中）</td>
    <td>PendingTravelRuleCheck（待 Travel Rule 审核）</td>
    <td>交易正在进行 Travel Rule 检查。</td>
  </tr>

  <tr>
    <td>PendingTravelRuleInfo（待提供 Travel Rule 信息）</td>
    <td>交易正在等待用户提供与 Travel Rule 相关的信息。</td>
  </tr>

  <tr>
    <td>PendingScreeningAppCheck（等待 Screening App 检查）</td>
    <td>交易正在由 [Screening App](https://manuals.cobo.com/cn/apps/screening/introduction) 审核。</td>
  </tr>

  <tr>
    <td>PendingCoboKYTCheck（等待 Cobo 审查）</td>
    <td>交易正在等待 Cobo 的 KYT 检查。</td>
  </tr>

  <tr>
    <td rowspan="5">PendingAuthorization（等待审批）</td>
    <td>PendingDoubleCheck（等待 MFA 认证）</td>
    <td>交易正在等待双重检查。</td>
  </tr>

  <tr>
    <td>PendingSpenderCheck（等待提币员审批）</td>
    <td>交易正在等待提币员检查。</td>
  </tr>

  <tr>
    <td>PendingRiskControlCheck（等待风控审批）</td>
    <td>交易正在等待风控检查。</td>
  </tr>

  <tr>
    <td>PendingApproverCheck（等待审批员审批）</td>
    <td>交易正在等待审批员的批准。</td>
  </tr>

  <tr>
    <td>PendingCoboCheck（待 Cobo 审核）</td>
    <td>交易正在等待 Cobo 的内部检查。</td>
  </tr>

  <tr>
    <td rowspan="11">PendingSignature（等待签名）</td>
    <td>Queued（排队中（请先处理待签交易））</td>
    <td>交易正在排队等待 Cobo Portal 处理。</td>
  </tr>

  <tr>
    <td>PendingWaitSigner（等待移动端签名人批准（1位签名人需在 Cobo Guard 中确认交易））</td>
    <td>交易正在等待签名人在 Cobo Guard 签名。</td>
  </tr>

  <tr>
    <td>InsufficientBalance（余额不足）</td>
    <td>由于余额不足，交易无法继续。请存入所需的代币或取消交易。</td>
  </tr>

  <tr>
    <td>InsufficientBalanceFundLocked（余额不足 - 资金已锁定）</td>
    <td>由于可用余额当前被锁定，交易无法继续。请等待可用余额解锁。</td>
  </tr>

  <tr>
    <td>PendingSystemProcessing（等待系统处理）</td>
    <td>交易已提交，正在等待区块链系统处理。</td>
  </tr>

  <tr>
    <td>SystemProcessingOngoing（系统处理中）</td>
    <td>区块链系统正在处理交易。</td>
  </tr>

  <tr>
    <td>Built（交易已构建）</td>
    <td>交易已构建但尚未签名。</td>
  </tr>

  <tr>
    <td>PendingSignerApproval（等待签名人批准）</td>
    <td>交易正在等待签名人的批准。</td>
  </tr>

  <tr>
    <td>PendingApprovalStart（等待签名人节点启动）</td>
    <td>交易审批正在等待开始。<ul><li>对于<a href="https://manuals.cobo.com/en/portal/mpc-wallets/ucw/introduction">MPC 钱包（终端用户钱包）</a>，您需要使用客户端 App 并调用 UCW SDK 以开始交易审批流程。</li><li>对于<a href="https://manuals.cobo.com/en/portal/mpc-wallets/ocw/introduction">MPC 钱包（机构控制钱包）</a>：<ul><li>如果您使用<a href="https://manuals.cobo.com/en/portal/mpc-wallets/ocw/create-key-share-groups">服务器端签名人</a>，此状态表示 TSS Node将很快请求回调服务器开始<a href="https://manuals.cobo.com/en/portal/risk-controls/introduction">风控策略</a>检查。在此阶段无需您采取进一步行动。</li><li>如果您使用<a href="https://manuals.cobo.com/en/portal/mpc-wallets/ocw/create-key-share-groups">移动端签名人</a>，私钥分片持有者需要使用他们的<a href="https://manuals.cobo.com/en/guard/introduction">Cobo Guard</a>批准交易并参与签名过程。</li></ul></li></ul></td>
  </tr>

  <tr>
    <td>PendingSignerProcessing（签名人签名中）</td>
    <td>交易正在签名中。</td>
  </tr>

  <tr>
    <td>SignatureVerificationSuccess（签名验证成功）</td>
    <td>交易的签名已成功验证。</td>
  </tr>

  <tr>
    <td>Broadcasting（广播中）</td>
    <td>FailedBroadcasting（广播失败，持续广播中）</td>
    <td>交易未能广播到区块链网络。</td>
  </tr>

  <tr>
    <td rowspan="2">Confirming（确认中）</td>
    <td>Reverting（正在回滚）</td>
    <td>由于区块链上的失败，交易正在回退（Revert）。</td>
  </tr>

  <tr>
    <td>PendingBlockConfirmations（等待链上确认数）</td>
    <td>交易正在等待所需数量的确认。</td>
  </tr>

  <tr>
    <td rowspan="1">Completed（已完成）</td>
    <td>N/A</td>
    <td>交易已完成。</td>
  </tr>

  <tr>
    <td rowspan="6">Failed（失败）</td>
    <td>FailedBySigner（签名人操作失败）</td>
    <td>交易在签名过程中失败。</td>
  </tr>

  <tr>
    <td>FailedOnChain（交易链上失败）</td>
    <td>交易在区块链上失败。</td>
  </tr>

  <tr>
    <td>ReplacedByNewTransaction（被新交易取代）</td>
    <td>原交易被新交易替换（通过 Replace-By-Fee（RBF）机制实现）。</td>
  </tr>

  <tr>
    <td>SignatureVerificationFailed（签名失败）</td>
    <td>交易的签名验证失败。</td>
  </tr>

  <tr>
    <td>FailedSignerTimeout（签名人超时）</td>
    <td>交易由于签名超时而失败。</td>
  </tr>

  <tr>
    <td>ReOrged（已重组）</td>
    <td>交易因区块链重组而失败。</td>
  </tr>

  <tr>
    <td rowspan="18">Rejected（已拒绝）</td>
    <td>RejectedWhiteList（未通过白名单审批）</td>
    <td>交易被拒绝，因为发起者的 IP 地址不在白名单中。</td>
  </tr>

  <tr>
    <td>RejectedKYT（因 KYT 被拒绝）</td>
    <td>交易被拒绝，因为未通过 KYT 合规检查。</td>
  </tr>

  <tr>
    <td>RejectedRiskControlCheck（未通过风控审批）</td>
    <td>交易被拒绝，因为未通过风控策略检查。</td>
  </tr>

  <tr>
    <td>RejectedSpenderAuth（未通过提币员审批）</td>
    <td>交易被提币员拒绝。</td>
  </tr>

  <tr>
    <td>RejectedApproverAuth（未通过审批员审批）</td>
    <td>交易被审批员拒绝。</td>
  </tr>

  <tr>
    <td>RejectedDoubleCheck（未通过 MFA 认证）</td>
    <td>交易被拒绝，因为未通过双重检查。</td>
  </tr>

  <tr>
    <td>RejectedbyMobileCosigner（被移动端签名人拒绝）</td>
    <td>交易被移动端签名人拒绝。</td>
  </tr>

  <tr>
    <td>RejectedCoboCheck（未通过 Cobo 审批）</td>
    <td>交易被拒绝，因为未通过Cobo的内部检查。</td>
  </tr>

  <tr>
    <td>RejectedByScreeningApp（被 Screening App 拒绝）</td>
    <td>交易被 [Screening App](https://manuals.cobo.com/cn/apps/screening/introduction) 拒绝。</td>
  </tr>

  <tr>
    <td>RejectedTravelRuleDueToUnsupportedToken（因不支持的代币被 Travel Rule 拒绝）</td>
    <td>交易被拒绝，因为该代币不支持 Travel Rule。</td>
  </tr>

  <tr>
    <td>RejectedTravelRule（因国际转账规则被拒绝）</td>
    <td>交易被拒绝，因为未能遵守 Travel Rule。</td>
  </tr>

  <tr>
    <td>RejectedTravelRuleDueToCompliance（因合规要求被 Travel Rule 拒绝）</td>
    <td>交易被拒绝，因为未通过 Travel Rule 的交叉检查。</td>
  </tr>

  <tr>
    <td>RejectedTransactionPolicy（被交易风控规则拒绝）</td>
    <td>交易被拒绝，因为未通过交易风控。</td>
  </tr>

  <tr>
    <td>RejectedBySigner（被签名人拒绝）</td>
    <td>交易被拒绝，因为被签名人拒绝。</td>
  </tr>

  <tr>
    <td>CanceledBySpender（被提币员取消）</td>
    <td>交易被提币员取消。</td>
  </tr>

  <tr>
    <td>CanceledByAPI（被 API 接口取消）</td>
    <td>交易被[取消交易](https://www.cobo.com/developers/v2/api-references/transactions/cancel-transaction)操作取消。</td>
  </tr>

  <tr>
    <td>OnchainRejection（链上拒绝）</td>
    <td>交易被拒绝添加到区块链中。</td>
  </tr>

  <tr>
    <td>RejectedByCobo（被 Cobo 拒绝）</td>
    <td>交易被 Cobo 拒绝，可能由于未满足相关的合规要求。您可以联系我们的[客户支持团队](mailto:help@cobo.com)获取更多详情。</td>
  </tr>

  <tr>
    <td rowspan="1">Pending（等待中）</td>
    <td>N/A</td>
    <td>交易正在等待被包含在区块中。</td>
  </tr>
</table>

## 状态详情

<Note>
  `PendingAuthorization` 状态同时涵盖人工审批步骤和内部自动检查。人工步骤包括 `PendingApproverCheck`、`PendingSpenderCheck` 和 `PendingDoubleCheck`。自动检查包括 `PendingRiskControlCheck` 和 `PendingCoboCheck`。处于 `PendingAuthorization` 状态并不一定需要人工操作，因为交易可能正在进行自动风控或合规检查。
</Note>

<Warning>
  交易经审批通过后会进入 `PendingSignature` 状态，并且必须在有限的签名时间窗口内由 MPC 签名人组完成签名。如果未能在时间窗口内完成签名，交易将自动失败并转入 `Failed` 状态，子状态为 `FailedSignerTimeout`。如需确认交易失败原因，请查看 [List all transactions](/developers/v2/api-references/transactions/list-all-transactions) 或 [Get transaction information](/developers/v2/api-references/transactions/get-transaction-information) 返回的 `sub_status` 字段。如果遇到 `FailedSignerTimeout`，该交易已处于终态 `Failed`，无法恢复。请按原交易类型重新发起一笔新交易：代币转账使用 [Transfer token](/developers/v2/api-references/transactions/transfer-token)，合约调用使用 [Call smart contract](/developers/v2/api-references/transactions/call-smart-contract)，消息签名使用 [Sign message](/developers/v2/api-references/transactions/sign-message)。
</Warning>

<Note>
  处于 `Confirming` 状态且子状态为 `PendingBlockConfirmations` 的交易，正在等待其所在链所需数量的区块确认。这是正常处理过程的一部分，并不表示交易卡住。所需的确认数量和预计确认时间因链而异。
</Note>

## 可用操作

您可以根据交易状态执行以下操作：

* 如果交易状态是以下之一，您可以取消交易：
  * `Submitted`
  * `PendingScreening`
  * `PendingAuthorization`
  * `PendingSignature`（仅当子状态为 `Queue`, `InsufficientBalance`, `InsufficientBalanceFundLocked`, `PendingSignerApproval`, `PendingSystemProcessing`, 或 `Built` 时）
* 如果交易状态是 `Failed`，您可以重发交易。
* 如果交易状态是 `Broadcasting`，您可以加速或放弃交易。

有关被替换交易的状态如何变化的详细信息，请参阅 [RBF (Replace-By-Fee) 交易生命周期](/developers/v2_cn/guides/transactions/rbf-transaction-lifecycle)。

有关详细信息，请参阅[管理交易](/developers/v2_cn/guides/transactions/manage-transactions)。
