PayZu Conta HubEventos de webhook

Conta bloqueada

WEBHOOKACCOUNT_BLOCKED

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


O banco parceiro bloqueou operações da conta, ou a lista de bloqueios mudou.

Headers

X-Payzu-Eventstringobrigatório
Evento.ACCOUNT_BLOCKED
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.ACCOUNT_BLOCKED
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.
statusstringobrigatório
SUSPENDED
blockedOperationsarray of stringsobrigatório
O que a API recusa enquanto o bloqueio vigora. PIX_IN vale para a cobrança, e PIX_OUT para o saque, o pagamento de copia e cola e a devolução. Um bloqueio que a PayZu não reconhece prende as quatro.PIX_INPIX_OUTINTERNAL_TRANSFER_OUTINTERNAL_TRANSFER_IN
changedAtstringobrigatório
Quando a situação da conta mudou.

Responses

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

sem corpo

Exemploapplication/json
{  "event": "ACCOUNT_BLOCKED",  "id": "cmu1r7x2k001701s6dlvr0017",  "sentAt": "2026-10-06T12:00:00.803Z",  "accountId": "cmu0z8k2a000001s6acct0001",  "data": {    "status": "SUSPENDED",    "blockedOperations": [      "PIX_OUT"    ],    "changedAt": "2026-10-06T12:00:00.000Z"  }}