PayZu Conta HubEventos de webhook

Saque falhou

WEBHOOKWITHDRAW_FAILED

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


O saque falhou e a reserva voltou ao saldo.

Headers

X-Payzu-Eventstringobrigatório
Evento.WITHDRAW_FAILED
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.WITHDRAW_FAILED
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.
withdrawIdstringobrigatório
Identificador do saque: o mesmo id que a API retorna. Aceito em GET /transactions/withdraw/{withdrawId}.
statusstringobrigatório
FAILED
operationstringobrigatório
WITHDRAW (saque para chave) ou EXTERNAL_PAYMENT (pagamento de copia e cola).WITHDRAWEXTERNAL_PAYMENT
amountintegerobrigatório
Valor pedido para o destino, em centavos.
serviceFeeintegerobrigatório
Tarifa da operação, em centavos, somada por cima do amount.
totalDebitedintegerobrigatório
amount + serviceFee: o que estava reservado e voltou ao saldo.
pixKeystringobrigatório
Chave de destino. No saque, a que você enviou; no pagamento de copia e cola, a do recebedor, mascarada quando é CPF, e-mail ou telefone.
reasonstringobrigatório
Mensagem fixa, para exibir.

Responses

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

sem corpo

Exemploapplication/json
{  "event": "WITHDRAW_FAILED",  "id": "cmu1r7x2k000701s6dlvr0007",  "sentAt": "2026-10-05T14:45:05.026Z",  "accountId": "cmu0z8k2a000001s6acct0001",  "data": {    "withdrawId": "P20261005114502M6C1XK8PLBC127431",    "status": "FAILED",    "operation": "WITHDRAW",    "amount": 10000,    "serviceFee": 250,    "totalDebited": 10250,    "pixKey": "fulano@exemplo.com",    "reason": "Não foi possível concluir esta operação."  }}