Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
File and resolve chargebacks against agent transactions.
| Code | Meaning |
|---|---|
unauthorized | Spend wasn’t authorized by policy |
fraud | Suspected fraudulent transaction |
not_received | Goods or service never delivered |
not_as_described | Delivered but doesn’t match agreement |
duplicate | Charged more than once |
incorrect_amount | Amount differs from agreed price |
canceled | Cancelled but still charged |
credit_not_processed | Refund wasn’t 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 placed 10 days ago, tracking shows no movement"
}'
{
"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 with merchant support",
"fileUrl": "https://storage.example.com/evidence/abc.pdf"
}'
receipt · shipping · communication · cancellation · refund_policy · product_description · other. File URLs must be HTTPS and SSRF-safe (no private IPs).
curl -X PATCH https://api.getovra.com/disputes/dsp_... \
-H "Authorization: Bearer $OVRA_API_KEY" \
-d '{ "status": "resolved" }'
resolved or rejected. Once closed, no further mutation is allowed.
| Event | When |
|---|---|
dispute.created | Filed |
dispute.updated | Evidence added or fields changed |
dispute.resolved | Closed (resolved or rejected) |
| Plan | Dispute management |
|---|---|
| Free | – |
| Starter | View only |
| Business | Full (file + manage + resolve) |
| Enterprise | Full + automated workflows |
| Surface | Capability |
|---|---|
| REST | /disputes, /disputes/:id/evidence |
| SDK | ovra.disputes.* |
| MCP | ovra_dispute (action: get · file) |
| Dashboard | /dashboard/disputes |