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

Quando as partes não se entendem, ou um prazo vence no meio da entrega, a ordem vai para `disputed` e a CorpX decide. Enquanto a disputa está aberta, o valor segue bloqueado e nenhum prazo corre.

## Quem abre e quando

`POST .../p2p/orders/{orderId}/disputes` com `reason` (`crypto_not_received`, `wrong_amount`, `release_not_done`, `other`) e `description` opcional (até 2.000 caracteres).

| Quem               | Status da ordem                             | Condição                                                        |
| ------------------ | ------------------------------------------- | --------------------------------------------------------------- |
| Comprador          | `signed`, `crypto_sent`, `crypto_confirmed` | A qualquer momento.                                             |
| Vendedor           | `crypto_sent`                               | 60 min depois de informar o txid.                               |
| Vendedor           | `crypto_confirmed`                          | 24 h depois da confirmação.                                     |
| CorpX (automática) | `signed`                                    | Prazo de envio vencido sem txid válido (`crypto_not_received`). |
| CorpX (automática) | `crypto_sent`                               | Rede sem confirmação em 60 min (`onchain_unconfirmed`).         |
| CorpX (automática) | `crypto_confirmed`                          | Comprador não liberou no prazo (`release_overdue`).             |

Fora dessas condições: `409 dispute_not_allowed_yet`. Ordem com disputa: `409 dispute_already_open`. A resposta é `201` com a disputa, ou `202` com `status: opening` se ela ainda está sendo gravada.

## Fluxo

```mermaid
stateDiagram-v2
    [*] --> open: parte ou CorpX abre
    open --> info_requested: CorpX pede informação
    info_requested --> open: a parte responde
    open --> decided: CorpX decide
    info_requested --> decided: CorpX decide
    decided --> [*]
```

* **Mensagens:** `POST .../disputes/messages` com `body` (até 2.000 caracteres). Quando a CorpX pediu informação, a resposta da parte pedida volta a disputa para `open`.
* **Evidências:** `POST .../disputes/evidence/upload-url` devolve uma URL de upload (PUT) para PDF, JPEG, PNG ou WebP de até 5 MB. Depois do upload, `POST .../disputes/evidence` registra o arquivo com `key`, `evidenceId`, `filename`, `contentType` e `sizeBytes`.
* Depois de decidida, mensagens e evidências respondem `409 dispute_already_decided`.
* A **evidência de preço** da ordem (a consulta à Binance que travou o preço, em `GET .../p2p/orders/{orderId}/price-evidence`) já faz parte da análise; não precisa ser anexada.

Mensagem com contato ou pagamento por fora é marcada para a CorpX.

## Decisão

```mermaid
flowchart LR
    D["CorpX decide"] --> S{"Decisão"}
    S -- "release_to_seller" --> R["Valor ao vendedor<br />e taxa cobrada"]
    S -- "refund_buyer" --> B["Bloqueio desfeito:<br />valor volta ao comprador"]
    R --> F["Ordem resolved<br />(concluída)"]
    B --> G["Ordem resolved<br />(não concluída)"]
```

A disputa decidida traz `decision`, `fault` (`buyer`, `seller` ou `none`) e a nota da CorpX. A falta entra na reputação. Na devolução ao comprador, a taxa não é cobrada.

Se a transferência da decisão falhar, a ordem fica em `disputed` com `lastError` e a CorpX refaz pela mesa, sem nova decisão.

## Webhooks

* `p2p.dispute.updated` a cada mudança (aberta, informação pedida, resposta, decidida).
* `p2p.order.updated` quando a ordem entra em `disputed` e quando chega a `resolved`.