Skip to navigation

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.

ErroQuando
403 order_role_not_allowedQuem chamou é o comprador.
422 txid_invalid_formatO formato não bate com a rede do par.
409 order_step_out_of_orderA ordem não está esperando txid.
422 txid_limit_reachedA ordem já tem dois txids.
409 txid_already_usedO 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

não sim ainda não sim não sim sim reprovada em análise txid informado Triagem de risco da transação Leitura na rede Destino = destinationAddress?Token e rede certos? invalid Valor ≥ cryptoAmount(somando os txids)? partial Confirmações ≥ mínimo do par? pending (aguarda) Triagem aprovada? confirmed

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

ResultadoO que acontece
Valor confirmadoOrdem crypto_confirmed; corre o prazo de liberação (releaseDeadlineAt, padrão 24 h).
Todos os txids inválidos, prazo do vendedor ainda abertoOrdem volta a signed; o vendedor pode informar outro txid.
Todos os txids inválidos, prazo do vendedor vencidoDisputa automática (crypto_not_received).
Rede não confirma em 60 minDisputa 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).