Skip to main content
POST
Upload dispute evidence

Authorizations

Authorization
string
header
required

Secret key, kc_sk_test_... or kc_sk_live_.... Server-side only.

Headers

Idempotency-Key
string
required

Unique key per logical request, reused on retries. 1 to 255 characters.

Required string length: 1 - 255

Path Parameters

id
string
required

Body

application/json
document_type
string
required
Examples:

"proof_of_delivery"

"customer_communication"

"invoice"

"terms_and_conditions"

"other"

file_name
string
required
Maximum string length: 200
content_type
enum<string>
required
Available options:
application/pdf,
image/jpeg,
image/tiff
content_base64
string
required
description
string
Maximum string length: 1000

Response

The dispute with the new evidence document.

id
string
required
Example:

"dp_01JABCDEF"

object
string
required
Allowed value: "dispute"
payment
string
required
status
enum<string>
required
Available options:
needs_response,
under_review,
funds_withdrawn,
won,
lost,
accepted
amount
integer<int64>
required

Amount in the currency's minor unit.

Required range: x >= 0
currency
string
required

ISO 4217 currency code, uppercase.

Pattern: ^[A-Z]{3}$
Example:

"EUR"

created_at
string<date-time>
required
reason_code
string | null
reason
string | null
evidence_due_by
string<date-time> | null
evidence
object[]
updated_at
string<date-time>