Skip to navigation

P2P Cripto — extrato e saldo

Uma ordem P2P aparece em três lugares da conta: no saldo (o valor travado), em bloqueios (o hold com a ordem de origem) e no extrato (as transferências da liberação). Em todos, a contraparte é anônima.

Linha do tempo da conta

Quando o comprador paga a taxa, ela sai do próprio bloqueio: a linha TAXA INTERMEDIAÇÃO KYC P2P CRIPTO aparece no extrato do comprador, não no do vendedor. No cancelamento, não há linha de extrato: o hold vira cancelled e o saldo volta ao disponível.

Saldo

GET /v1/accounts/{accountId}/balance traz heldAmount: a parte do locked que são bloqueios pela API, incluindo os de ordens P2P. Para ver quais são, use GET .../holds?status=held; a soma da lista bate com heldAmount. Detalhes em Bloqueios de saldo.

Extrato

Toda linha com identifier p2p-… ou fee-p2p-… ganha a apresentação P2P, no extrato, no extrato avançado, no detalhe da transação e no export:

Pernadescription / titletypefeeServiceType
Pagamento, débito do compradorCOMPRA P2P CRIPTOINTERNAL_TRANSFER—
Pagamento, crédito do vendedorVENDA P2P CRIPTOINTERNAL_TRANSFER—
Taxa, débito de quem pagaTAXA INTERMEDIAÇÃO KYC P2P CRIPTOFEEP2P_CRYPTO
Estorno da taxa, crédito de quem pagouESTORNO TAXA INTERMEDIAÇÃO KYC P2P CRIPTOFEEP2P_CRYPTO

Em todas: partnerType: P2P_CRYPTO_ORDER e a contraparte (payer ou beneficiary) é só { "name": "ORDEM P2P CRIPTO" }, sem documento nem conta.

Cada linha traz também:

  • p2pOrderId e p2pKind (payment, fee ou fee_refund);
  • p2pOrder: um resumo da sua ordem, sem dado da contraparte.
{
"identifier": "p2p-ord_4235120236fa625f2a539d0c",
"description": "VENDA P2P CRIPTO",
"type": "INTERNAL_TRANSFER",
"direction": "IN",
"amount": 1000.00,
"partnerType": "P2P_CRYPTO_ORDER",
"payer": { "name": "ORDEM P2P CRIPTO" },
"p2pOrderId": "ord_4235120236fa625f2a539d0c",
"p2pKind": "payment",
"p2pOrder": {
"orderId": "ord_4235120236fa625f2a539d0c",
"kind": "payment",
"role": "seller",
"side": "sell",
"pair": "USDT_TRON",
"cryptoAmount": "196.29"
}
}

Se o crédito do vendedor chegar sem identifier (algumas liquidações não o repassam), a CorpX reconhece a ordem pelo id da transferência e aplica a mesma apresentação.

Detalhe da transação

GET /v1/accounts/{accountId}/statement/entries/{partnerId} de uma linha P2P traz p2pNegotiation:

  • resumo da ordem (status, par, valores, role, feePayer, netAmount);
  • concluded e concludedAt;
  • a timeline da ordem, com a mesma regra de anonimato da ordem;
  • receipt, quando a ordem está concluída: o mesmo conteúdo de GET .../p2p/orders/{orderId}/receipt.

Assim o internet banking mostra a negociação inteira a partir do extrato, sem outra chamada.

Webhooks de transferência

transfer.internal.in, transfer.internal.out, fee.charged e fee.refunded com identifier P2P chegam com a mesma description do extrato, p2pOrderId, p2pKind, e a contraparte (source/destination, payer/receiver) reduzida a { "name": "ORDEM P2P CRIPTO" }. Veja Webhooks da conta.