> 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 — assinatura do contrato

Com a assinatura ligada no mercado, cada ordem gera um contrato de compra e venda que as duas partes assinam eletronicamente antes de qualquer cripto sair. Com a assinatura desligada, a ordem vai de `funded` direto para `signed`.

## Ordem das vias

```mermaid
sequenceDiagram
    autonumber
    participant API as CorpX
    participant C as Comprador
    participant V as Vendedor
    API->>API: gera o contrato e as duas vias
    API-->>C: p2p.order.signature.requested (signatureUrl)
    C->>API: assina (OTP por e-mail)
    API-->>V: p2p.order.signature.requested (signatureUrl)
    V->>API: assina (OTP por e-mail)
    API-->>C: p2p.order.updated (signed)
    API-->>V: p2p.order.updated (signed)
```

* O comprador assina primeiro, dentro de `signingDeadlineAt`.
* Depois o vendedor assina e envia a cripto, dentro de `sellerDeadlineAt`.
* A via é confirmada por **OTP no e-mail** da pessoa credenciada da conta. Conta sem pessoa com e-mail não consegue assinar e a ordem é cancelada na abertura do contrato (`cancelReason: signer_contact_missing`).

## Onde está o link

* No webhook `p2p.order.signature.requested`: `signatureUrl` e `deadlineAt`.
* No `GET .../p2p/orders/{orderId}`: `signatureUrl` aparece para a parte cuja via está pendente enquanto a ordem está em `signing`.
* `signatures[]` traz o estado das duas vias: `pending`, `sent`, `signed`, `rejected`, `expired` ou `cancelled`.

## Recusa e prazo

| Situação                                         | Resultado                                                                     |
| ------------------------------------------------ | ----------------------------------------------------------------------------- |
| Uma parte recusa a via                           | Ordem `cancelled`, `cancelReason: signature_rejected`, falta de quem recusou. |
| Prazo de assinatura vencido                      | Ordem `cancelled`, falta de quem não assinou.                                 |
| Uma parte cancela antes de assinar a própria via | Ordem `cancelled`, falta de quem cancelou.                                    |
| Provedor de assinatura indisponível              | Ordem `cancelled`, `cancelReason: signing_unavailable`, sem falta.            |

Em todos os casos o valor bloqueado volta ao comprador e o estoque volta ao anúncio.

## Via assinada

Cada parte assina a própria via. O modelo muda com o papel, com o tipo de pessoa (física ou jurídica) e com a condição de anunciante. A via de pessoa jurídica cita a empresa. Nenhuma via leva o nome, o documento ou a empresa da outra parte. A contraparte aparece pelo apelido.

Toda via traz a cotação que travou o preço: o spot da Binance no momento da abertura (`cotacao_binance`), a hora da consulta em Brasília (`cotacao_horario`) e o hash do registro completo (`cotacao_evidencia_sha256`), o mesmo que `GET .../p2p/orders/{orderId}/price-evidence` devolve.

Depois da liberação, `GET .../p2p/orders/{orderId}/contract` devolve um link temporário para baixar a via da parte. Antes disso, `409 contract_not_available`. O comprovante da ordem traz o `sha256` de cada via assinada.

## Termo de consolidação

Quando a negociação conclui (liberada ou decidida a favor do vendedor, as duas vias assinadas, o vendedor pago e a taxa cobrada), a CorpX emite um termo em PDF. Ele junta as duas partes, com documento mascarado, os dados da ordem e o SHA-256 de cada via. É um registro da CorpX, não uma nova assinatura. O mesmo arquivo serve às duas partes.

`GET .../p2p/orders/{orderId}/term` devolve um link temporário. Antes do termo existir, `409 term_not_available`. O comprovante traz `term.sha256`, `term.generatedAt` e `term.downloadPath`.