Envio e análise
Acompanhe a proposta desde o envio para análise, que o cliente faz ao fim da jornada, até a decisão da PayZu.
Envio para análise
Quando o cliente conclui as etapas, a jornada envia a proposta para análise. Ela passa a IN_ANALYSIS, e chega o callback proposal.submitted. Quando a decisão sai no próprio envio, proposal.decided chega logo em seguida.
A análise do sócio começa no envio da empresa.
O fim da jornada do sócio deixa a proposta dele em SUBMITTED.
Trate o pedido de dados
O callback proposal.waiting_data avisa que a PayZu precisa de algo do cliente.
{
"status": "WAITING_DATA",
"reasons": [{ "code": "62", "description": "Envio sem foto necessária (verso)" }],
"steps": ["DOCUMENTS"]
}| Campo | O que fazer |
|---|---|
reasons[].description | Mostre o texto ao cliente. |
reasons[].code | Compare com o catálogo de motivos. |
steps[] | O registro das etapas que o pedido 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: a reaberta fica em REOPENED até o cliente corrigi-la. O documento recusado aparece com REJECTED em documents da consulta. |
Leve o cliente de volta à jornada pelo link; se ele se perdeu, gere outro em Links da jornada. O novo envio segue na mesma análise.
Com steps vazia, o caminho é o mesmo. Sem etapa aberta, a jornada devolve a proposta à análise assim que o cliente entra, sem pedir dado nenhum. O documento recusado só é trocado quando a etapa de documentos é reaberta.
Espere o pedido de dados ou a decisão antes de mexer na proposta em análise.
Em IN_ANALYSIS, o cancelamento é recusado com proposal_in_analysis e, na jornada por link, a emissão do link, com proposal_not_editable.
Status da análise
status | Situação | Callback |
|---|---|---|
IN_ANALYSIS | Em análise. | proposal.submitted |
WAITING_DATA | Dados pedidos ao cliente. | proposal.waiting_data |
APPROVED ou REPROVED | Decidida. | proposal.decided |
EXPIRED ou CANCELED | Vencida ou cancelada. | proposal.closed |
Para conferir, leia o status em Consultar uma proposta. O corpo de cada evento está na página dele, a partir da tabela de eventos de Callbacks.
- Reprovação automática: ainda pode ser revista. Se for aprovada, chega um segundo
proposal.decided, comAPPROVED. - Empresa: o
statusfica emIN_ANALYSISaté terminar a análise de quem preencheu e dos sócios, como mostra Empresas e sócios.
Motivos
Os códigos de reasons[], de steps[].reasonCodes e de rejectionReasonCode dos documentos vêm deste catálogo, separado aqui pela categoria de cada motivo. RETRY permite nova tentativa; motivo FINAL não se resolve com novo envio.
| Código | Descrição | Nova tentativa |
|---|---|---|
50 | Documento ilegível: qualidade da foto está ruim | RETRY |
51 | Documento ilegível: apresenta recorte na foto | RETRY |
52 | Documento ilegível: obstrução na imagem (plástico, reflexo, adesivos) | RETRY |
61 | Envio sem foto necessária (frente) | RETRY |
62 | Envio sem foto necessária (verso) | RETRY |
70 | Documento não suportado | RETRY |
71 | Documento inválido | RETRY |
72 | Formato de arquivo não suportado | RETRY |
| Código | Descrição | Nova tentativa |
|---|---|---|
60 | CPF enviado como parâmetro diverge do documento | RETRY |
63 | Dado do parâmetro diverge do documento | RETRY |
82 | Data de nascimento do documento diverge dos dados oficiais | RETRY |
94 | Nome no documento não condiz com o cadastro da Receita Federal | RETRY |
| Código | Descrição | Nova tentativa |
|---|---|---|
91 | Selfie não é similar ao documento | RETRY |
92 | Reprovado pelo liveness | RETRY |
| Código | Descrição | Nova tentativa |
|---|---|---|
80 | CPF inválido | FINAL |
81 | CNPJ inválido | FINAL |
93 | CPF irregular na Receita Federal | FINAL |
| Código | Descrição | Nova tentativa |
|---|---|---|
10 | Parâmetros necessários não informados | RETRY |
83 | CPF não informado | RETRY |
84 | CNPJ não informado | RETRY |
| Código | Descrição | Nova tentativa |
|---|---|---|
31 | Foram encontrados protestos | FINAL |
32 | Foram encontrados processos | FINAL |
95 | Face encontrada na base compartilhada de suspeitos | FINAL |
96 | Pessoa politicamente exposta | FINAL |
| Código | Descrição | Nova tentativa |
|---|---|---|
30 | Menor de 16 anos | FINAL |
90 | Menor de 18 anos | FINAL |