PayZu OnboardingDocumentos e análise

Envio e análise


Nesta páginaEnvio para análiseTrate o pedido de dadosStatus da análiseMotivos

Acompanhe a proposta desde o envio para análise, que o cliente faz ao fim da jornada, até a decisão da PayZu.

Fluxo da análise: o cliente envia a proposta, que fica em IN_ANALYSIS; a análise termina em APPROVED ou REPROVED ou pede dados em WAITING_DATA, e o cliente corrige as etapas reabertas e reenvia na mesma análise

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.

data de proposal.waiting_data
{
  "status": "WAITING_DATA",
  "reasons": [{ "code": "62", "description": "Envio sem foto necessária (verso)" }],
  "steps": ["DOCUMENTS"]
}
CampoO que fazer
reasons[].descriptionMostre o texto ao cliente.
reasons[].codeCompare 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

statusSituaçãoCallback
IN_ANALYSISEm análise.proposal.submitted
WAITING_DATADados pedidos ao cliente.proposal.waiting_data
APPROVED ou REPROVEDDecidida.proposal.decided
EXPIRED ou CANCELEDVencida 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, com APPROVED.
  • Empresa: o status fica em IN_ANALYSIS até 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ódigoDescriçãoNova tentativa
50Documento ilegível: qualidade da foto está ruimRETRY
51Documento ilegível: apresenta recorte na fotoRETRY
52Documento ilegível: obstrução na imagem (plástico, reflexo, adesivos)RETRY
61Envio sem foto necessária (frente)RETRY
62Envio sem foto necessária (verso)RETRY
70Documento não suportadoRETRY
71Documento inválidoRETRY
72Formato de arquivo não suportadoRETRY