Get Payment Result
Overview
After completing payment creation, merchants need to confirm transaction status and obtain results. Onerway provides two methods to help merchants obtain real-time payment progress and results in different scenarios.
Two Methods of Obtaining
| Method | Description | Applicable Scenario |
|---|---|---|
| Payment Callback | System actively pushes payment status | Real-time status synchronization |
| Active Query | Merchant system actively queries transaction status | Remedial measure, on-demand query |
Payment Callback
Applicable Scenario
When payment status changes (such as: processing → success / failure), the system will actively send notification to the callback address provided by merchant.
Advantages
- Most Real-time - Immediate notification upon status change
- Automated - No need for active query
- Reliable - Supports retry mechanism
Active Query
Applicable Scenario
If callback is not received, or need to actively confirm transaction status, can query real-time status through API.
Recommended Scenarios for Using Query:
- Callback lost or abnormal
- User inquires about order status
- Financial reconciliation verification
- System monitoring check
Method A: Single Query
Payment Single Query Interface is used to query the latest status of a single transaction.
Common Uses
| Scenario | Description |
|---|---|
| Callback Lost | Remedial measure |
| User Inquiry | Query order status |
| Amount Verification | Confirm settlement amount and actual exchange rate |
Method B: Batch Query
Payment Batch Query Interface is suitable for reconciliation or monitoring of multiple transactions within a period of time.
Typical Uses
| Scenario | Description |
|---|---|
| Financial Reconciliation | Daily/weekly batch verification |
| Risk Control Monitoring | Regularly check failed transactions |
| Data Statistics | Statistics on transaction volume, success rate |
Payment Voucher Download (Voucher Download)
Applicable Scenario
Payment Voucher Query Interface After confirming transaction status is success (SUCCESS) through callback or query, merchants can download electronic receipt as payment voucher.
Electronic Receipt Uses
- Financial Archiving - As formal voucher of transaction completion
- Audit Tracing - Provide complete transaction information
- Customer Notification - Can be sent to customers as payment proof
FAQ
Q1: Callback or query, which should be used?
Answer
Recommend both! Recommend dual guarantee mechanism of callback as primary + query as secondary:
- Callback - Obtain most transaction statuses in real-time
- Query - Regular check to ensure no omissions
Q2: How often should batch query be executed?
Answer
Recommend executing once daily, specific time according to business situation:
- 2:00 AM - Business low peak period
- Compare with internal system data
Q3: When can electronic receipt be downloaded?
Answer
Generated 1 hour after successful transaction. If unable to download after more than 2 hours, please contact customer service.
Q4: Can vouchers be downloaded repeatedly?
Answer
Yes. Electronic receipts are saved long-term and can be downloaded repeatedly at any time.