Saltar al contenido principal
POST
Submit evidence to a dispute

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication (format: "Bearer {token}")

Encabezados

X-Request-Id
string

A unique identifier for tracing the request across services.

X-Idempotency
string

Optional idempotency key for safe retries. Matcher reads the key only from this header, and only when you send one. A request that carries a key only in X-Idempotency-Key or Idempotency-Key is refused with 400 (MTCH-0015), and nothing is processed. If the same key is sent again and the original request was already processed, the stored response is returned with X-Idempotency-Replayed: true. A malformed key returns 400, a key whose first request is still in progress returns 409, and an idempotency storage failure returns 500. These refusals are problem documents.

Parámetros de ruta

disputeId
string<uuid>
requerido

Dispute ID Dispute ID (UUID)

Ejemplo:

"550e8400-e29b-41d4-a716-446655440001"

Cuerpo

application/json

Submit evidence payload

comment
string
requerido

Comment describing the evidence

Required string length: 1 - 1000
Ejemplo:

"Attached bank statement showing correct amount"

fileUrl
string

Optional URL to evidence file

Maximum string length: 2048
Ejemplo:

"https://storage.example.com/evidence/doc123.pdf"

Respuesta

Indicates that the request was successful and the response contains the expected data.

category
enum<string>
requerido

Dispute category: BANK_FEE_ERROR (incorrect fee), UNRECOGNIZED_CHARGE, DUPLICATE_TRANSACTION, AMOUNT_MISMATCH, or OTHER

Opciones disponibles:
BANK_FEE_ERROR,
UNRECOGNIZED_CHARGE,
DUPLICATE_TRANSACTION,
AMOUNT_MISMATCH,
OTHER
Ejemplo:

"BANK_FEE_ERROR"

createdAt
string
requerido

Creation timestamp as an RFC 3339 timestamp

Ejemplo:

"2025-01-15T10:30:00Z"

description
string
requerido

Description of the dispute

Ejemplo:

"Transaction amount differs from expected"

exceptionId
string
requerido

Identifier of the exception this dispute is for (UUID)

Ejemplo:

"550e8400-e29b-41d4-a716-446655440001"

id
string
requerido

Unique identifier for the dispute (UUID)

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

openedBy
string
requerido

User who opened the dispute

Ejemplo:

"user@example.com"

state
enum<string>
requerido

Dispute state: DRAFT, OPEN, PENDING_EVIDENCE (awaiting evidence), WON, or LOST

Opciones disponibles:
DRAFT,
OPEN,
PENDING_EVIDENCE,
WON,
LOST
Ejemplo:

"OPEN"

updatedAt
string
requerido

Last update timestamp as an RFC 3339 timestamp

Ejemplo:

"2025-01-15T10:30:00Z"

evidence
object[] | null

Evidence items submitted for this dispute (max 50)

Maximum array length: 50
reopenReason
string

Reason recorded when the dispute was reopened

Ejemplo:

"New evidence discovered"

resolution
string

Resolution description recorded when the dispute was closed

Ejemplo:

"Counterparty confirmed error"