PayZuDocs

Cadastrar endpoint de webhook

Registra uma URL para receber os webhooks dos eventos escolhidos.

POSThttps://api.hub.payzu.com.br/api/v1/transactions/webhooks
POST
/transactions/webhooks

Body Params

Responses

curl -X POST "https://api.hub.payzu.com.br/api/v1/transactions/webhooks" \  -H "Authorization: Bearer {{token}}" \  -H "Content-Type: application/json" \  -d '{    "url": "https://sualoja.com.br/webhooks/payzu",    "events": [      "PAYMENT_PAID",      "PAYMENT_EXPIRED",      "WITHDRAW_COMPLETED",      "WITHDRAW_FAILED"    ]  }'
{
"id": "cmu6w1h0k000101s6ef34gh56",
"url": "https://sualoja.com.br/webhooks/payzu",
"isActive": true,
"createdAt": "2026-10-01T12:00:00.000Z",
"updatedAt": "2026-10-01T12:00:00.000Z",
"secret": "whsec_9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
}