支付状态与订单状态有关联,但并非同一条记录
支付网关报告付款情况,而应用程序决定订单如何处理。不要依据未经验证的回调履行订单,不要在较新事件之后回退状态,也不要在没有明确政策时将金额异常视为正常付款。
本工具不会向 OxaPay 发送请求、Webhook、转账、退款或订单更新。输入保留在浏览器中;真实 API 响应才是权威记录。
模拟器展示可能的状态变化及商家操作,但不会创建付款、调用接口、验证真实交易,也不能替代 Payment Information。
如何使用支付状态模拟器
本模拟器帮助商家和开发者了解支付事件如何影响订单。选择预设场景,或调整金额、有效期、网络确认数、支付方式和 Webhook 行为。它只是教学模型,不验证真实交易,也不会请求 OxaPay API。
支付状态与订单状态不是同一条记录
网关负责报告支付状态;商家系统独立决定订单是否等待、履行或人工复核。检测到链上转账不代表付款已被接受。不可撤销的交付必须依据已验证且符合政策的最终状态。重复或乱序的 Webhook 绝不能造成重复履行。
如何模拟少付与时间限制
可接受的少付额度由订单金额与配置的容差计算。严重少付、逾期转账或异常支付方式需要明确的商家政策,而非自动交付。固定地址充值必须另外匹配客户与交易。零次网络确认不等于网关报告的最终状态。
Webhook 投递与故障恢复
场景包括重复消息、错误的 HMAC 签名、乱序事件、首次投递失败及重试耗尽。处理程序应验证原始请求体签名、匹配订单、确保更新幂等,并通过 Payment Information 或 Payment History 核对争议记录。所示 JSON 只是示例,不是实际 API 响应。
模拟器的限制
页面中的订单、交易哈希、时间戳和负载都是虚构的。OxaPay 的状态、限制和重试安排可能变化,生产部署前请查阅最新官方文档。本工具不会发送资金、退款、真实 Webhook 或私密凭据。
OxaPay 文档中的支付状态
可接受的少付额度由订单金额与配置的容差计算。严重少付、逾期转账或异常支付方式需要明确的商家政策,而非自动交付。固定地址充值必须另外匹配客户与交易。零次网络确认不等于网关报告的最终状态。
new- 账单已创建,尚未选择支付币种。
waiting- 已选币种,等待付款。
paying- 付款尝试或交易正在处理。
paid- 账单已足额支付。
manual_accept- 商家已手动接受账单。
underpaid- 部分付款未达到账单要求。
refunding- 退款已发起。
refunded- 付款已退还。
expired- 账单到期前未收到可接受的付款。
最新 OxaPay 文档
请查看支付状态表、账单参数、支付查询和 Webhook 集成说明。