> 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 — dinheiro e taxa

O dinheiro de uma ordem nunca sai da CorpX sem a cripto conferida. Na abertura, o valor do comprador é **bloqueado** na conta dele; na liberação, vira transferência interna para o vendedor; no cancelamento ou na devolução, o bloqueio é desfeito.

## Caminho do dinheiro

```mermaid
flowchart TD
    A["Abertura"] --> H["Bloqueio na conta do comprador<br />(hold, status active)"]
    H --> X{"Desfecho"}
    X -- "liberação ou disputa<br />para o vendedor" --> R["Transferência interna<br />p2p-{orderId} ao vendedor"]
    R --> F["Taxa fee-p2p-{orderId}<br />para a conta de intermediação CorpX"]
    X -- "cancelamento ou disputa<br />para o comprador" --> C["Bloqueio desfeito<br />(saldo volta a ficar disponível)"]
```

* O bloqueio aparece em `GET /v1/accounts/{accountId}/holds` com `source.type: p2p_order` (veja [Extrato e saldo](/baas/guias/p2p/extrato-e-saldo)).
* O saldo mostra a parte travada em `heldAmount`.
* A transferência e a taxa usam identifiers reservados: `p2p-{orderId}` e `fee-p2p-{orderId}`. Um estorno de taxa, se houver, usa `fee-p2p-{orderId}-r`.

## Quem paga a taxa

A taxa de intermediação é paga por **quem publicou o anúncio**, com o percentual (`feeBps`) do nível dele.

### Anúncio de venda: o vendedor paga

Ordem de R\$ 1.000,00 num anúncio `sell` de um anunciante com `feeBps` 50 (0,5%):

| Passo         | Comprador                   | Vendedor            | Intermediação CorpX |
| ------------- | --------------------------- | ------------------- | ------------------- |
| Abertura      | −1.000,00 bloqueado         | —                   | —                   |
| Liberação     | bloqueio vira transferência | +1.000,00 (`p2p-…`) | —                   |
| Taxa          | —                           | −5,00 (`fee-p2p-…`) | +5,00               |
| **Resultado** | **−1.000,00**               | **+995,00**         | **+5,00**           |

A ordem mostra `fee: "5.00"` e `feePayer: "seller"`. O comprador vê `heldAmount: "1000.00"`; o vendedor vê `netAmount: "995.00"`.

### Anúncio de compra: o comprador paga

Mesma ordem num anúncio `buy`:

| Passo         | Comprador                             | Vendedor            | Intermediação CorpX |
| ------------- | ------------------------------------- | ------------------- | ------------------- |
| Abertura      | −1.005,00 bloqueado                   | —                   | —                   |
| Liberação     | bloqueio vira transferência           | +1.000,00 (`p2p-…`) | —                   |
| Taxa          | sai do próprio bloqueio (`fee-p2p-…`) | —                   | +5,00               |
| **Resultado** | **−1.005,00**                         | **+1.000,00**       | **+5,00**           |

A ordem mostra `fee: "5.00"` e `feePayer: "buyer"`. O comprador vê `heldAmount: "1005.00"`; o vendedor vê `netAmount: "1000.00"`.

## Saldo

Abrir uma ordem exige saldo disponível do comprador para o bloqueio (`422 insufficient_available_balance`). Num anúncio `buy`, o comprador é o anunciante: sem saldo, a ordem não abre e o anúncio é pausado (`pausedReason: insufficient_balance`). Quando o vendedor paga a taxa, ela é debitada logo depois do recebimento. Se a cobrança falhar, o pagamento ao vendedor já está feito e a CorpX refaz a cobrança com o mesmo identifier: nunca há duas cobranças da mesma ordem.

## Cancelamento e devolução

Nada é cobrado: o bloqueio é desfeito por inteiro, inclusive a parte da taxa quando o comprador paga. O extrato não mostra lançamento, só o bloqueio que deixa de existir.