# CoinPayments 已转账却没完成？核对稳定币网络、超时与退款

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

适用于 NEW 平台已有账单；区分窗口内转出与按时确认、paid 与 completed，以及需要领取的自动退款。

## 使用工具
- [CoinPayments 商户账单](https://lianxiaozhi.com/tools/coinpayments) · [官方入口](https://www.coinpayments.net/)

## 前置条件
- 准备商户订单号、已有 hosted invoice/checkout 链接、原交易网络和哈希；商户可用已有业务账户订单记录。这里的状态流程适用于 NEW Invoices，不适用于 Legacy 或永久地址自定义收款。

## 1. 先确认平台版本与正确地区实例

打开商户给出的已有账单；商户应先确认所在 NEW Dashboard 实例和企业注册地匹配，A/B/C 的订单与接口配置不可混用。只有 Personal 账户而找不到 Invoicing 时，先查账户类型：商业账单属于 Business 功能并有核验要求；不要为排查订单去切换到 Legacy 或不相关实例。

核对结果：已标明 NEW、对应企业实例和同一订单记录，未把不存在的跨实例订单当丢款。
依据：[CoinPayments：NEW 与 Legacy、实例边界](https://docs.coinpayments.net/api/)
依据：[CoinPayments：地区实例选择](https://docs.coinpayments.net/instances/)
依据：[CoinPayments：账户类型、核验与付款设置](https://docs.coinpayments.net/knowledge/integration-guide/account-setup/)

## 2. 从已有账单进入付款窗口查看完整币种

已有 hosted invoice 的 Pay using CoinPayments 按钮进入 checkout。记下加密币种代码、网络、地址和 crypto amount；例如公开费用正文写 USDC.SOL/USDT.SOL，不能去掉 .SOL 后当任意链稳定币。支持币种页面的总数量和费表例子都不能替代该商户实际 checkout 可选项；没有目标网络时暂停，向商户确认。

核对结果：订单的币种代码与发送钱包网络一致，并记录完整应付加密数量。
依据：[CoinPayments：账单与地址收款两种路径](https://docs.coinpayments.net/knowledge/integration-options/)
依据：[CoinPayments：商户处理、结算与钱包费用](https://www.coinpayments.net/help-fees)

## 3. 计算当前窗口而非只看发送时间

NEW checkout 从打开时锁汇60分钟，需要资金在窗口内被接收并达到要求确认。查看倒计时与原交易确认进度；59分钟时广播但确认在截止后，仍会 timedOut。只有尚未发送的过期流程，才按官方说明关闭并重新打开 checkout 获取新报价；已经发送则先处理原笔，不因刷新页面再付一次。

核对结果：发送时间、检测时间与确认时间分开核对，明确是否已有原交易。
依据：[CoinPayments：60分钟汇率锁定与迟到付款](https://docs.coinpayments.net/api/invoices/payment-timeout/)

## 4. 等 completed，再对账商户余额

查看已有订单详情：pending 为等待链上确认；paid 是平台已持有而尚未记入商户余额，官方明确不能据此发货；completed 才是成功终态。已有技术日志应区分账单状态与单笔 payment 状态；REST 常见 completed 与通知 Completed 大小写不同。银行/钱包最终结算又是另一环节，不用链上成功截图代替商户账单完成。

核对结果：订单达到 completed 且商户余额对应，不把 paid 或单笔 confirmed 直接当履约结果。
依据：[CoinPayments：账单状态与发货条件](https://docs.coinpayments.net/api/invoices/statuses/)
依据：[CoinPayments：账户类型、核验与付款设置](https://docs.coinpayments.net/knowledge/integration-guide/account-setup/)

## 5. 排查 Partially Paid 与多付余款

Partially Paid 时比较 checkout 的加密数量与实际接收量，法币显示不含所需网络费。未过期且仍允许补款时只用同币同链核对剩余额；也可联系商户决定是否接受少付。商户已有 Payment Settings 可查看容差，固定值和百分比同时设置取较小值；Accept Partial Payment 会改变订单状态，属于商户实际接受短款的决定。多付订单可完成，但余款进入退款流程。

核对结果：少付原因、当前补款条件与商户接受决定有记录；多付余款不误算为商户收入。
依据：[CoinPayments：少付、多付与领取退款](https://docs.coinpayments.net/api/invoices/payment-errors/)
依据：[CoinPayments：账户类型、核验与付款设置](https://docs.coinpayments.net/knowledge/integration-guide/account-setup/)

## 6. 核对退款领取与结算费用

迟到、确认超时或少付到期按官方自动退款流程处理；自动触发不等于地址已经到账，买家还需在关联订单的 New Refund Available 通知中进入 Claim Refund，提供原付款链的可收款地址。先核对净额：退款扣链上费，多付余款低于退款网络费不会发出。商户费页 To Balance 为3%，ASAP 每笔与 Nightly 批次另有网络费，不能沿用旧0.5%报价；地区与商户定价以当前协议为准。

核对结果：退款已触发、已领取、已广播、已到账各有证据，费用模式和净退款可解释。
依据：[CoinPayments：少付、多付与领取退款](https://docs.coinpayments.net/api/invoices/payment-errors/)
依据：[CoinPayments：商户处理、结算与钱包费用](https://www.coinpayments.net/help-fees)
依据：[CoinPayments：当前地区准入限制](https://www.coinpayments.net/legal)

## 常见错误
- 套用 Legacy 状态数字或永久地址自定义收款流程到 NEW Invoice。
- 以钱包已转出证明在60分钟内确认，或把自动退款通知当最终到账。

## 完成检查
- 能定位到网络/数量、确认超时、商户记账或退款领取哪个阶段；尚无确认数据保留待查。
- 仅文档核验，未认证请求、调整容差、接受短款、发币或提交退款地址。

## 相关知识
- [区块确认与最终性是什么？交易成功和充值到账为何不同步](https://lianxiaozhi.com/learn/confirmations-and-finality)
- [原生 USDC 与桥接 USDC 有什么区别？先核对发行与兑付路径](https://lianxiaozhi.com/learn/native-usdc-and-bridged-usdc)

## 官方依据
- [CoinPayments：账单与地址收款两种路径](https://docs.coinpayments.net/knowledge/integration-options/)
- [CoinPayments：地区实例选择](https://docs.coinpayments.net/instances/)
- [CoinPayments：NEW 与 Legacy、实例边界](https://docs.coinpayments.net/api/)
- [CoinPayments：账户类型、核验与付款设置](https://docs.coinpayments.net/knowledge/integration-guide/account-setup/)
- [CoinPayments：60分钟汇率锁定与迟到付款](https://docs.coinpayments.net/api/invoices/payment-timeout/)
- [CoinPayments：账单状态与发货条件](https://docs.coinpayments.net/api/invoices/statuses/)
- [CoinPayments：少付、多付与领取退款](https://docs.coinpayments.net/api/invoices/payment-errors/)
- [CoinPayments：商户处理、结算与钱包费用](https://www.coinpayments.net/help-fees)
- [CoinPayments：当前地区准入限制](https://www.coinpayments.net/legal)