> This page is for BaaS.

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

# P2P Cripto — visão geral

O P2P Cripto é um mercado de stablecoins entre contas CorpX. O anunciante publica preço e limites; quem toma o anúncio abre uma ordem. O valor em reais do comprador fica bloqueado na CorpX até a cripto chegar, e as duas partes assinam o contrato da ordem antes do envio. A CorpX intermedeia: confere a transação na rede, guarda o dinheiro e decide as disputas.

A feature `p2p_crypto` **nasce desligada para todos os tenants**. Enquanto estiver desligada, toda rota em `/v1/p2p` e `/v1/accounts/{accountId}/p2p` responde **403** `feature_disabled`.

## Um livro só

O mercado é um livro único da CorpX. Com a feature ligada, o tenant entra no livro inteiro: os anúncios das contas dele aparecem para as contas de todo tenant participante, e as contas dele tomam anúncios de qualquer um. Não há livro separado por tenant, nem como ficar só com os próprios anúncios.

As regras são as mesmas para todos: pares, níveis e taxa, prazos e contrato são definidos pela CorpX. O tenant pode ter teto próprio por ordem e por dia, que vale para as contas dele (o menor teto entre o da CorpX e o dos dois tenants da ordem é o que vale). O `username` é único no mercado inteiro.

Numa ordem entre tenants, o valor fica bloqueado na conta do comprador, no tenant dele, e vai por transferência interna para o vendedor, no tenant dele. Cada parte recebe os webhooks no próprio tenant. A contraparte continua anônima: nenhuma resposta nem webhook diz de que tenant ela é.

## Atores

| Ator           | Papel                                                                                                                       |
| -------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Comprador**  | Paga em reais e recebe a cripto na carteira dele.                                                                           |
| **Vendedor**   | Envia a cripto e recebe os reais.                                                                                           |
| **Anunciante** | Quem publicou o anúncio. Pode ser o vendedor (anúncio `sell`) ou o comprador (anúncio `buy`). Paga a taxa de intermediação. |
| **CorpX**      | Bloqueia o valor, confere o envio, paga o vendedor, cobra a taxa e decide disputas.                                         |
| **A rede**     | Tron, Ethereum ou Polygon. É onde a cripto anda; a CorpX só lê.                                                             |
| **Elliptic**   | Triagem de risco das carteiras e das transações.                                                                            |
| **Dracma**     | Assinatura eletrônica do contrato da ordem.                                                                                 |

## Como o dinheiro e a cripto andam

```mermaid
flowchart LR
    B["Conta do comprador<br />(reais)"] -- "1. bloqueio na abertura" --> H[("Hold na CorpX")]
    H -- "4. pagamento<br /><code>p2p-{orderId}</code>" --> S["Conta do vendedor<br />(reais)"]
    S -. "4b. taxa, quando o vendedor paga<br /><code>fee-p2p-{orderId}</code>" .-> I["Conta de intermediação CorpX"]
    H -. "4b. taxa, quando o comprador paga" .-> I
    SW["Carteira do vendedor"] -- "2. cripto na rede" --> BW["Carteira do comprador"]
    SW -.-> C{{"3. CorpX confere<br />txid, confirmações e triagem"}}
    BW -.-> C
```

A cripto nunca passa pela CorpX: vai direto da carteira do vendedor para a do comprador. Os reais nunca saem da CorpX: ficam bloqueados na conta do comprador e vão por transferência interna para o vendedor.

## Glossário

| Termo                         | O que é                                                                                                                               |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Anúncio**                   | Oferta de compra ou venda com preço, limites e estoque.                                                                               |
| **Ordem**                     | Uma negociação aberta sobre um anúncio. Tem id `ord_…`.                                                                               |
| **Hold**                      | O bloqueio do valor do comprador. Aparece em [Bloqueios de saldo](/baas/guias/conta/bloqueios-de-saldo) com `source.type: p2p_order`. |
| **txid**                      | O hash da transação na rede, informado pelo vendedor.                                                                                 |
| **Liberação**                 | O comprador confirma que recebeu; o hold paga o vendedor.                                                                             |
| **Disputa**                   | Quando uma parte contesta. A CorpX decide liberar ao vendedor ou devolver ao comprador.                                               |
| **Taxa de intermediação KYC** | A taxa da CorpX, em pontos-base sobre o valor, pelo nível do anunciante.                                                              |
| **Comprovante**               | O resumo da negociação concluída, com as partes identificadas.                                                                        |

## Escopos

| Escopo        | Libera                                                                                               |
| ------------- | ---------------------------------------------------------------------------------------------------- |
| `p2p.read`    | Mercado, perfis públicos, perfil, carteiras, anúncios e ordens da conta (leitura). `read` também lê. |
| `p2p.wallets` | Cadastrar, trocar a padrão e remover carteiras.                                                      |
| `p2p.ads`     | Perfil, pedido de anunciante e anúncios.                                                             |
| `p2p.trade`   | Abrir ordem, cancelar, informar txid, liberar e disputar. Só sai por emissão da CorpX.               |

Toda rota de ordem é só M2M. Liberar passa pelas travas de cashout e pelo PIN de transação do comprador. Abrir ordem passa por elas só quando o taker compra (anúncio de venda): é dele que o saldo sai. Quem toma um anúncio de compra vende, nada sai da conta dele, e abre sem PIN.

## Mapa da seção

* [Primeiros passos](/baas/guias/p2p/primeiros-passos): perfil, carteiras e triagem.
* [Anúncios](/baas/guias/p2p/anuncios): anunciante, estoque, limites e taxa.
* [Ordens](/baas/guias/p2p/ordens): o ciclo de vida, a timeline e o comprovante.
* [Assinatura do contrato](/baas/guias/p2p/assinatura).
* [Envio e conferência](/baas/guias/p2p/envio-e-conferencia).
* [Disputas](/baas/guias/p2p/disputas).
* [Dinheiro e taxa](/baas/guias/p2p/dinheiro-e-taxa).
* [Extrato e saldo](/baas/guias/p2p/extrato-e-saldo).
* [Webhooks](/baas/guias/p2p/webhooks).
* [Guia do internet banking](/baas/guias/p2p/guia-internet-banking).
* [Perguntas frequentes](/baas/guias/p2p/faq).

## Privacidade

Até a negociação concluir, cada parte vê da outra só o `username` e a reputação, nunca o tenant. O nome e o documento da contraparte aparecem **só no comprovante** (`GET .../receipt`), depois da conclusão, com o documento mascarado. No extrato, a contraparte de toda perna da ordem é `ORDEM P2P CRIPTO`.

Códigos de erro na seção **P2P Cripto** de [Tratamento de Erros](/baas/guias/referencia/erros).