Skip to navigation

Cancel a P2P order

Cancels before both parties signed. The buyer's BRL returns to their balance and the ad's stock is freed. Cancelling before signing your own copy marks the fault on you.

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.
reasonstringOptional<=200 characters

Response

Cancelled
orderIdstringOptional
Order identifier.
adIdstringOptional
Ad taken.
roleenumOptional
Your role.
Allowed values:
sideenumOptional
Your side.
Allowed values:
pairstringOptional
Pair code.
networkstringOptional
Network.
statusenumOptional
Order status.
amountstringOptional
BRL amount.
cryptoAmountstringOptional
Crypto amount.
pricestringOptional
BRL price per unit locked at opening, 4 decimal places. The order amount is in cents.
feestringOptional
CorpX fee.
feePayerenumOptional

Party that pays the fee (the advertiser).

Allowed values:
heldAmountstringOptional

BRL held from the buyer (buyer view).

netAmountstringOptional

BRL the seller receives (seller view).

destinationAddressstringOptional
Wallet the crypto must reach.
counterpartyobjectOptional

The other party: only username and reputation. Name and masked document appear only in the receipt (GET .../p2p/orders/{orderId}/receipt) of a concluded order.

holdIdstringOptional

Hold of the buyer’s BRL (buyer view).

deadlineAtdatetime or nullOptional

The deadline running now for the current status; null in dispute or a final status.

concludedbooleanOptional

Detail only. true when the order is released (or resolved with release_to_seller), both parties signed, the seller was paid and the fee was charged.

concludedAtdatetime or nullOptional
Detail only. When the last conclusion step happened.
timelinelist of objectsOptional
Detail only. Order history from the viewer's point of view, oldest first.
disputeobjectOptional

Detail only, when the order has a dispute. The dispute plus messages and the viewer’s own evidence.

signatureUrlstringOptionalformat: "uri"
Your signing link while your signature is pending.
signatureslist of objectsOptional
Signature state per party.
txidslist of objectsOptional
Transactions reported by the seller.
contractAvailablebooleanOptional
Your signed copy can be downloaded.
signingDeadlineAtdatetime or nullOptional
Buyer's signing deadline.
buyerSignedAtdatetime or nullOptional
Buyer signed.
sellerSignedAtdatetime or nullOptional
Seller signed.
sellerDeadlineAtdatetime or nullOptional
Seller's deadline to sign and send.
onchainDeadlineAtdatetime or nullOptional
Deadline for the network confirmation.
releaseDeadlineAtdatetime or nullOptional
Buyer's deadline to release.
releasedBeforeConfirmedbooleanOptional
Released before the confirmations completed.
fundedAtdatetime or nullOptional
BRL held.
signedAtdatetime or nullOptional
Both signed.
cryptoSentAtdatetime or nullOptional
Txid reported.
cryptoConfirmedAtdatetime or nullOptional
Network confirmed.
releasedAtdatetime or nullOptional
BRL released.
cancelledAtdatetime or nullOptional
Cancelled.
disputedAtdatetime or nullOptional
Dispute opened.
resolvedAtdatetime or nullOptional
Dispute decided.
cancelledBystringOptional
Who cancelled.
faultstringOptional
Party at fault.
cancelReasonstringOptional
Cancellation reason.
lastErrorstringOptional
Last processing error.
createdAtdatetime or nullOptional
Creation time.
updatedAtdatetime or nullOptional
Last change.

Errors

403
Forbidden Error
404
Not Found Error
409
Conflict Error