> This page is for BaaS.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://en.docs.api.corpx.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://en.docs.api.corpx.com/_mcp/server.

# P2P Crypto — overview

P2P Crypto is a stablecoin market between CorpX accounts. The advertiser publishes price and limits; whoever takes the ad opens an order. The buyer's BRL stays held at CorpX until the crypto arrives, and both parties sign the order contract before the transfer. CorpX intermediates: it checks the transaction on the network, keeps the money and decides disputes.

The `p2p_crypto` feature **starts disabled for every tenant**. While it is off, every route under `/v1/p2p` and `/v1/accounts/{accountId}/p2p` answers **403** `feature_disabled`.

## One book

The market is a single CorpX book. With the feature on, the tenant joins the whole book: its accounts' ads show up for the accounts of every participating tenant, and its accounts take ads from any of them. There is no separate book per tenant, and no way to keep to your own ads only.

The rules are the same for everyone: pairs, levels and fee, deadlines and the contract are set by CorpX. A tenant can have its own per-order and per-day caps, which apply to its accounts (the lowest cap among CorpX's and the two tenants of the order is the one that applies). The `username` is unique across the whole market.

In an order between tenants, the amount is held in the buyer's account, in the buyer's tenant, and goes by internal transfer to the seller, in the seller's tenant. Each party gets the webhooks in its own tenant. The counterparty stays anonymous: no response or webhook says which tenant it belongs to.

## Actors

| Actor           | Role                                                                                                          |
| --------------- | ------------------------------------------------------------------------------------------------------------- |
| **Buyer**       | Pays in BRL and receives the crypto in their wallet.                                                          |
| **Seller**      | Sends the crypto and receives the BRL.                                                                        |
| **Advertiser**  | Whoever published the ad. Can be the seller (`sell` ad) or the buyer (`buy` ad). Pays the intermediation fee. |
| **CorpX**       | Holds the amount, checks the transfer, pays the seller, charges the fee and decides disputes.                 |
| **The network** | Tron, Ethereum or Polygon. It is where the crypto moves; CorpX only reads it.                                 |
| **Elliptic**    | Risk screening of wallets and transactions.                                                                   |
| **Dracma**      | Electronic signature of the order contract.                                                                   |

## How the money and the crypto move

```mermaid
flowchart LR
    B["Buyer account<br />(BRL)"] -- "1. hold on opening" --> H[("Hold at CorpX")]
    H -- "4. payment<br /><code>p2p-{orderId}</code>" --> S["Seller account<br />(BRL)"]
    S -. "4b. fee, when the seller pays<br /><code>fee-p2p-{orderId}</code>" .-> I["CorpX intermediation account"]
    H -. "4b. fee, when the buyer pays" .-> I
    SW["Seller wallet"] -- "2. crypto on the network" --> BW["Buyer wallet"]
    SW -.-> C{{"3. CorpX checks<br />txid, confirmations and screening"}}
    BW -.-> C
```

The crypto never passes through CorpX: it goes straight from the seller's wallet to the buyer's. The BRL never leaves CorpX: it stays held in the buyer's account and goes to the seller by internal transfer.

## Glossary

| Term                       | What it is                                                                                                                         |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Ad**                     | A buy or sell offer with price, limits and stock.                                                                                  |
| **Order**                  | A trade opened on an ad. Its id is `ord_…`.                                                                                        |
| **Hold**                   | The lock on the buyer's amount. It appears in [Balance holds](/baas/guias/conta/bloqueios-de-saldo) with `source.type: p2p_order`. |
| **txid**                   | The transaction hash on the network, reported by the seller.                                                                       |
| **Release**                | The buyer confirms receipt; the hold pays the seller.                                                                              |
| **Dispute**                | When a party contests. CorpX decides to release to the seller or refund the buyer.                                                 |
| **KYC intermediation fee** | The CorpX fee, in basis points over the amount, set by the advertiser's level.                                                     |
| **Receipt**                | The summary of the concluded trade, with the parties identified.                                                                   |

## Scopes

| Scope         | Grants                                                                                                 |
| ------------- | ------------------------------------------------------------------------------------------------------ |
| `p2p.read`    | Market, public profiles, and the account's profile, wallets, ads and orders (read). `read` also reads. |
| `p2p.wallets` | Register, change the default and remove wallets.                                                       |
| `p2p.ads`     | Profile, advertiser request and ads.                                                                   |
| `p2p.trade`   | Open, cancel, report txid, release and dispute orders. Issued by CorpX only.                           |

Every order route is M2M only. Releasing goes through the cashout locks and the buyer's transaction PIN. Opening goes through them only when the taker buys (sell ad): that is whose balance is held. Taking a buy ad means selling, nothing leaves that account, and it opens without a PIN.

## Section map

* [Getting started](/baas/guias/p2p/primeiros-passos): profile, wallets and screening.
* [Ads](/baas/guias/p2p/anuncios): advertiser, stock, limits and fee.
* [Orders](/baas/guias/p2p/ordens): the lifecycle, the timeline and the receipt.
* [Contract signature](/baas/guias/p2p/assinatura).
* [Transfer and verification](/baas/guias/p2p/envio-e-conferencia).
* [Disputes](/baas/guias/p2p/disputas).
* [Money and fee](/baas/guias/p2p/dinheiro-e-taxa).
* [Statement and balance](/baas/guias/p2p/extrato-e-saldo).
* [Webhooks](/baas/guias/p2p/webhooks).
* [Internet banking guide](/baas/guias/p2p/guia-internet-banking).
* [FAQ](/baas/guias/p2p/faq).

## Privacy

Until the trade concludes, each party sees only the other's `username` and reputation, never its tenant. The counterparty's name and document appear **only on the receipt** (`GET .../receipt`), after conclusion, with the document masked. In the statement, the counterparty of every order leg is `ORDEM P2P CRIPTO`.

Error codes are in the **P2P Crypto** section of [Error Handling](/baas/guias/referencia/erros).