> 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 — webhooks

Os eventos P2P saem para a conta envolvida, com o mesmo envelope dos outros webhooks (`id`, `type`, `occurredAt`, `tenantId`, `accountId`, `data`). Eventos de ordem e de disputa saem **um para cada parte**, cada um com a visão daquela parte em `data` e no tenant daquela parte (`tenantId`): numa ordem entre tenants, cada tenant recebe só o evento da própria conta. Assine pelos tipos abaixo em `POST /v1/webhooks/subscriptions`.

## Eventos

| Evento                                             | Quando                                                                          | `data`                                                               |
| -------------------------------------------------- | ------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| `p2p.order.updated`                                | A ordem mudou de status ou de passo.                                            | A ordem como em `GET .../orders/{orderId}`, mais `event`.            |
| `p2p.order.signature.requested`                    | A via da parte foi enviada para assinatura.                                     | `orderId`, `role`, `status`, `signatureUrl`, `deadlineAt`.           |
| `p2p.order.txid.checked`                           | Um txid mudou de estado na conferência.                                         | A ordem, mais `event: txid_checked`, `txid` e `checkStatus`.         |
| `p2p.dispute.updated`                              | A disputa abriu, teve pedido de informação, resposta ou decisão.                | A disputa, mais `event` e `role`.                                    |
| `p2p.wallet.screened`                              | A carteira terminou a triagem.                                                  | A carteira (`walletId`, `network`, `address`, `screeningStatus`, …). |
| `p2p.advertiser.updated`                           | O pedido de anunciante foi decidido, ou o anunciante foi suspenso ou reativado. | `accountId`, `advertiserStatus`, `level`, `occurredAt`.              |
| `account.hold.created`                             | O valor do comprador foi bloqueado na abertura.                                 | O hold, com `reason: p2p_order`.                                     |
| `account.hold.released` / `account.hold.cancelled` | O bloqueio da ordem foi liberado ou desfeito.                                   | O hold.                                                              |

## `event` em `p2p.order.updated`

| `event`                           | Significado                                                                      |
| --------------------------------- | -------------------------------------------------------------------------------- |
| `funded`                          | Ordem aberta, valor bloqueado.                                                   |
| `signing_started`                 | Contrato gerado; começa a assinatura do comprador.                               |
| `buyer_signed`, `seller_signed`   | Uma via foi assinada.                                                            |
| `signed`                          | As duas vias assinadas (ou assinatura desligada). Corre o prazo do vendedor.     |
| `crypto_sent`                     | O vendedor informou o txid.                                                      |
| `txid_invalid`                    | Os txids não conferem; a ordem voltou a `signed`.                                |
| `crypto_confirmed`                | Valor confirmado na rede. Corre o prazo de liberação.                            |
| `dispute_opened`                  | A ordem entrou em disputa.                                                       |
| `released`                        | O comprador liberou; vendedor pago.                                              |
| `resolved`                        | A disputa foi decidida e executada.                                              |
| `cancelled`                       | A ordem foi cancelada.                                                           |
| `release_failed`, `cancel_failed` | A transferência ou a devolução falhou; a CorpX refaz. `lastError` traz o código. |

## `event` em `p2p.dispute.updated`

`opened`, `info_requested`, `reply` e `decided`.

## Exemplo

```json
{
  "id": "p2p-order-evt-1842-buyer",
  "type": "p2p.order.updated",
  "occurredAt": "2026-11-01T14:03:12Z",
  "tenantId": "tenant-acme",
  "accountId": "acc_comprador",
  "data": {
    "event": "crypto_confirmed",
    "orderId": "ord_4235120236fa625f2a539d0c",
    "role": "buyer",
    "side": "buy",
    "status": "crypto_confirmed",
    "pair": "USDT_TRON",
    "amount": "1000.00",
    "cryptoAmount": "196.29",
    "fee": "5.00",
    "feePayer": "seller",
    "heldAmount": "1000.00",
    "counterparty": { "username": "ciclano", "reputation": { "tradesTotal": 42, "completionPercent": "97.62", "deliveryMedianSeconds": 540, "deliveryPercentile": 80 } },
    "deadlineAt": "2026-11-02T14:03:12Z",
    "releaseDeadlineAt": "2026-11-02T14:03:12Z"
  }
}
```

O `id` é estável por evento e parte: use-o para descartar repetições.

## Transferências da ordem

A liberação gera transferências internas com identifier reservado. Os webhooks `transfer.internal.in`, `transfer.internal.out`, `fee.charged` e `fee.refunded` dessas transferências chegam com a apresentação P2P:

```json
{
  "type": "transfer.internal.in",
  "data": {
    "transactionId": "internal-…",
    "amount": 1000.00,
    "identifier": "p2p-ord_4235120236fa625f2a539d0c",
    "description": "VENDA P2P CRIPTO",
    "p2pOrderId": "ord_4235120236fa625f2a539d0c",
    "p2pKind": "payment",
    "source": { "name": "ORDEM P2P CRIPTO" },
    "destination": { "name": "…", "accountId": "acc_vendedor" }
  }
}
```

A contraparte nunca traz documento nem conta. Descrições e `p2pKind` como em [Extrato e saldo](/baas/guias/p2p/extrato-e-saldo).