P2P Cripto — guia do internet banking
Este guia mapeia as telas de um internet banking com P2P Cripto para as chamadas da API e diz o que mostrar em cada uma. Tudo aqui vale para o IB da CorpX e para o de qualquer tenant.
Mapa de telas
Abrir ordem
Carregue o anúncio por GET /v1/p2p/ads/{adId}, não pelo item da lista: assim a tela abre por link direto e volta depois de recarregar. O detalhe traz os campos do item da lista mais network, asset e decimals do par. 404 ad_not_found quer dizer que o anúncio saiu do livro: volte ao mercado. Para abrir a ordem, mande sempre walletId, a carteira do cliente na rede do par; a API decide pelo lado do anúncio qual carteira é a de origem e qual é a de destino.
Tela da ordem
- Cabeçalho: par,
cryptoAmount,price,amount, status e o cronômetro comdeadlineAt(some quando énull). - Valores: o comprador vê
heldAmount(o que saiu do saldo); o vendedor vênetAmount(o que vai receber). Mostrefeee diga quem paga pelofeePayer. - Contraparte: só
counterparty.usernamee a reputação. Nunca peça nem mostre o nome antes do comprovante. - Ação do momento:
- Timeline: liste
timelinecomo veio, do mais antigo para o mais novo. Otitlejá está pronto e relativo a quem lê; destaqueactorIsYou. - Txids: para cada txid,
checkStatus,confirmationse um link para o explorador da rede.
Atualize a tela pelo webhook p2p.order.updated (ou pelo GET da ordem); não calcule status no cliente.
Extrato e saldo
- Linhas com
partnerType: P2P_CRYPTO_ORDERtêmp2pOrderId. Use-o para abrir a tela da ordem a partir do extrato. - O detalhe da linha já traz
p2pNegotiationcom a timeline e, se a ordem concluiu, oreceipt. Uma chamada basta para mostrar a negociação. - A contraparte é sempre
ORDEM P2P CRIPTO. Não tente resolver o nome por outro caminho. - No saldo, mostre
heldAmountcomo “bloqueado” e leve à listaGET .../holds?status=held; cada hold de ordem temsource.orderIdesource.deadlineAt.
Comprovante
Só existe com concluded: true. Mostre as duas partes com nome, username e documento mascarado como veio (não desmascare nem reformate), os txids com o explorador, o pagamento e a taxa com os identifiers e o horário de cada passo. A via assinada da parte sai de GET .../contract, por link temporário.
Erros que a tela trata
Lista completa na seção P2P Cripto de Tratamento de Erros.