Insights on Crypto Payments, Infrastructure, and Operations
Crypto Payment Tools支付运营

OxaPay · Crypto Payment Tools

支付状态与异常模拟器

无需实际转账,测试 15 种加密支付、订单状态、少付与 Webhook 投递场景。

核心原则

支付状态与订单状态有关联,但并非同一条记录

支付网关报告付款情况,而应用程序决定订单如何处理。不要依据未经验证的回调履行订单,不要在较新事件之后回退状态,也不要在没有明确政策时将金额异常视为正常付款。

开始之前 本模拟器将已记录的支付规则应用于虚构订单。

模拟器展示可能的状态变化及商家操作,但不会创建付款、调用接口、验证真实交易,也不能替代 Payment Information。

基于规则的教学模型
模拟模式

从简单业务场景开始,或检查所有运营参数。

预设场景 选择一个场景即可加载示例值。
快速模拟

几秒钟内测试支付场景

选择场景,只调整商家最需要的细节。

5 个简单输入
无需技术配置

模拟器会填写 Webhook、订单状态、确认和策略参数;可在高级配置中查看和修改。

01选择并调整
模拟结果

预期状态与商家操作

运行场景后更新结果。

paid
简要结论

支付完成,订单可履行

客户已在有效期内支付足额款项。

建议:只履行一次并记录支付。
网关状态 paid

账单已足额支付。

订单决策 Fulfill

操作:只履行一次并记录付款。

金额分类 Exact

收到的金额与要求一致。

Webhook 投递结果 Accepted

Webhook 投递为模拟结果。

门槛计算

金额决策

最低接受金额:99.00 USD
已收到:100.00 USD 差额:0.00 USD
事件进度

支付时间线

    运营复核

    异常与控制措施

    Webhook 模型

    投递尝试与示例数据

    2 events

    模拟数据负载;实际 API 字段可能不同。

    实现规则

    建议处理逻辑

    如何使用支付状态模拟器

    本模拟器帮助商家和开发者了解支付事件如何影响订单。选择预设场景,或调整金额、有效期、网络确认数、支付方式和 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 集成说明。