PayZu OnboardingEventos de webhook

Proposta aguardando dados

WEBHOOKproposal.waiting_data

Confira o passo a passo → https://docs.payzu.com.br/docs/onboarding/callbacks


Enviado quando a análise da PayZu pede dados ao cliente. A proposta volta ao cliente com o prazo renovado e, quando o pedido reabre etapas, com elas em data.steps. O pedido de dados a um sócio não gera aviso: a proposta da empresa segue em IN_ANALYSIS.

Headers

X-Callback-Eventstringobrigatório
Evento. O mesmo de event no corpo.proposal.waiting_data
X-Callback-Idstringobrigatório
Identificador da entrega. Igual em todas as tentativas.
X-Callback-Attemptintegerobrigatório
Número desta tentativa.
X-Callback-Timestampintegerobrigatório
Instante desta tentativa, em segundos (Unix). Entra na assinatura.
X-Callback-Signaturestringobrigatório
sha256= seguido do HMAC-SHA256, em hexadecimal, de <X-Callback-Timestamp>.<corpo cru>, com o segredo do seu tenant.

Body

idstringobrigatório
Identificador da entrega, o mesmo de X-Callback-Id. Igual em todas as tentativas.
eventstringobrigatório
Evento, o mesmo de X-Callback-Event.proposal.waiting_data
occurredAtstringobrigatório
Quando o fato aconteceu.
attemptintegerobrigatório
Número desta tentativa, de 1 a 6.
proposalobjectobrigatório
A proposta, lida na hora da entrega.
idstringobrigatório
ID da proposta.
clientCodestringobrigatório
Seu identificador, enviado na criação.
typestringobrigatório
Tipo de pessoa da proposta.PERSONCOMPANY
taxIdstring | nullobrigatório
CPF ou CNPJ do titular da proposta.
contactstring | nullobrigatório
Celular ou e-mail do titular.
statusstringobrigatório
Status da proposta.CREATEDIN_PROGRESSSUBMITTEDIN_ANALYSISWAITING_DATAAPPROVEDREPROVEDEXPIREDCANCELED
deliverystringobrigatório
Como o titular entra na jornada: por link ou embutida.LINKEMBEDDED
expiresAtstringobrigatório
Data e hora em que a proposta expira.
submittedAtstring | nullobrigatório
Data e hora do envio para análise.
decidedAtstring | nullobrigatório
Data e hora da decisão.
versionintegerobrigatório
Versão atual; envie em expectedVersion.
createdAtstringobrigatório
Data e hora do registro.
updatedAtstringobrigatório
Data e hora da última alteração.
dataobjectobrigatório
O fato, gravado quando aconteceu.
statusstringobrigatório
Sempre WAITING_DATA.WAITING_DATA
reasonsarray of objectsobrigatório
Motivos do pedido.
codestringobrigatório
Código do motivo no catálogo de motivos.
descriptionstring | nullobrigatório
Texto do motivo, para mostrar ao cliente.
stepsarray of stringsobrigatório
Registro das etapas que este pedido de dados reabriu, entre as que a consulta lista. Vem vazia quando o pedido não reabre nenhuma delas. O estado atual de cada etapa vem da consulta da proposta.

Responses

2XXQualquer 2xx em até 10 segundos confirma a entrega. Outro status, redirecionamento, que nunca é seguido, ou demora maior contam como falha, e a entrega se repete 1, 5, 30, 120 e 480 minutos depois, num total de seis tentativas.

sem corpo

Exemploapplication/json
{  "id": "7d2f0c4e-9a51-4b8e-a3c6-1f0e5b7d9c22",  "event": "proposal.waiting_data",  "occurredAt": "2026-10-13T14:20:00.000Z",  "attempt": 1,  "proposal": {    "id": "cmw3k9d2x0004s60b7q1r8e5n",    "clientCode": "crm-4471",    "type": "PERSON",    "taxId": "12345678909",    "contact": "5511987654321",    "status": "WAITING_DATA",    "delivery": "LINK",    "expiresAt": "2026-10-20T14:20:00.000Z",    "submittedAt": "2026-10-12T16:45:00.000Z",    "decidedAt": null,    "version": 5,    "createdAt": "2026-10-12T16:20:00.000Z",    "updatedAt": "2026-10-13T14:20:00.000Z"  },  "data": {    "status": "WAITING_DATA",    "reasons": [      {        "code": "62",        "description": "Envio sem foto necessária (verso)"      }    ],    "steps": [      "DOCUMENTS"    ]  }}