PayZu Conta HubEventos de webhook

Cobrança criada

WEBHOOKPAYMENT_CREATED

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


A cobrança foi registrada no banco parceiro.

Headers

X-Payzu-Eventstringobrigatório
Evento.PAYMENT_CREATED
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.PAYMENT_CREATED
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.
paymentIdstringobrigatório
Identificador da cobrança: o mesmo id que a API retorna. Aceito em GET /transactions/payment/{paymentId}.
statusstringobrigatório
PENDING
amountintegerobrigatório
Valor cobrado, em centavos.
methodstringobrigatório
Meio de pagamento.PIX
createdAtstringobrigatório
Data de criação, ISO 8601.
qrCodestring
Pix copia e cola, quando o banco parceiro informa.
metadataobject
O metadata enviado na criação. Só quando enviado e não vazio.
externalRefstring
A externalRef enviada na criação. Só quando enviada.

Responses

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

sem corpo

Exemploapplication/json
{  "event": "PAYMENT_CREATED",  "id": "cmu1r7x2k000101s6dlvr0001",  "sentAt": "2026-10-05T14:32:05.610Z",  "accountId": "cmu0z8k2a000001s6acct0001",  "data": {    "paymentId": "P20261005113205K7Q2M9XB4TC127431",    "status": "PENDING",    "amount": 1500,    "method": "PIX",    "createdAt": "2026-10-05T14:32:05.123Z",    "qrCode": "00020126580014br.gov.bcb.pix0136b3c7e9a2-4f1d-4c8a-9e2b-7d5f6a8c1e03520400005303986540515.005802BR5912LOJA EXEMPLO6009SAO PAULO62070503***63041EC4",    "metadata": {      "pedido": "4821",      "canal": "checkout-web"    },    "externalRef": "pedido-4821"  }}