Pular para o conteúdo principal
POST
Upload an evidence file to a dispute

Autorizações

Authorization
string
header
obrigatório

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

Cabeçalhos

Content-Type
string

Evidence media type: application/pdf, image/png, image/jpeg, or text/csv

Exemplo:

"application/pdf"

Parâmetros de caminho

disputeId
string<uuid>
obrigatório

Dispute ID (UUID)

Exemplo:

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

Parâmetros de consulta

comment
string

Comment describing the uploaded evidence

Required string length: 1 - 1000
Exemplo:

"Bank statement showing correct amount"

Corpo

application/octet-stream

The body is of type file.

Resposta

Created

category
enum<string>
obrigatório

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

Opções disponíveis:
BANK_FEE_ERROR,
UNRECOGNIZED_CHARGE,
DUPLICATE_TRANSACTION,
AMOUNT_MISMATCH,
OTHER
Exemplo:

"BANK_FEE_ERROR"

createdAt
string
obrigatório

Creation timestamp as an RFC 3339 timestamp

Exemplo:

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

description
string
obrigatório

Description of the dispute

Exemplo:

"Transaction amount differs from expected"

exceptionId
string
obrigatório

Identifier of the exception this dispute is for (UUID)

Exemplo:

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

id
string
obrigatório

Unique identifier for the dispute (UUID)

Exemplo:

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

openedBy
string
obrigatório

User who opened the dispute

Exemplo:

"user@example.com"

state
enum<string>
obrigatório

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

Opções disponíveis:
DRAFT,
OPEN,
PENDING_EVIDENCE,
WON,
LOST
Exemplo:

"OPEN"

updatedAt
string
obrigatório

Last update timestamp as an RFC 3339 timestamp

Exemplo:

"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

Exemplo:

"New evidence discovered"

resolution
string

Resolution description recorded when the dispute was closed

Exemplo:

"Counterparty confirmed error"