# Submit Evidence Submit supporting evidence for a chargeback dispute. At least one evidence item is required. ## Request ### Headers ### Path Parameters ### Body Parameters ## Response ### Success (200 OK) ```json { "success": true, "data": { "chargebackId": "cb_a1b2c3d4e5f6g7h8", "status": "evidence_submitted", "evidence": [ { "type": "receipt", "documentUrl": "https://files.zenpayz.com/evidence/receipt_001.pdf", "fileName": "receipt_001.pdf", "mimeType": "application/pdf", "fileSize": 204800, "description": "Original transaction receipt", "submittedAt": "2024-01-18T14:22:00.000Z" }, { "type": "shipping_proof", "documentUrl": "https://files.zenpayz.com/evidence/tracking_001.pdf", "fileName": "tracking_001.pdf", "mimeType": "application/pdf", "fileSize": 153600, "description": "Shipping confirmation with tracking number", "submittedAt": "2024-01-18T14:22:00.000Z" } ], "notes": "Product was delivered and signed for on Jan 12.", "updatedAt": "2024-01-18T14:22:00.000Z" }, "message": "Evidence submitted successfully", "error": null, "meta": { "request_id": "req_xxxxx", "timestamp": "2024-01-18T14:22:00.000Z", "processing_time_ms": 62, "api_version": "v1", "endpoint": "POST /chargebacks/:chargebackId/evidence", "user_type": "merchant" } } ``` ### Error Responses ## Examples ```bash curl -X POST https://api.zenpayz.com/merchant/api/v1/chargebacks/cb_a1b2c3d4e5f6g7h8/evidence \ -H "Authorization: Bearer zp_test_xxxxx" \ -H "X-Timestamp: 2024-01-18T14:22:00.000Z" \ -H "X-Signature: a1b2c3d4e5f6..." \ -H "X-Secret-Salt: your_secret_salt" \ -H "Content-Type: application/json" \ -H "X-Merchant-Id: merch_xxxxx" \ -H "X-Request-Id: req_xxxxx" \ -d '{ "evidence": [ { "type": "receipt", "documentUrl": "https://files.zenpayz.com/evidence/receipt_001.pdf", "fileName": "receipt_001.pdf", "mimeType": "application/pdf", "fileSize": 204800, "description": "Original transaction receipt" }, { "type": "shipping_proof", "documentUrl": "https://files.zenpayz.com/evidence/tracking_001.pdf", "fileName": "tracking_001.pdf", "mimeType": "application/pdf", "fileSize": 153600, "description": "Shipping confirmation with tracking number" } ], "notes": "Product was delivered and signed for on Jan 12." }' ``` ```javascript const response = await fetch('https://api.zenpayz.com/merchant/api/v1/chargebacks/cb_a1b2c3d4e5f6g7h8/evidence', { method: 'POST', headers: { 'Authorization': `Bearer ${apiKey}`, 'X-Timestamp': timestamp, 'X-Signature': signature, 'X-Secret-Salt': secretSalt, 'Content-Type': 'application/json', 'X-Merchant-Id': merchantId, 'X-Request-Id': requestId, }, body: JSON.stringify({ evidence: [ { type: 'receipt', documentUrl: 'https://files.zenpayz.com/evidence/receipt_001.pdf', fileName: 'receipt_001.pdf', mimeType: 'application/pdf', fileSize: 204800, description: 'Original transaction receipt', }, { type: 'shipping_proof', documentUrl: 'https://files.zenpayz.com/evidence/tracking_001.pdf', fileName: 'tracking_001.pdf', mimeType: 'application/pdf', fileSize: 153600, description: 'Shipping confirmation with tracking number', }, ], notes: 'Product was delivered and signed for on Jan 12.', }), }); const result = await response.json(); console.log(result.data.status); // "evidence_submitted" console.log(result.data.evidence.length); // 2 ``` ```javascript const result = await zenpays.chargebacks.submitEvidence('cb_a1b2c3d4e5f6g7h8', { evidence: [ { type: 'receipt', documentUrl: 'https://files.zenpayz.com/evidence/receipt_001.pdf', fileName: 'receipt_001.pdf', mimeType: 'application/pdf', fileSize: 204800, description: 'Original transaction receipt', }, { type: 'shipping_proof', documentUrl: 'https://files.zenpayz.com/evidence/tracking_001.pdf', fileName: 'tracking_001.pdf', mimeType: 'application/pdf', fileSize: 153600, description: 'Shipping confirmation with tracking number', }, ], notes: 'Product was delivered and signed for on Jan 12.', }); console.log(result.status); // "evidence_submitted" console.log(result.evidence.length); // 2 ``` ## Related Endpoints - [Get Chargeback](/docs/rest-api/endpoints/chargebacks/get-chargeback) - [Add Response](/docs/rest-api/endpoints/chargebacks/add-response) - [Create Chargeback](/docs/rest-api/endpoints/chargebacks/create-chargeback)