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
accountId
Account identifier.
orderId
P2P order identifier.
Headers
X-Tenant-Id
Tenant context used for authorization and routing.
X-Acting-Document
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-Key
Optional client-generated idempotency token (recommended for safe retries).
Request
This endpoint expects an object.
reason
Allowed values:
description
Response
Dispute open
disputeId
Dispute identifier.
orderId
Order.
openedBy
Party that opened it.
Allowed values:
reason
Reason code.
description
Opening text.
status
Dispute status.
Allowed values:
infoRequestedTo
Party asked for information.
infoDueAt
Deadline for the information.
decision
Outcome.
Allowed values:
fault
Party at fault.
decidedAt
Decision time.
createdAt
Opening time.
updatedAt
Last change.
Errors
403
Forbidden Error
404
Not Found Error
409
Conflict Error