Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Chargebacks gegen Agent-Transaktionen einreichen und lösen.
| Code | Bedeutung |
|---|---|
unauthorized | Spend nicht von Policy autorisiert |
fraud | Verdacht auf betrügerische Transaktion |
not_received | Ware oder Service nie geliefert |
not_as_described | Geliefert aber matcht nicht Vereinbarung |
duplicate | Mehrfach belastet |
incorrect_amount | Betrag weicht vom vereinbarten Preis ab |
canceled | Cancelled aber trotzdem belastet |
credit_not_processed | Refund nicht applied |
curl -X POST https://api.getovra.com/disputes \
-H "Authorization: Bearer $OVRA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"transactionId": "tx_...",
"reason": "not_received",
"description": "Order vor 10 Tagen aufgegeben, Tracking zeigt keine Bewegung"
}'
{
"id": "dsp_...",
"transactionId": "tx_...",
"reason": "not_received",
"status": "open",
"createdAt": "2026-04-20T12:34:56Z"
}
curl -X POST https://api.getovra.com/disputes/dsp_.../evidence \
-H "Authorization: Bearer $OVRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "communication",
"description": "Email-Thread mit Merchant-Support",
"fileUrl": "https://storage.example.com/evidence/abc.pdf"
}'
receipt · shipping · communication · cancellation · refund_policy · product_description · other. File-URLs müssen HTTPS sein und SSRF-safe (keine Private-IPs).
curl -X PATCH https://api.getovra.com/disputes/dsp_... \
-H "Authorization: Bearer $OVRA_API_KEY" \
-d '{ "status": "resolved" }'
resolved oder rejected setzen. Nach Schließung sind keine weiteren Mutationen erlaubt.
| Event | Wann |
|---|---|
dispute.created | Eingereicht |
dispute.updated | Evidence hinzugefügt oder Felder geändert |
dispute.resolved | Geschlossen (resolved oder rejected) |
| Plan | Dispute-Management |
|---|---|
| Free | – |
| Starter | Nur View |
| Business | Voll (filen + verwalten + lösen) |
| Enterprise | Voll + automated Workflows |
| Surface | Capability |
|---|---|
| REST | /disputes, /disputes/:id/evidence |
| SDK | ovra.disputes.* |
| MCP | ovra_dispute (action: get · file) |
| Dashboard | /dashboard/disputes |