Skip to navigation

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

release or disputefor the seller cancellation or disputefor the buyer Opening Hold on the buyer account(hold, status active) Outcome Internal transferp2p-{orderId} to the seller Fee fee-p2p-{orderId}to the CorpX intermediation account Hold undone(balance becomes available again)
  • The hold appears in GET /v1/accounts/{accountId}/holds with source.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} and fee-p2p-{orderId}. A fee refund, if any, uses fee-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%):

StepBuyerSellerCorpX intermediation
Opening−1,000.00 held——
Releasehold becomes a transfer+1,000.00 (p2p-…)—
Fee—−5.00 (fee-p2p-…)+5.00
Result−1,000.00+995.00+5.00

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:

StepBuyerSellerCorpX intermediation
Opening−1,005.00 held——
Releasehold becomes a transfer+1,000.00 (p2p-…)—
Feecomes out of the hold itself (fee-p2p-…)—+5.00
Result−1,005.00+1,000.00+5.00

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.