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).
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
- Mensagens:
POST .../disputes/messagescombody(até 2.000 caracteres). Quando a CorpX pediu informação, a resposta da parte pedida volta a disputa paraopen. - Evidências:
POST .../disputes/evidence/upload-urldevolve uma URL de upload (PUT) para PDF, JPEG, PNG ou WebP de até 5 MB. Depois do upload,POST .../disputes/evidenceregistra o arquivo comkey,evidenceId,filename,contentTypeesizeBytes. - 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
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.updateda cada mudança (aberta, informação pedida, resposta, decidida).p2p.order.updatedquando a ordem entra emdisputede quando chega aresolved.