Skip to navigation

Open a dispute

Puts the order under CorpX review. The buyer disputes after the delivery deadline; the seller 60 minutes after sending or 24 hours after confirmation. The held BRL stays held until the decision.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

accountIdstringRequired
Account identifier.
orderIdstringRequired
P2P order identifier.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.
X-Acting-DocumentstringOptional

CPF of the human performing the operation. Required on cashout routes when the credential enforces a transaction PIN. On a company P2P profile contact, this CPF is the holder who signs; it is not taken from the body.

Idempotency-KeystringOptional

Optional client-generated idempotency token (recommended for safe retries).

X-Request-TimestampstringRequired

Unix seconds. Required on the signed host; tolerance is 300s either way (403 request_timestamp_skew).

X-Content-SHA256stringRequired

Lowercase hex SHA-256 of the body. An empty body hashes the empty string, so the header is always present. Mismatch returns 400 body_hash_mismatch.

X-Request-SignaturestringRequired

Detached JWS (<protected>..<signature>, ES256 or PS256) over METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256.

Request

This endpoint expects an object.
reasonenumRequired
Allowed values:
descriptionstringOptional<=2000 characters

Response

Dispute open
disputeIdstringOptional
Dispute identifier.
orderIdstringOptional
Order.
openedByenumOptional
Party that opened it.
Allowed values:
reasonstringOptional
Reason code.
descriptionstringOptional
Opening text.
statusenumOptional
Dispute status.
Allowed values:
infoRequestedTostringOptional
Party asked for information.
infoDueAtdatetime or nullOptional
Deadline for the information.
decisionenumOptional
Outcome.
Allowed values:
faultstringOptional
Party at fault.
decidedAtdatetime or nullOptional
Decision time.
createdAtdatetime or nullOptional
Opening time.
updatedAtdatetime or nullOptional
Last change.

Errors

403
Forbidden Error
404
Not Found Error
409
Conflict Error