> This page is for Internet banking (beta).

> 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 — extrato e saldo

Uma ordem P2P aparece em três lugares da conta: no **saldo** (o valor travado), em **bloqueios** (o hold com a ordem de origem) e no **extrato** (as transferências da liberação). Em todos, a contraparte é anônima.

## Linha do tempo da conta

```mermaid
sequenceDiagram
    participant C as Conta do comprador
    participant V as Conta do vendedor
    participant I as Intermediação CorpX
    Note over C: Abertura: available cai,<br />heldAmount sobe,<br />hold active com source p2p_order
    Note over C,V: Liberação
    C->>V: COMPRA P2P CRIPTO / VENDA P2P CRIPTO<br />p2p-{orderId}
    V->>I: TAXA INTERMEDIAÇÃO KYC P2P CRIPTO<br />fee-p2p-{orderId} (vendedor paga)
    Note over C: hold released, heldAmount volta
```

Quando o comprador paga a taxa, ela sai do próprio bloqueio: a linha `TAXA INTERMEDIAÇÃO KYC P2P CRIPTO` aparece no extrato do comprador, não no do vendedor. No cancelamento, não há linha de extrato: o hold vira `cancelled` e o saldo volta ao disponível.

## Saldo

`GET /v1/accounts/{accountId}/balance` traz `heldAmount`: a parte do `locked` que são bloqueios pela API, incluindo os de ordens P2P. Para ver quais são, use `GET .../holds?status=held`; a soma da lista bate com `heldAmount`. Detalhes em [Bloqueios de saldo](/baas/guias/conta/bloqueios-de-saldo).

## Extrato

Toda linha com identifier `p2p-…` ou `fee-p2p-…` ganha a apresentação P2P, no extrato, no extrato avançado, no detalhe da transação e no export:

| Perna                                  | `description` / `title`                     | `type`              | `feeServiceType` |
| -------------------------------------- | ------------------------------------------- | ------------------- | ---------------- |
| Pagamento, débito do comprador         | `COMPRA P2P CRIPTO`                         | `INTERNAL_TRANSFER` | —                |
| Pagamento, crédito do vendedor         | `VENDA P2P CRIPTO`                          | `INTERNAL_TRANSFER` | —                |
| Taxa, débito de quem paga              | `TAXA INTERMEDIAÇÃO KYC P2P CRIPTO`         | `FEE`               | `P2P_CRYPTO`     |
| Estorno da taxa, crédito de quem pagou | `ESTORNO TAXA INTERMEDIAÇÃO KYC P2P CRIPTO` | `FEE`               | `P2P_CRYPTO`     |

Em todas: `partnerType: P2P_CRYPTO_ORDER` e a contraparte (`payer` ou `beneficiary`) é só `{ "name": "ORDEM P2P CRIPTO" }`, sem documento nem conta.

Cada linha traz também:

* `p2pOrderId` e `p2pKind` (`payment`, `fee` ou `fee_refund`);
* `p2pOrder`: um resumo da **sua** ordem, sem dado da contraparte.

```json
{
  "identifier": "p2p-ord_4235120236fa625f2a539d0c",
  "description": "VENDA P2P CRIPTO",
  "type": "INTERNAL_TRANSFER",
  "direction": "IN",
  "amount": 1000.00,
  "partnerType": "P2P_CRYPTO_ORDER",
  "payer": { "name": "ORDEM P2P CRIPTO" },
  "p2pOrderId": "ord_4235120236fa625f2a539d0c",
  "p2pKind": "payment",
  "p2pOrder": {
    "orderId": "ord_4235120236fa625f2a539d0c",
    "kind": "payment",
    "role": "seller",
    "side": "sell",
    "pair": "USDT_TRON",
    "cryptoAmount": "196.29"
  }
}
```

Se o crédito do vendedor chegar sem identifier (algumas liquidações não o repassam), a CorpX reconhece a ordem pelo id da transferência e aplica a mesma apresentação.

## Detalhe da transação

`GET /v1/accounts/{accountId}/statement/entries/{partnerId}` de uma linha P2P traz `p2pNegotiation`:

* resumo da ordem (status, par, valores, `role`, `feePayer`, `netAmount`);
* `concluded` e `concludedAt`;
* a `timeline` da ordem, com a mesma regra de anonimato da ordem;
* `receipt`, quando a ordem está concluída: o mesmo conteúdo de `GET .../p2p/orders/{orderId}/receipt`.

Assim o internet banking mostra a negociação inteira a partir do extrato, sem outra chamada.

## Webhooks de transferência

`transfer.internal.in`, `transfer.internal.out`, `fee.charged` e `fee.refunded` com identifier P2P chegam com a mesma `description` do extrato, `p2pOrderId`, `p2pKind`, e a contraparte (`source`/`destination`, `payer`/`receiver`) reduzida a `{ "name": "ORDEM P2P CRIPTO" }`. Veja [Webhooks da conta](/baas/guias/conta/webhooks).