# LI.FI 已发送却没收到：核对状态、实际数量和退款

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/guides/lifi-status-actual-partial-refund-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

对已有 status 记录逐项查身份与执行腿，区分完成、部分完成、退款和仍未知。

## 使用工具
- [LI.FI](https://lianxiaozhi.com/tools/lifi) · [官方入口](https://li.fi/)

## 前置条件
- 准备原应用的 Step/桥名称、来源链/目标链、交易 hash 或 transactionId，以及已保存的 /v1/status 响应、浏览器交易记录和预期收款地址。
- 仅核对公开/已有记录；不用再次签名或重发。当前状态指南比参考 schema 的 FAILED 子状态更广，未知字段按原文保留。

## 1. 把查询标识与交易 hash 分开

记录原 /v1/status 查询的 txHash 参数和 fromChain/toChain/bridge。txHash 可承载发送 hash、接收 hash 或 transactionId；transactionId 是 LI.FI 转移 ID，不因此变成链上交易 hash。对普通同链兑换，两链应相同。

若现有查询遗漏来源链或填错桥，先说明查找范围；来源批准交易不能当桥接发送交易。记录 sending.txHash 与 receiving.txHash 各自链，不因两边都是 0x 就混在同一浏览器查。

核对结果：查询标识、来源执行和接收执行各有位置与网络。
依据：[LI.FI：状态、实际数量与未知交易](https://docs.li.fi/introduction/user-flows-and-examples/status-tracking.md)
依据：[LI.FI：GET status 方法和 optional quote](https://docs.li.fi/api-reference/check-the-status-of-a-cross-chain-transfer.md)

## 2. 保存 status 与 substatus 的组合

抄下 HTTP 状态、业务 status/substatus/substatusMessage 与取得时间。DONE+COMPLETED、DONE+PARTIAL、DONE+REFUNDED 分开；退款完成不是目标资产 fill，部分完成不能显示“全部收到”。

PENDING 的 WAIT_SOURCE_CONFIRMATIONS/WAIT_DESTINATION_TRANSACTION 是不同等待环节，BRIDGE_NOT_AVAILABLE/CHAIN_NOT_AVAILABLE 可能是外部查询不可用。FAILED 按原错误排查，REFUND_IN_PROGRESS 只是进行中。不要为兼容较窄 schema 丢掉指南的失败子状态。

核对结果：结论包含组合状态和时间，等待、查询失败、退款与成交分列。
依据：[LI.FI：状态、实际数量与未知交易](https://docs.li.fi/introduction/user-flows-and-examples/status-tracking.md)
依据：[LI.FI：GET status 方法和 optional quote](https://docs.li.fi/api-reference/check-the-status-of-a-cross-chain-transfer.md)

## 3. 复核来源成功与目标执行腿

打开已有记录中的 sending.txLink 或相应链浏览器，核对实际发送地址、资产、数量及交易状态；来源 reverted 是来源失败，来源成功只说明该腿执行，不等目标完成。确认数策略也需要按链和重组风险保留。

再核 receiving 的链、hash、收款人、token 身份与数量，查看已有目的链记录中的实际转移。receiving 缺失时标未取得，不能填零；中间桥接资产、退款和预期目标币不一致时逐项记账。

核对结果：两侧链上证据与平台状态可对齐，缺腿不会被当已到账或资产为零。
依据：[LI.FI：状态、实际数量与未知交易](https://docs.li.fi/introduction/user-flows-and-examples/status-tracking.md)
依据：[LI.FI：GET status 方法和 optional quote](https://docs.li.fi/api-reference/check-the-status-of-a-cross-chain-transfer.md)

## 4. 同一目标资产下比较报价和实际数量

若 status.quote 存在，比较 quote.estimate.toAmount/toAmountMin 与 receiving.amount，三者都是目标 Token 最小单位整数字符串；先确认 token/chain 相同再用 BigInt 作差。COMPLETED 不要求等于预计 toAmount，实际可不同而仍在底线之上。

quote 可在 PENDING 已存在，也可能因旧记录/合作方入库/无保存报价而缺失，均不能当结算错误。没有同币种或精度时停止数量差计算；官方样本中观察日期和 createdAt 年份不一致，样本不作为当前交易回执。

核对结果：同币种对账可复现，报价缺失与时间矛盾明示。
依据：[LI.FI：状态、实际数量与未知交易](https://docs.li.fi/introduction/user-flows-and-examples/status-tracking.md)
依据：[LI.FI：GET status 方法和 optional quote](https://docs.li.fi/api-reference/check-the-status-of-a-cross-chain-transfer.md)
依据：[LI.FI：GET quote 参数与 Step](https://docs.li.fi/api-reference/get-a-quote-for-a-token-transfer.md)

## 5. 遇到 404 或 NOT_FOUND 先保留未知

HTTP404/code1003 与 200/NOT_FOUND 都可能是索引延迟、错链、未挖或已替换，超时不是失败证明。先查已有来源 receipt/交易记录；原交易有 receipt 时判断成功或 revert，没有 receipt 仍可能 pending。

普通 EVM 替换只有找到同链、同 sender/nonce 的另一笔已挖交易，再验证 recipient/value/calldata 的实际意图才能绑定新 hash；nonce 增长、空 RPC 或“加速”名字都不够。取消交易不会完成跨链，非 EVM/账户抽象不套该 nonce 规则。

核对结果：无证据的查不到保留未决，未自动重发、绑定替换或宣称资金丢失。
依据：[LI.FI：状态、实际数量与未知交易](https://docs.li.fi/introduction/user-flows-and-examples/status-tracking.md)
依据：[LI.FI：GET status 方法和 optional quote](https://docs.li.fi/api-reference/check-the-status-of-a-cross-chain-transfer.md)

## 6. 给部分完成或退款形成追踪清单

PARTIAL/REFUNDED 时保存实际资产、网络、收款地址与 hash，核对是否还有目标兑换或退款步骤；失败代码如 OUT_OF_GAS/SLIPPAGE_EXCEEDED/NOT_PROCESSABLE_REFUND_NEEDED 只帮助定位，不能保证某桥自动退款或固定到账时间。

整理原 Step、查询参数、时间序列、两侧交易与数量差异给应用支持；已有数据缺少退款腿则标等待补证。即使停止自动轮询也保留上下文，避免把终止等待按钮当执行终态。

核对结果：输出已完成/部分/退款/未决四类结论与缺证清单。
依据：[LI.FI：状态、实际数量与未知交易](https://docs.li.fi/introduction/user-flows-and-examples/status-tracking.md)
依据：[LI.FI：GET status 方法和 optional quote](https://docs.li.fi/api-reference/check-the-status-of-a-cross-chain-transfer.md)

## 常见错误
- DONE 不等于目标币完整到账；查看 substatus 和真实资产。
- 404、等待时长和 nonce 增长均不单独证明失败或替换。
- 不跨币种直接比较报价与执行金额，不以美元估值证明数量一致。

## 完成检查
- 结论绑定原记录身份、执行腿、组合状态与同币种数量比较。
- 仅文档流程核验，未访问实际钱包/RPC/status；没有转移、退款或到账的行为验收。

## 相关知识
- [跨链显示已发送却未到账？来源交易、消息与目标执行分开查](https://lianxiaozhi.com/learn/bridge-transfer-status)
- [区块确认与最终性是什么？交易成功和充值到账为何不同步](https://lianxiaozhi.com/learn/confirmations-and-finality)
- [原始、解码和整理后的链上数据有什么区别？](https://lianxiaozhi.com/learn/raw-decoded-curated-data)

## 官方依据
- [LI.FI：状态、实际数量与未知交易](https://docs.li.fi/introduction/user-flows-and-examples/status-tracking.md)
- [LI.FI：GET status 方法和 optional quote](https://docs.li.fi/api-reference/check-the-status-of-a-cross-chain-transfer.md)
- [LI.FI：GET quote 参数与 Step](https://docs.li.fi/api-reference/get-a-quote-for-a-token-transfer.md)