PayZu Conta HubEventos de webhook

Depósito recebido

WEBHOOKDEPOSIT_RECEIVED

Confira o passo a passo → https://docs.payzu.com.br/docs/account-hub/webhooks


A conta recebeu, sem cobrança, um Pix numa chave dela ou uma TED.

Headers

X-Payzu-Eventstringobrigatório
Evento.DEPOSIT_RECEIVED
X-Payzu-Deliverystringobrigatório
Identificador da entrega. Igual em todas as tentativas e no reenvio.
X-Payzu-Timestampstringobrigatório
Instante desta tentativa, em milissegundos (Unix). Entra na assinatura.
X-Payzu-Signaturestringobrigatório
sha256= seguido do HMAC-SHA256, em hexadecimal, de <X-Payzu-Timestamp>.<corpo cru>.

Body

eventstringobrigatório
Evento. O mesmo de X-Payzu-Event.DEPOSIT_RECEIVED
idstringobrigatório
Identificador da entrega, o mesmo de X-Payzu-Delivery. Igual em todas as tentativas e no reenvio.
sentAtstringobrigatório
Quando a primeira tentativa foi montada. Não muda na retentativa nem no reenvio.
accountIdstringobrigatório
Conta que produziu o evento.
dataobjectobrigatório
Corpo do evento.
depositIdstringobrigatório
Identificador do depósito. Aceito em GET /transactions/deposit/{depositId}.
amountintegerobrigatório
Valor recebido, em centavos.
serviceFeeintegerobrigatório
Tarifa do recebimento, em centavos.
netAmountintegerobrigatório
amount − serviceFee: o que foi creditado.
methodstringobrigatório
Como o dinheiro entrou: PIX ou TED recebida.PIXTED
endToEndIdstring | nullobrigatório
End-to-end do Pix recebido. null quando method é TED, que não tem end-to-end.
payerNamestring
Nome do pagador, quando o banco parceiro informa.
payerDocumentstring
CPF ou CNPJ do pagador, inteiro, como o banco parceiro informou. Só quando informado.

Responses

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

sem corpo

Exemploapplication/json
{  "event": "DEPOSIT_RECEIVED",  "id": "cmu1r7x2k001001s6dlvr0010",  "sentAt": "2026-10-05T14:33:12.093Z",  "accountId": "cmu0z8k2a000001s6acct0001",  "data": {    "depositId": "cmu4a1b2c000001s6xyz98765",    "amount": 5000,    "serviceFee": 50,    "netAmount": 4950,    "method": "PIX",    "endToEndId": "E99999999202610051433a1b2c3d4e5f",    "payerName": "João Pereira",    "payerDocument": "12345678909"  }}