Skip to navigation

P2P Cripto — webhooks

Os eventos P2P saem para a conta envolvida, com o mesmo envelope dos outros webhooks (id, type, occurredAt, tenantId, accountId, data). Eventos de ordem e de disputa saem um para cada parte, cada um com a visão daquela parte em data e no tenant daquela parte (tenantId): numa ordem entre tenants, cada tenant recebe só o evento da própria conta. Assine pelos tipos abaixo em POST /v1/webhooks/subscriptions.

Eventos

EventoQuandodata
p2p.order.updatedA ordem mudou de status ou de passo.A ordem como em GET .../orders/{orderId}, mais event.
p2p.order.signature.requestedA via da parte foi enviada para assinatura.orderId, role, status, signatureUrl, deadlineAt.
p2p.order.txid.checkedUm txid mudou de estado na conferência.A ordem, mais event: txid_checked, txid e checkStatus.
p2p.dispute.updatedA disputa abriu, teve pedido de informação, resposta ou decisão.A disputa, mais event e role.
p2p.wallet.screenedA carteira terminou a triagem.A carteira (walletId, network, address, screeningStatus, …).
p2p.advertiser.updatedO pedido de anunciante foi decidido, ou o anunciante foi suspenso ou reativado.accountId, advertiserStatus, level, occurredAt.
account.hold.createdO valor do comprador foi bloqueado na abertura.O hold, com reason: p2p_order.
account.hold.released / account.hold.cancelledO bloqueio da ordem foi liberado ou desfeito.O hold.

event em p2p.order.updated

eventSignificado
fundedOrdem aberta, valor bloqueado.
signing_startedContrato gerado; começa a assinatura do comprador.
buyer_signed, seller_signedUma via foi assinada.
signedAs duas vias assinadas (ou assinatura desligada). Corre o prazo do vendedor.
crypto_sentO vendedor informou o txid.
txid_invalidOs txids não conferem; a ordem voltou a signed.
crypto_confirmedValor confirmado na rede. Corre o prazo de liberação.
dispute_openedA ordem entrou em disputa.
releasedO comprador liberou; vendedor pago.
resolvedA disputa foi decidida e executada.
cancelledA ordem foi cancelada.
release_failed, cancel_failedA transferência ou a devolução falhou; a CorpX refaz. lastError traz o código.

event em p2p.dispute.updated

opened, info_requested, reply e decided.

Exemplo

{
"id": "p2p-order-evt-1842-buyer",
"type": "p2p.order.updated",
"occurredAt": "2026-11-01T14:03:12Z",
"tenantId": "tenant-acme",
"accountId": "acc_comprador",
"data": {
"event": "crypto_confirmed",
"orderId": "ord_4235120236fa625f2a539d0c",
"role": "buyer",
"side": "buy",
"status": "crypto_confirmed",
"pair": "USDT_TRON",
"amount": "1000.00",
"cryptoAmount": "196.29",
"fee": "5.00",
"feePayer": "seller",
"heldAmount": "1000.00",
"counterparty": { "username": "ciclano", "reputation": { "tradesTotal": 42, "completionPercent": "97.62", "deliveryMedianSeconds": 540, "deliveryPercentile": 80 } },
"deadlineAt": "2026-11-02T14:03:12Z",
"releaseDeadlineAt": "2026-11-02T14:03:12Z"
}
}

O id é estável por evento e parte: use-o para descartar repetições.

Transferências da ordem

A liberação gera transferências internas com identifier reservado. Os webhooks transfer.internal.in, transfer.internal.out, fee.charged e fee.refunded dessas transferências chegam com a apresentação P2P:

{
"type": "transfer.internal.in",
"data": {
"transactionId": "internal-…",
"amount": 1000.00,
"identifier": "p2p-ord_4235120236fa625f2a539d0c",
"description": "VENDA P2P CRIPTO",
"p2pOrderId": "ord_4235120236fa625f2a539d0c",
"p2pKind": "payment",
"source": { "name": "ORDEM P2P CRIPTO" },
"destination": { "name": "…", "accountId": "acc_vendedor" }
}
}

A contraparte nunca traz documento nem conta. Descrições e p2pKind como em Extrato e saldo.