PayZu OnboardingEventos de webhook

Proposta enviada para análise

WEBHOOKproposal.submitted

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


Enviado quando o cliente conclui a jornada e a proposta vai para análise, e de novo a cada reenvio depois de um pedido de dados. Quando a decisão sai no próprio envio, proposal.decided sai logo depois; se a entrega do proposal.submitted falhar, o proposal.decided pode chegar antes.

Headers

X-Callback-Eventstringobrigatório
Evento. O mesmo de event no corpo.proposal.submitted
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.submitted
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 IN_ANALYSIS, mesmo quando a decisão sai no próprio envio.IN_ANALYSIS
resubmittedboolean
Só no reenvio depois de um pedido de dados, com true.true

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": "1c9e5a7b-3f20-4d6a-8b14-6e2d0f9a7c31",  "event": "proposal.submitted",  "occurredAt": "2026-10-12T16:45:00.000Z",  "attempt": 1,  "proposal": {    "id": "cmw3k9d2x0004s60b7q1r8e5n",    "clientCode": "crm-4471",    "type": "PERSON",    "taxId": "12345678909",    "contact": "5511987654321",    "status": "IN_ANALYSIS",    "delivery": "LINK",    "expiresAt": "2026-10-19T16:20:00.000Z",    "submittedAt": "2026-10-12T16:45:00.000Z",    "decidedAt": null,    "version": 4,    "createdAt": "2026-10-12T16:20:00.000Z",    "updatedAt": "2026-10-12T16:45:00.000Z"  },  "data": {    "status": "IN_ANALYSIS"  }}