P2P Crypto — money and fee
An order’s money never leaves CorpX without the crypto checked. On opening, the buyer’s amount is held in their account; on release, it becomes an internal transfer to the seller; on cancellation or refund, the hold is undone.
Money path
- The hold appears in
GET /v1/accounts/{accountId}/holdswithsource.type: p2p_order(see Statement and balance). - The balance shows the locked part in
heldAmount. - The transfer and the fee use reserved identifiers:
p2p-{orderId}andfee-p2p-{orderId}. A fee refund, if any, usesfee-p2p-{orderId}-r.
Who pays the fee
The intermediation fee is paid by whoever published the ad, at the percentage (feeBps) of their level.
Sell ad: the seller pays
An R$ 1,000.00 order on a sell ad from an advertiser with feeBps 50 (0.5%):
The order shows fee: "5.00" and feePayer: "seller". The buyer sees heldAmount: "1000.00"; the seller sees netAmount: "995.00".
Buy ad: the buyer pays
The same order on a buy ad:
The order shows fee: "5.00" and feePayer: "buyer". The buyer sees heldAmount: "1005.00"; the seller sees netAmount: "1000.00".
Balance
Opening an order requires available balance from the buyer for the hold (422 insufficient_available_balance). On a buy ad, the buyer is the advertiser: without balance, the order does not open and the ad is paused (pausedReason: insufficient_balance). When the seller pays the fee, it is debited right after the payment arrives. If the charge fails, the payment to the seller is already done and CorpX retries the charge with the same identifier: there are never two charges for the same order.
Cancellation and refund
Nothing is charged: the hold is undone in full, including the fee part when the buyer pays. The statement shows no entry, only the hold that ceases to exist.