PayZu Conta HubEventos de webhook

Devolução de saque recebida

WEBHOOKWITHDRAW_REFUND_RECEIVED

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


Quem recebeu um Pix da conta devolveu o valor, inteiro ou em parte.

Headers

X-Payzu-Eventstringobrigatório
Evento.WITHDRAW_REFUND_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.WITHDRAW_REFUND_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 crédito da devolução.
withdrawIdstringobrigatório
Saque cujo Pix voltou, o mesmo withdrawId dos eventos de saque.
amountintegerobrigatório
Valor devolvido, creditado sem tarifa, em centavos.
originalAmountintegerobrigatório
O que o saque mandou ao destino, sem a tarifa, em centavos.
partialbooleanobrigatório
true quando voltou menos do que saiu.
endToEndIdstringobrigatório
End-to-end da devolução.
originalEndToEndIdstringobrigatório
End-to-end do Pix que saiu.
returnedAtstringobrigatório
Quando a devolução caiu na conta.

Responses

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

sem corpo

Exemploapplication/json
{  "event": "WITHDRAW_REFUND_RECEIVED",  "id": "cmu1r7x2k001301s6dlvr0013",  "sentAt": "2026-10-06T11:20:00.352Z",  "accountId": "cmu0z8k2a000001s6acct0001",  "data": {    "depositId": "cmu4a1b2c000201s6xyz11111",    "withdrawId": "P20261005114011R4D8TN2WQZC127431",    "amount": 10000,    "originalAmount": 10000,    "partial": false,    "endToEndId": "D99999999202610061120b7c6d5e4f3a",    "originalEndToEndId": "E99999999202610051440f6e5d4c3b2a",    "returnedAt": "2026-10-06T11:20:00.000Z"  }}