Skip to navigation

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).

QuemStatus da ordemCondição
Compradorsigned, crypto_sent, crypto_confirmedA qualquer momento.
Vendedorcrypto_sent60 min depois de informar o txid.
Vendedorcrypto_confirmed24 h depois da confirmação.
CorpX (automática)signedPrazo de envio vencido sem txid válido (crypto_not_received).
CorpX (automática)crypto_sentRede sem confirmação em 60 min (onchain_unconfirmed).
CorpX (automática)crypto_confirmedComprador 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

parte ou CorpX abre CorpX pede informação a parte responde CorpX decide CorpX decide open info_requested 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

release_to_seller refund_buyer CorpX decide Decisão Valor ao vendedore taxa cobrada Bloqueio desfeito:valor volta ao comprador Ordem resolved(concluída) Ordem resolved(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.