Download OpenAPI specification:Download
Public API for submitting disputes and retrieving evaluation results.
Submit dispute input data for the new evaluation flow.
required | object (Dispute) Dispute details including the description, disputed amount and currency. |
required | object (Transaction) Transaction being disputed. |
required | object (Evidences) Evidences supporting the dispute. |
{- "dispute": {
- "disputed_amount": 149.99,
- "disputed_currency": "USD",
- "description": "I did not make this purchase and my card details were stolen."
}, - "transaction": {
- "transaction_id": "txn_12345",
- "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",
- "merchant_category_code": "5311",
- "arn": "12345678901234567890123",
- "rrn": "123456789012",
- "device_fingerprint": "dfp_abc123xyz",
- "device_location": "203.0.113.42",
- "avs_result": "MATCH",
- "cvv_match": true,
- "eci_code": "05",
- "pos_entry_type": "MANUAL",
- "authorization_mode": "ONLINE",
- "is_network_tokenized": true,
- "card_scheme": "VISA",
- "card_bin": "54133388",
- "card_last_4": "1234",
- "card_token": "string",
- "card_emv_chip_enabled": true,
- "card_emv_pin_preferring": false
}, - "evidences": {
- "additional_documentation": [
- "550e8400-e29b-41d4-a716-446655440000"
], - "intended_transaction": {
- "transaction_id": "txn_12345",
- "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",
- "merchant_category_code": "5311",
- "arn": "12345678901234567890123",
- "rrn": "123456789012",
- "device_fingerprint": "dfp_abc123xyz",
- "device_location": "203.0.113.42",
- "avs_result": "MATCH",
- "cvv_match": true,
- "eci_code": "05",
- "pos_entry_type": "MANUAL",
- "authorization_mode": "ONLINE",
- "is_network_tokenized": true,
- "card_scheme": "VISA",
- "card_bin": "54133388",
- "card_last_4": "1234",
- "card_token": "string",
- "card_emv_chip_enabled": true,
- "card_emv_pin_preferring": false
}, - "oldest_matching_transaction_timestamps": [
- "2023-06-15T10:30:00Z",
- "2023-08-20T14:00:00Z"
], - "oldest_merchant_purchase_at": "2023-06-15T14:30:00Z",
- "emv_tlv_hex": "9F2608A1B2C3D4E5F607089F2701809F3303E0F8C8"
}
}Retrieve the finished result for a singular evaluation.
| evaluation_id required | string <uuid> (Evaluation Id) |
{- "evaluation_id": "eval_a1b2c3",
- "confidence": "high",
- "reason_code": "10.4",
- "failed_rules": [
- {
- "message": "Cardholder statement is too short.",
- "type": "error",
- "related_attributes": [
- "string"
]
}
], - "failed_custom_rules": [
- {
- "message": "Cardholder statement is too short.",
- "type": "error",
- "related_attributes": [
- "string"
]
}
]
}| evaluation_id required | string <uuid> (Evaluation Id) |
{- "evaluation_id": "4108ec8e-6efd-4b9b-bace-0bb4c296c324",
- "document": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "card_scheme": "MASTERCARD",
- "created_at": "2019-08-24T14:15:22Z",
- "generated_at": "2019-08-24T14:15:22Z"
}
}| evaluation_id required | string <uuid> (Evaluation Id) |
{- "evaluation_id": "4108ec8e-6efd-4b9b-bace-0bb4c296c324",
- "document": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "card_scheme": "MASTERCARD",
- "created_at": "2019-08-24T14:15:22Z",
- "generated_at": "2019-08-24T14:15:22Z"
}
}required | object (DisputeIn) |
required | object (Transaction) Transaction details for the disputed charge. |
required | object (Evidences) |
{- "dispute": {
- "disputed_amount": 149.99,
- "disputed_currency": "USD",
- "description": "I did not make this purchase and my card details were stolen.",
- "reason_code": "10.4"
}, - "transaction": {
- "transaction_id": "txn_12345",
- "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",
- "merchant_category_code": "5311",
- "arn": "12345678901234567890123",
- "rrn": "123456789012",
- "device_fingerprint": "dfp_abc123xyz",
- "device_location": "203.0.113.42",
- "avs_result": "MATCH",
- "cvv_match": true,
- "eci_code": "05",
- "pos_entry_type": "MANUAL",
- "authorization_mode": "ONLINE",
- "is_network_tokenized": true,
- "card_scheme": "VISA",
- "card_bin": "54133388",
- "card_last_4": "1234",
- "card_token": "string",
- "card_emv_chip_enabled": true,
- "card_emv_pin_preferring": false
}, - "evidences": {
- "additional_documentation": [
- "550e8400-e29b-41d4-a716-446655440000"
], - "intended_transaction": {
- "transaction_id": "txn_12345",
- "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",
- "merchant_category_code": "5311",
- "arn": "12345678901234567890123",
- "rrn": "123456789012",
- "device_fingerprint": "dfp_abc123xyz",
- "device_location": "203.0.113.42",
- "avs_result": "MATCH",
- "cvv_match": true,
- "eci_code": "05",
- "pos_entry_type": "MANUAL",
- "authorization_mode": "ONLINE",
- "is_network_tokenized": true,
- "card_scheme": "VISA",
- "card_bin": "54133388",
- "card_last_4": "1234",
- "card_token": "string",
- "card_emv_chip_enabled": true,
- "card_emv_pin_preferring": false
}, - "oldest_matching_transaction_timestamps": [
- "2023-06-15T10:30:00Z",
- "2023-08-20T14:00:00Z"
], - "oldest_merchant_purchase_at": "2023-06-15T14:30:00Z",
- "emv_tlv_hex": "9F2608A1B2C3D4E5F607089F2701809F3303E0F8C8"
}
}{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "status": "running",
- "confidence": "string",
- "reason_code": "string",
- "workflow_version": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "version": 0,
- "state": "active"
}, - "current_node": "string",
- "latest_run_id": "01a26ba9-be7a-49f1-b8f1-c778060a6d27",
- "created": "2019-08-24T14:15:22Z",
- "dispute": {
- "disputed_amount": 149.99,
- "disputed_currency": "USD",
- "description": "I did not make this purchase and my card details were stolen.",
- "reason_code": "10.4"
}, - "transaction": {
- "transaction_id": "txn_12345",
- "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",
- "merchant_category_code": "5311",
- "arn": "12345678901234567890123",
- "rrn": "123456789012",
- "device_fingerprint": "dfp_abc123xyz",
- "device_location": "203.0.113.42",
- "avs_result": "MATCH",
- "cvv_match": true,
- "eci_code": "05",
- "pos_entry_type": "MANUAL",
- "authorization_mode": "ONLINE",
- "is_network_tokenized": true,
- "card_scheme": "VISA",
- "card_bin": "54133388",
- "card_last_4": "1234",
- "card_token": "string",
- "card_emv_chip_enabled": true,
- "card_emv_pin_preferring": false
}, - "evidences": {
- "additional_documentation": [
- "550e8400-e29b-41d4-a716-446655440000"
], - "intended_transaction": {
- "transaction_id": "txn_12345",
- "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",
- "merchant_category_code": "5311",
- "arn": "12345678901234567890123",
- "rrn": "123456789012",
- "device_fingerprint": "dfp_abc123xyz",
- "device_location": "203.0.113.42",
- "avs_result": "MATCH",
- "cvv_match": true,
- "eci_code": "05",
- "pos_entry_type": "MANUAL",
- "authorization_mode": "ONLINE",
- "is_network_tokenized": true,
- "card_scheme": "VISA",
- "card_bin": "54133388",
- "card_last_4": "1234",
- "card_token": "string",
- "card_emv_chip_enabled": true,
- "card_emv_pin_preferring": false
}, - "oldest_matching_transaction_timestamps": [
- "2023-06-15T10:30:00Z",
- "2023-08-20T14:00:00Z"
], - "oldest_merchant_purchase_at": "2023-06-15T14:30:00Z",
- "emv_tlv_hex": "9F2608A1B2C3D4E5F607089F2701809F3303E0F8C8"
}, - "document": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "card_scheme": "string",
- "file": {
- "url": "string",
- "mime_type": "application/pdf"
}, - "created_at": "2019-08-24T14:15:22Z"
}
}| dispute_id required | string <uuid> (Dispute Id) |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "status": "running",
- "confidence": "string",
- "reason_code": "string",
- "workflow_version": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "version": 0,
- "state": "active"
}, - "current_node": "string",
- "latest_run_id": "01a26ba9-be7a-49f1-b8f1-c778060a6d27",
- "created": "2019-08-24T14:15:22Z",
- "dispute": {
- "disputed_amount": 149.99,
- "disputed_currency": "USD",
- "description": "I did not make this purchase and my card details were stolen.",
- "reason_code": "10.4"
}, - "transaction": {
- "transaction_id": "txn_12345",
- "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",
- "merchant_category_code": "5311",
- "arn": "12345678901234567890123",
- "rrn": "123456789012",
- "device_fingerprint": "dfp_abc123xyz",
- "device_location": "203.0.113.42",
- "avs_result": "MATCH",
- "cvv_match": true,
- "eci_code": "05",
- "pos_entry_type": "MANUAL",
- "authorization_mode": "ONLINE",
- "is_network_tokenized": true,
- "card_scheme": "VISA",
- "card_bin": "54133388",
- "card_last_4": "1234",
- "card_token": "string",
- "card_emv_chip_enabled": true,
- "card_emv_pin_preferring": false
}, - "evidences": {
- "additional_documentation": [
- "550e8400-e29b-41d4-a716-446655440000"
], - "intended_transaction": {
- "transaction_id": "txn_12345",
- "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",
- "merchant_category_code": "5311",
- "arn": "12345678901234567890123",
- "rrn": "123456789012",
- "device_fingerprint": "dfp_abc123xyz",
- "device_location": "203.0.113.42",
- "avs_result": "MATCH",
- "cvv_match": true,
- "eci_code": "05",
- "pos_entry_type": "MANUAL",
- "authorization_mode": "ONLINE",
- "is_network_tokenized": true,
- "card_scheme": "VISA",
- "card_bin": "54133388",
- "card_last_4": "1234",
- "card_token": "string",
- "card_emv_chip_enabled": true,
- "card_emv_pin_preferring": false
}, - "oldest_matching_transaction_timestamps": [
- "2023-06-15T10:30:00Z",
- "2023-08-20T14:00:00Z"
], - "oldest_merchant_purchase_at": "2023-06-15T14:30:00Z",
- "emv_tlv_hex": "9F2608A1B2C3D4E5F607089F2701809F3303E0F8C8"
}, - "document": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "card_scheme": "string",
- "file": {
- "url": "string",
- "mime_type": "application/pdf"
}, - "created_at": "2019-08-24T14:15:22Z"
}, - "runs": [ ]
}| dispute_id required | string <uuid> (Dispute Id) |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "card_scheme": "string",
- "file": {
- "url": "string",
- "mime_type": "application/pdf"
}, - "created_at": "2019-08-24T14:15:22Z"
}| dispute_id required | string <uuid> (Dispute Id) |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "card_scheme": "string",
- "file": {
- "url": "string",
- "mime_type": "application/pdf"
}, - "created_at": "2019-08-24T14:15:22Z"
}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
}