Download OpenAPI specification:Download
Public API for submitting disputes and retrieving evaluation results.
Submit a dispute with evidence for automated evaluation.
| category required | string (Category) Dispute category for online fraud. Value: "fraud_online" |
required | object (Dispute) Dispute details including the disputed amount and currency. |
required | object (Transaction) Transaction being disputed. |
required | object (FraudOnlineEvidences) Evidence for online fraud disputes. |
{- "category": "fraud_online",
- "dispute": {
- "disputed_amount": 149.99,
- "disputed_currency": "USD"
}, - "transaction": {
- "transaction_id": "txn_12345",
- "card_scheme": "VISA",
- "channel_type": "ATM",
- "merchant_name": "ACME Store",
- "merchant_country": "USA",
- "transaction_amount": 299.99,
- "transaction_currency": "USD",
- "merchant_id": "mid_123",
- "transaction_timestamp": "2024-01-20T00:00:00Z",
- "settlement_timestamp": "2024-01-22T00:00:00Z",
- "arn": "12345678901234567890123",
- "rrn": "123456789012",
- "merchant_category_code": "5311",
- "terminal_id": "term_01",
- "mobile_wallet": "apple_pay",
- "avs_result": "MATCH",
- "cvv_match": true,
- "eci_code": "05",
- "batch_id": "batch_001",
- "device_fingerprint": "dfp_abc123xyz",
- "device_location": "203.0.113.42"
}, - "evidences": {
- "cardholder_statement": "I did not make this purchase and my card details were stolen.",
- "police_report": "550e8400-e29b-41d4-a716-446655440000",
- "oldest_matching_transaction_timestamps": [
- "2023-06-15T10:30:00Z",
- "2023-08-20T14:00:00Z"
], - "oldest_merchant_purchase_at": "2023-06-15T14:30:00Z"
}
}Retrieve the evaluation confidence and any failed checks.
| evaluation_id required | string <uuid> (Evaluation Id) |
{- "id": "eval_a1b2c3",
- "confidence": "high",
- "failed_checks": [
- {
- "loc": [
- "body",
- "evidences",
- "cardholder_statement"
], - "msg": "Cardholder statement is too short.",
- "type": "error"
}
]
}Upload an evidence file and receive its id for use in evaluations.
| file required | string <binary> (File) |
{- "id": "550e8400-e29b-41d4-a716-446655440000",
- "original_name": "receipt.pdf",
- "mime_type": "application/pdf",
- "size": 123456
}Retrieve metadata and a signed URL for an evidence file.
| file_id required | string <uuid> (File Id) |
{- "id": "550e8400-e29b-41d4-a716-446655440000",
- "original_name": "receipt.pdf",
- "mime_type": "application/pdf",
- "size": 123456
}