Overview
| API Name | Request Direction | API Endpoint | Description |
|---|---|---|---|
| List All Disputes | Merchant → Oceanpayment | /dispute-api/v1/dispute/list | Merchant queries the dispute data list |
| Query Dispute Details | Merchant → Oceanpayment | /dispute-api/v1/dispute/{dispute_id} | Retrieve complete information for a single dispute |
| Dispute Appeal | Merchant → Oceanpayment | /dispute-api/v1/dispute/{dispute_id}/update | Submit or update appeal content |
| List All Files | Merchant → Oceanpayment | /files-api/v1/file/list | Query uploaded attachment list |
| File Upload | Merchant → Oceanpayment | /files-api/v1/file/upload | Upload dispute attachments |
| Query File Details | Merchant → Oceanpayment | /files-api/v1/file/{file_id} | View specified attachment information |
Notes
- Token Validity:
- The Access Token has an expiration period and must be used within its validity period. After expiration, use refresh_token to refresh it.
- File Upload Limit:
- Up to 5 file IDs can be uploaded in the evidence_file array for a single request.
- Time Format:
- All timestamps use the UTC+8 timezone with the format: 2026-04-02T16:28:09+08:00
- Required dispute_evidence Validation:
- Based on evidence_optional=false, merchants must provide the corresponding description or attachment for the evidence item.
- dispute_data Field:
- Only the fields returned in requested_fields from the dispute details response need to be submitted. Fields marked as “processed internally by the system” do not need to be submitted.
- X-Auth-Nonce:
- A random string used for callback signature verification, provided by Oceanpayment to the merchant.