在加密货币支付领域，发票（Invoice）是商户向客户发起支付请求的核心工具。它关联了唯一的加密货币地址与特定支付金额，并在有效期内等待支付完成。本文将深入解析加密货币发票的工作原理、状态变化机制及各类异常情况的处理方法，助您高效集成加密货币支付功能。
什么是加密货币发票？
加密货币发票是一种数字支付请求，其核心包含两个要素：
- 唯一加密货币地址：每个发票会为支持的加密货币生成专属收款地址，用于匹配客户付款。
- 指定支付金额：金额可设定为加密货币本身或法币价值，系统将按实时汇率自动换算。
由于加密货币支付通过独立网络进行，发票系统通过监控专属地址来识别入账交易。每张发票均具备生命周期状态，并通过回调机制实时通知商户状态变更。
加密货币发票的工作原理
支付流程与状态变更
- 发票创建：商户生成发票后，系统立即开始监控其关联的加密货币地址。
- 交易识别：当客户发起支付，系统捕获到未确认交易时，发送
transaction_created回调事件。 - 交易确认：网络验证并通过交易后，系统发送
transaction_confirmed回调，发票状态由new自动更新为completed。
有效期与汇率机制
每张发票默认有效期为10分钟。此限制源于汇率锁定机制：Cryptopay 会在发票创建时冻结当前汇率，确保10分钟内付款金额恒定。若超时未支付，发票即失效。
异常支付场景与处理方案
逾期支付（Paid Late）
客户在发票过期后付款，发票状态将变为 unresolved，并标记 paid_late 上下文。商户可根据实际情况手动处理，或依赖自动化规则更新状态。
支付金额异常
- 超额支付（Overpaid）：付款金额高于发票要求，状态标记为
overpaid。 - 不足支付（Underpaid）：付款金额未达发票要求，状态标记为
underpaid。
此类异常均触发 unresolved 状态，需商户介入处理。您可通过集成面板中的“未解决发票处理规则”配置自动化策略，系统将在交易确认后按预设规则更新状态（如自动完成或退款）。
回调机制：实时获取支付状态
Cryptopay 通过回调URL主动推送状态变更事件。关键回调包括：
transaction_created：交易已被识别，待网络确认。transaction_confirmed：交易已获网络确认，支付完成。
建议商户部署回调接口以确保实时接收支付事件，👉查看实时支付通知指南以优化集成体验。
常见问题
发票有效期为何设定为10分钟？
主要基于汇率风险控制。加密货币汇率波动剧烈，10分钟有效期平衡了用户体验与商户汇率风险，同时保障支付流程的确定性。
逾期付款能否自动完成？
可以。在集成设置中启用“自动处理未解决发票”功能，并选择“逾期支付自动完成”规则即可。系统将在交易确认后自动更新状态，无需手动干预。
如何处理超额支付？
建议配置自动退款规则，将超额部分退回客户地址。亦可手动处理：确认收到全额后，将发票状态更新为“completed”并另行安排超额部分退款。
发票状态回调失败怎么办？
系统采用重试机制推送回调事件。建议商户记录日志并设置异常监控，必要时可通过API查询发票状态弥补回调遗漏。
是否支持多币种发票？
是的。单张发票可同时生成多个币种的收款地址，客户可选择任意支持的加密货币支付，系统按创建时汇率锁定法币价值。
未解决状态如何手动更新？
通过API或管理面板可手动将 unresolved 状态更新为 completed（完成）或 refunded（已退款）。操作前请确保已核实交易详情。
通过理解加密货币发票的运作机制与状态管理逻辑，商户可构建更稳健的支付系统。合理利用回调功能与自动化规则，能显著提升支付成功率和运营效率。