Open a P2P order
Takes an ad. Inform exactly one of amount (BRL) or cryptoAmount. CorpX screens both wallets, reserves
the ad’s stock and holds the buyer’s BRL before answering 201. Then the contract goes out for signature:
the buyer signs first, and the seller has sellerWindowMin after that to sign and send the crypto.
202 means the opening is still running; read the order or wait for p2p.order.updated.
The order price is locked with a live read of the Binance spot price ({ASSET}BRL) at opening, also for fixed-price ads, and the full HTTP exchange (request, response, headers, TLS, timestamps, hashes) is stored as the order’s price evidence (GET .../orders/{orderId}/price-evidence). If Binance does not answer, the order is refused with 409 price_unavailable and nothing is created or locked; retry with the same Idempotency-Key. A replay with the same key does not query Binance again.
M2M only (scope p2p.trade). Cashout locks and the transaction PIN apply only when the taker is the buyer (sell ad): that is whose balance is held. Taking a buy ad opens without a PIN. Idempotency-Key is required.
On wallet_not_approved, details.walletOf says whose wallet was refused (taker or maker).
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Headers
Client-generated idempotency token.
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.
Transaction PIN of the operator in X-Acting-Document. Required on cashout routes when the credential enforces a PIN (428 pin_required).
Unix seconds. Required on the signed host; tolerance is 300s either way (403 request_timestamp_skew).
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.
Detached JWS (<protected>..<signature>, ES256 or PS256) over METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256.
Request
Your approved wallet: destination when you buy, source when you sell.
Response
Party that pays the fee (the advertiser).
BRL held from the buyer (buyer view).
BRL the seller receives (seller view).
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.
Hold of the buyer’s BRL (buyer view).
The deadline running now for the current status; null in dispute or a final status.
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.
Detail only, when the order has a dispute. The dispute plus messages and the viewer’s own evidence.