PayZu CâmbioEventos de webhook

Depósito confirmado

WEBHOOKdeposit.confirmed

Confira o passo a passo → https://docs.payzu.com.br/docs/fx/webhooks


Headers

PayZu-Signaturestringobrigatório
t= com o instante da tentativa, em segundos (Unix), e v1= com o HMAC-SHA256, em hexadecimal, de <t>.<corpo cru>, com o segredo do webhook como chave.
PayZu-Event-Idstringobrigatório
O id do evento. Igual em todas as tentativas.
PayZu-Event-Typestringobrigatório
Evento.deposit.confirmed
PayZu-Delivery-Idstringobrigatório
Identificador da entrega.
PayZu-Delivery-Attemptstringobrigatório
Número da tentativa, a partir de 1.

Body

idstringobrigatório
Identificador do evento, o mesmo de PayZu-Event-Id. Igual em todas as tentativas.
typestringobrigatório
Evento. O mesmo de PayZu-Event-Type.deposit.confirmed
versionintegerobrigatório
Versão do formato do evento. Valor atual: 1.
occurredAtstringobrigatório
Quando o evento aconteceu.
createdAtstringobrigatório
Quando o evento foi registrado.
accountNumberstringobrigatório
Número da conta que produziu o evento.
dataobjectobrigatório
A movimentação, no formato de GET /v1/activity/{code}.
codestringobrigatório
Código da movimentação.
kindstringobrigatório
Tipo da movimentação.depositbuysellwithdrawal
statusstringobrigatório
Status da movimentação.
currencystringobrigatório
Moeda do valor.BRLUSDT
amountstringobrigatório
Valor da movimentação.
brlAmountstring | nullobrigatório
Valor em BRL, em centavos.
receivedAmountstring | nullobrigatório
Valor recebido.
feeBrlstring | nullobrigatório
Taxa em BRL, em centavos.
networkstring | nullobrigatório
Rede da movimentação.
ratestring | nullobrigatório
Cotação, em reais por USDT.
createdAtstringobrigatório
Data e hora da criação.
updatedAtstringobrigatório
Data e hora da última alteração.
confirmedAtstring | nullobrigatório
Data e hora da confirmação.
depositobject | nullobrigatório
Dados do depósito.
buyobject | nullobrigatório
Compra ligada ao depósito, quando há.
statusstringobrigatório
Status dessa compra.
orderCodestring | nullobrigatório
Código dessa compra.
withdrawalobject | nullobrigatório
Dados do saque.
walletLabelstring | nullobrigatório
Nome da carteira de destino.
addressstring | nullobrigatório
Endereço de destino.
feestringobrigatório
Taxa do saque.
submittedAtstring | nullobrigatório
Data e hora do envio do saque.
txIdstring | nullobrigatório
Hash da transação na rede.
explorerUrlstring | nullobrigatório
Página da transação na rede.

Responses

2XXQualquer 2xx em até 10 segundos confirma a entrega.

sem corpo

Exemploapplication/json
{  "id": "evt_2b7d4e9a-6c1f-4a3e-8d5b-0f9c2e7a1b46",  "type": "deposit.confirmed",  "version": 1,  "occurredAt": "2026-11-10T12:01:00.000Z",  "createdAt": "2026-11-10T12:01:00.512Z",  "accountNumber": "900123",  "data": {    "code": "RW-1",    "kind": "deposit",    "status": "confirmed",    "currency": "BRL",    "amount": "150000",    "brlAmount": "150000",    "receivedAmount": "150000",    "feeBrl": null,    "network": null,    "rate": null,    "createdAt": "2026-11-10T12:00:00.000Z",    "updatedAt": "2026-11-10T12:01:00.000Z",    "confirmedAt": "2026-11-10T12:01:00.000Z",    "deposit": {      "buy": null    },    "withdrawal": null  }}