Upload Dispute Evidence
Suggest Edits
Overview
Upload a file as evidence for a dispute. This endpoint allows you to submit supporting documentation (receipts, contracts, communications, etc.) to defend against a chargeback. Supports JPEG and PDF formats with a maximum of 1MB per file and 10MB total across 8 files.
Resource Access
Production (api.ahrvo.network)
POST https://api.ahrvo.network/payments/na/disputes/\{dispute_id}/evidence
Staging (gateway.ahrvo.network)
POST http://gateway.ahrvo.network/payments/na/disputes/\{dispute_id}/evidence
Arguments
| Attribute | Mandatory / Optional | Description |
|---|---|---|
dispute_id | Mandatory | The unique ID of the dispute |
file | Mandatory | The binary contents of the file (JPEG or PDF, max 1MB) |
File Requirements
- Supported formats: JPEG, PDF
- Maximum file size: 1MB per file
- Maximum total size: 10MB across all files
- Maximum files: 8 files per dispute
Example Request
curl -X POST https://gateway.ahrvo.network/payments/na/disputes/DPxxxxxxxxxxxxxxxxxx/evidence \
-H "Authorization: Basic <base64_encoded_credentials>" \
-F "file=@/path/to/receipt.pdf"
Example Response
{
"id": "EVxxxxxxxxxxxxxxxxxx",
"created_at": "2025-12-10T11:50:00Z",
"dispute": "DPxxxxxxxxxxxxxxxxxx",
"state": "SUCCEEDED",
"tags": {
"file-extension": "pdf",
"content-type": "application/pdf",
"file-name": "receipt.pdf"
},
"_links": {
"self": {
"href": "https://api.ahrvo.network/payments/na/disputes/DPxxxxxxxxxxxxxxxxxx/evidence/EVxxxxxxxxxxxxxxxxxx"
},
"dispute": {
"href": "https://api.ahrvo.network/payments/na/disputes/DPxxxxxxxxxxxxxxxxxx"
},
"download": {
"href": "https://api.ahrvo.network/payments/na/disputes/DPxxxxxxxxxxxxxxxxxx/evidence/EVxxxxxxxxxxxxxxxxxx/download"
}
}
}
Evidence State Values
- PENDING: File is being processed
- SUCCEEDED: File successfully uploaded and ready
- FAILED: File upload or processing failed