> 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 — envio e conferência da cripto

O vendedor manda a cripto da carteira dele para `destinationAddress` (a carteira do comprador escolhida na abertura) e informa o hash da transação. A CorpX confere na rede e libera o passo seguinte.

## Informar o txid

`POST .../p2p/orders/{orderId}/txids` com `{ "txid": "..." }`. Só o vendedor, e só em `signed` ou `crypto_sent`.

| Erro                          | Quando                                |
| ----------------------------- | ------------------------------------- |
| `403 order_role_not_allowed`  | Quem chamou é o comprador.            |
| `422 txid_invalid_format`     | O formato não bate com a rede do par. |
| `409 order_step_out_of_order` | A ordem não está esperando txid.      |
| `422 txid_limit_reached`      | A ordem já tem dois txids.            |
| `409 txid_already_used`       | O txid já foi usado em outra ordem.   |

Até **dois txids** por ordem: um envio parcial pode ser completado por um segundo.

## O que a CorpX confere

```mermaid
flowchart TD
    T["txid informado"] --> S["Triagem de risco da transação"]
    T --> N["Leitura na rede"]
    N --> D{"Destino = destinationAddress?<br />Token e rede certos?"}
    D -- "não" --> I["invalid"]
    D -- "sim" --> V{"Valor ≥ cryptoAmount<br />(somando os txids)?"}
    V -- "ainda não" --> P["partial"]
    V -- "sim" --> C{"Confirmações ≥ mínimo do par?"}
    C -- "não" --> W["pending (aguarda)"]
    C -- "sim" --> R{"Triagem aprovada?"}
    S --> R
    R -- "sim" --> OK["confirmed"]
    R -- "reprovada" --> I
    R -- "em análise" --> W
```

O txid só fica `confirmed` com a rede confirmada **e** a triagem aprovada; triagem reprovada torna o txid `invalid`.

Cada txid mostra `checkStatus` (`pending`, `partial`, `confirmed`, `invalid`), `onchainStatus`, `screeningStatus`, `confirmations` e `amount` (o valor visto na rede). Cada mudança gera `p2p.order.txid.checked`.

## Resultados

| Resultado                                                | O que acontece                                                                           |
| -------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| Valor confirmado                                         | Ordem `crypto_confirmed`; corre o prazo de liberação (`releaseDeadlineAt`, padrão 24 h). |
| Todos os txids inválidos, prazo do vendedor ainda aberto | Ordem volta a `signed`; o vendedor pode informar outro txid.                             |
| Todos os txids inválidos, prazo do vendedor vencido      | Disputa automática (`crypto_not_received`).                                              |
| Rede não confirma em 60 min                              | Disputa automática (`onchain_unconfirmed`).                                              |

## Liberação

`POST .../p2p/orders/{orderId}/release` com o PIN da transação. Só o comprador, e só depois do txid informado (`409 order_step_out_of_order` antes disso).

* Em `crypto_confirmed`, a liberação é o caminho normal.
* Em `crypto_sent`, o comprador pode liberar antes das confirmações, se já conferiu a carteira por conta própria. Liberar é definitivo.
* Ao liberar, a CorpX transfere o valor bloqueado ao vendedor (`p2p-{orderId}`) e cobra a taxa de quem paga (`fee-p2p-{orderId}`).
* Se a transferência falhar, a resposta é `422 release_failed` e o valor continua bloqueado. A CorpX acompanha e refaz pela mesa.
* Sem liberação até `releaseDeadlineAt`, a ordem vai para disputa (`release_overdue`).