# Mayan MPS已检测入金却未结算：核来源配置、重试与终止 整理：链小知（AI 辅助） 资料核对日期：2026-10-14 引用地址：https://lianxiaozhi.com/tools/guides/mayan-mps-settlement-retry-source-minimum-check 难度：进阶 核验方式：官方文档整理，未执行真实账户操作 用既有MPS回执解释最低额、queued:false、failed_swap/deferred和dead，区分检测、结算余额及普通交换退款。 ## 使用工具 - [Mayan Finance / MPS](https://lianxiaozhi.com/tools/mayan) · [官方入口](https://mayan.finance/) ## 前置条件 - 准备已有脱敏MPS quote/入金地址来源、deposit_detected、/source-config、/swaps导出和接收回执，带生成时间；不提供API key。 - 公开文档整理；未申请密钥、调用Quote/MPS/Explorer业务API、RPC或事件连接，也不创建地址、request-index、充值或退款。 ## 1. 固定MPS对象与链ID体系 MPS是入金地址结算服务；/swaps条目是一个钱包某币的settlement request，不保证一条等于一笔消费者付款。普通SDK交换/Explorer clientStatus是另一套状态，不混用。 来源chainId用Wormhole ID：Solana1、Ethereum2、Base30，不是EVM的Ethereum1或Base8453。协议链表支持方向另核；具体扫描自动来源要对照原source-config，不从GET /chains列所有目的/浏览器链推源检测可用。 核对结果：服务、钱包/币结算对象和Wormhole ID明确，方向范围未混用。 依据：[Mayan MPS：来源配置、金额快照与结算记录](https://docs.mayan.finance/payment-service/api-reference.md) 依据：[Mayan：Wormhole chain ID与方向支持](https://docs.mayan.finance/resources/chains-contracts.md) ## 2. 按source-config核资产和最小額单位 source-config.tokens列address、standard、minDeposit和decimals；minDeposit为人读币量，/swaps.amount通常为最小单位字符串或null。核原资产与单位，不能直接把1000000和minDeposit=3比较。 Solana SOL与WSOL是不同项/余额，原生SOL用系统程序地址、WSOL用其mint。低于token minimum或链级USD floor仍可能deposit_detected，但queued:false及ignoredReason=below_token_min/below_min表示未排结算，不等已付款成功。 核对结果：资产标准/地址、精度、最低额及检测/排队结果分开。 依据：[Mayan MPS：来源配置、金额快照与结算记录](https://docs.mayan.finance/payment-service/api-reference.md) ## 3. 先看排队标识和重复活动任务 原request-index响应可用queued、queueItemId、reason对应已有任务；already_queued表示该钱包该币已有活动结算，仍会取新的实时余额，不能当新重复订单或缺资产。below_token_min与below_min要分别核原配置。 自动扫描只检测白名单；其他资产需另核已有请求/策略，不由没事件判余额为0。未注册入金地址的404与缺钥匙401/无效403也不是未入账证明；本文不触发补索引。 核对结果：检测、已排/重复活动任务、最小额及访问错误分别记录。 依据：[Mayan MPS：来源配置、金额快照与结算记录](https://docs.mayan.finance/payment-service/api-reference.md) ## 4. 重试失败与terminal分开 EVM经deploy/swap，Solana经settle；failed_deploy、failed_swap、failed_settle和deferred均通常category=retrying、terminal=false。deferred代表暂时阻塞，不一定是链交易失败。 completed是success且error:null；dead是terminal失败。自动回退序列5s/15s/30s/45s/1m/5m/15m，7次尝试或非可重试错误可dead；原error.code、retryCount和retryable一起核，不按message文字或“failed”前缀提前认定全流程失败/退款。 核对结果：phase/category/terminal/status与error、retryCount有一致解释。 依据：[Mayan MPS：phase/category/terminal及重试状态](https://docs.mayan.finance/payment-service/statuses.md) 依据：[Mayan MPS：来源配置、金额快照与结算记录](https://docs.mayan.finance/payment-service/api-reference.md) ## 5. 核实际结算而不把amount快照当到账 /swaps.amount是best-effort快照，request-index结算可能null，执行时实际扫该钱包该币live balance。后续入金可被同一活动任务合并，不能只按快照金额履行单一订单或统计付款笔数。 swapTxHash定位结算交易，不直接替代目标收款资产/地址/最终结果。核destChain/destWallet/destToken及原接收回执。列表默认20最多100，nextCursor为创建时间的ISO游标；只一页或失败读取不证明全量。 核对结果：快照、结算对象、目标及接收证据能关联，列表范围可复原。 依据：[Mayan MPS：来源配置、金额快照与结算记录](https://docs.mayan.finance/payment-service/api-reference.md) 依据：[Mayan MPS：phase/category/terminal及重试状态](https://docs.mayan.finance/payment-service/statuses.md) ## 6. dead与普通交换退款各自留证 MPS dead只是停止自动转换，不是普通order已经REFUNDED。普通交换按deadline64逾期后可退款；Swift可能先换成USDC/ETH锁定，退回币未必最初输入，退款有refundRelayerFee等费用。 普通Explorer需clientStatus=REFUNDED及接收证据；不得把MPS error或deadline已经过写成退款成功。当前Swift协议费0与旧媒体约3bps不同，实际总成本还含具体路由/relayer/referrer费，未核回执时不算净到账。 核对结果：MPS终止、可退款边界、实际退款币与费用/接收结果分别说明。 依据：[Mayan：普通交换deadline、退款资产与费用](https://docs.mayan.finance/how-mayan-works/refunds.md) 依据：[Mayan：Swift协议费、其他费用及报价口径](https://docs.mayan.finance/build/fees-earning.md) 依据：[Mayan MPS：phase/category/terminal及重试状态](https://docs.mayan.finance/payment-service/statuses.md) ## 常见错误 - 当前MPS方法有据，不声称9月7日推出MPS；媒体速度/旧收费和统计量不做本任务实测或采用证明。 ## 完成检查 - 留下对象、输入、原回执、计算口径和未验证项；没有资料不补假值，也不操作账户或资金。 ## 相关知识 ## 官方依据 - [Mayan MPS：来源配置、金额快照与结算记录](https://docs.mayan.finance/payment-service/api-reference.md) - [Mayan：Wormhole chain ID与方向支持](https://docs.mayan.finance/resources/chains-contracts.md) - [Mayan MPS：phase/category/terminal及重试状态](https://docs.mayan.finance/payment-service/statuses.md) - [Mayan：普通交换deadline、退款资产与费用](https://docs.mayan.finance/how-mayan-works/refunds.md) - [Mayan：Swift协议费、其他费用及报价口径](https://docs.mayan.finance/build/fees-earning.md) - [Crypto Briefing：9月7日Mayan机制与集成评述（原体静态恢复）](https://cryptobriefing.com/mayan-20-billion-cross-chain-swaps-wormhole/)