获取付款结果

概述

在完成付款创建后,商户需要对交易状态进行确认与结果获取。Onerway 提供了两种方式来帮助商户在不同场景下获取实时付款进度与结果。

两种获取方式

方式	说明	适用场景
付款回调	系统主动推送付款状态	实时状态同步
主动查询	商户系统主动查询交易状态	补救措施、按需查询

付款回调

适用场景

当付款状态发生变化（如：处理中 → 成功 / 失败）时，系统会主动向商户提供的回调地址发送通知。

优势

• 最实时 - 状态变化立即通知
• 自动化 - 无需主动查询
• 可靠性 - 支持重试机制

主动查询

适用场景

若未收到回调，或需要主动确认交易状态，可通过 API 查询实时状态。

推荐使用查询的场景：

• 回调丢失或异常
• 用户询问订单状态
• 财务对账核对
• 系统监控检查

方式 A：单笔查询

付款单笔查询接口用于查询单笔交易的最新状态。

常见用途

场景	说明
回调丢失	补救措施
用户咨询	查询订单状态
金额核对	确认结算金额及实际汇率

方式 B：批量查询

付款批量查询接口适用于需要对一段时间内的多笔交易进行对账或监控。

典型用途

场景	说明
财务对账	每日/每周批量核对
风控监控	定期检查失败交易
数据统计	统计交易量、成功率

付款凭证下载（Voucher Download）

适用场景

付款凭证查询接口当通过回调或查询确认交易状态为成功（SUCCESS）后，商户可下载电子回单作为付款凭证。

电子回单用途

• 财务归档 - 作为交易完成的正式凭证
• 审计追溯 - 提供完整的交易信息
• 客户通知 - 可发送给客户作为付款证明

常见问题

Q1：回调和查询，应该用哪个？

解答

推荐都用！ 推荐回调为主 + 查询为辅的双重保障机制：

• 回调 - 实时获取大部分交易状态
• 查询 - 定期检查，确保无遗漏

Q2：批量查询应该多久执行一次？

解答

建议每日执行一次，具体时间根据业务情况：

• 凌晨 2:00 - 业务低峰期
• 与内部系统数据比对

Q3：电子回单什么时候可以下载？

解答

交易成功后1小时后生成。如果超过 2 小时仍无法下载，请联系客服。

Q4：凭证可以重复下载吗？

解答

可以。电子回单会长期保存，可以随时重复下载。