Skip to navigation

P2P Cripto — visão geral

O P2P Cripto é um mercado de stablecoins entre contas CorpX. O anunciante publica preço e limites; quem toma o anúncio abre uma ordem. O valor em reais do comprador fica bloqueado na CorpX até a cripto chegar, e as duas partes assinam o contrato da ordem antes do envio. A CorpX intermedeia: confere a transação na rede, guarda o dinheiro e decide as disputas.

A feature p2p_crypto nasce desligada para todos os tenants. Enquanto estiver desligada, toda rota em /v1/p2p e /v1/accounts/{accountId}/p2p responde 403 feature_disabled.

Um livro só

O mercado é um livro único da CorpX. Com a feature ligada, o tenant entra no livro inteiro: os anúncios das contas dele aparecem para as contas de todo tenant participante, e as contas dele tomam anúncios de qualquer um. Não há livro separado por tenant, nem como ficar só com os próprios anúncios.

As regras são as mesmas para todos: pares, níveis e taxa, prazos e contrato são definidos pela CorpX. O tenant pode ter teto próprio por ordem e por dia, que vale para as contas dele (o menor teto entre o da CorpX e o dos dois tenants da ordem é o que vale). O username é único no mercado inteiro.

Numa ordem entre tenants, o valor fica bloqueado na conta do comprador, no tenant dele, e vai por transferência interna para o vendedor, no tenant dele. Cada parte recebe os webhooks no próprio tenant. A contraparte continua anônima: nenhuma resposta nem webhook diz de que tenant ela é.

Atores

AtorPapel
CompradorPaga em reais e recebe a cripto na carteira dele.
VendedorEnvia a cripto e recebe os reais.
AnuncianteQuem publicou o anúncio. Pode ser o vendedor (anúncio sell) ou o comprador (anúncio buy). Paga a taxa de intermediação.
CorpXBloqueia o valor, confere o envio, paga o vendedor, cobra a taxa e decide disputas.
A redeTron, Ethereum ou Polygon. É onde a cripto anda; a CorpX só lê.
EllipticTriagem de risco das carteiras e das transações.
DracmaAssinatura eletrônica do contrato da ordem.

Como o dinheiro e a cripto andam

A cripto nunca passa pela CorpX: vai direto da carteira do vendedor para a do comprador. Os reais nunca saem da CorpX: ficam bloqueados na conta do comprador e vão por transferência interna para o vendedor.

Glossário

TermoO que é
AnúncioOferta de compra ou venda com preço, limites e estoque.
OrdemUma negociação aberta sobre um anúncio. Tem id ord_….
HoldO bloqueio do valor do comprador. Aparece em Bloqueios de saldo com source.type: p2p_order.
txidO hash da transação na rede, informado pelo vendedor.
LiberaçãoO comprador confirma que recebeu; o hold paga o vendedor.
DisputaQuando uma parte contesta. A CorpX decide liberar ao vendedor ou devolver ao comprador.
Taxa de intermediação KYCA taxa da CorpX, em pontos-base sobre o valor, pelo nível do anunciante.
ComprovanteO resumo da negociação concluída, com as partes identificadas.

Escopos

EscopoLibera
p2p.readMercado, perfis públicos, perfil, carteiras, anúncios e ordens da conta (leitura). read também lê.
p2p.walletsCadastrar, trocar a padrão e remover carteiras.
p2p.adsPerfil, pedido de anunciante e anúncios.
p2p.tradeAbrir ordem, cancelar, informar txid, liberar e disputar. Só sai por emissão da CorpX.

Toda rota de ordem é só M2M. Liberar passa pelas travas de cashout e pelo PIN de transação do comprador. Abrir ordem passa por elas só quando o taker compra (anúncio de venda): é dele que o saldo sai. Quem toma um anúncio de compra vende, nada sai da conta dele, e abre sem PIN.

Mapa da seção

Privacidade

Até a negociação concluir, cada parte vê da outra só o username e a reputação, nunca o tenant. O nome e o documento da contraparte aparecem só no comprovante (GET .../receipt), depois da conclusão, com o documento mascarado. No extrato, a contraparte de toda perna da ordem é ORDEM P2P CRIPTO.

Códigos de erro na seção P2P Cripto de Tratamento de Erros.