PayZu Conta HubEventos de webhook

Devolução concluída

WEBHOOKREFUND_COMPLETED

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


O valor da devolução voltou ao pagador.

Headers

X-Payzu-Eventstringobrigatório
Evento.REFUND_COMPLETED
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.REFUND_COMPLETED
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.
refundIdstringobrigatório
Identificador da devolução: o id dentro de refunds, na cobrança ou no depósito.
paymentIdstring
Quando a devolução é de uma cobrança.
depositIdstring
Quando a devolução é de um depósito. Vem um dos dois.
statusstringobrigatório
SETTLED
amountintegerobrigatório
O que volta ao pagador, em centavos.
totalDebitedintegerobrigatório
amount mais a tarifa de devolução, em centavos.
endToEndIdstring
End-to-end do Pix de devolução, quando o banco parceiro informa.

Responses

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

sem corpo

Exemploapplication/json
{  "event": "REFUND_COMPLETED",  "id": "cmu1r7x2k000801s6dlvr0008",  "sentAt": "2026-10-06T10:10:04.251Z",  "accountId": "cmu0z8k2a000001s6acct0001",  "data": {    "refundId": "cmu7r2f9k000301s6abcd5678",    "paymentId": "P20261005113205K7Q2M9XB4TC127431",    "status": "SETTLED",    "amount": 1000,    "totalDebited": 1100,    "endToEndId": "D99999999202610061010a9b8c7d6e5f"  }}