PayZu OnboardingApoio

Cenários práticos


Nesta páginaProposta com os dados que você já temLink perdido antes de o cliente terminarPedido de dados depois do envio

Veja o que muda nos três casos que mais geram dúvida na integração.

Proposta com os dados que você já tem

O cliente já tem cadastro na sua aplicação, e você não quer que ele digite tudo de novo. Mande o que você tem em prefill, e a jornada abre com esses dados.

O que mudaValorPor quê
prefill.personalDataNome, nascimento, nome da mãe, e-mail e celularOs cinco são obrigatórios quando o bloco vai.
prefill.addressCEP só com dígitos e UFcomplement é opcional; os demais campos são obrigatórios.
prefill.termsaccepted em trueSó se o cliente já aceitou os termos na sua aplicação.
json
{
  "clientCode": "crm-8813",
  "type": "PERSON",
  "taxId": "12345678909",
  "contact": "5573991699000",
  "prefill": {
    "personalData": {
      "name": "Maria Silva",
      "birthDate": "1990-02-02",
      "motherName": "Ana Silva",
      "email": "maria@exemplo.com.br",
      "phone": "5573991699000"
    },
    "address": {
      "postalCode": "06455030",
      "street": "Alameda Xingu",
      "number": "350",
      "neighborhood": "Alphaville Industrial",
      "city": "Barueri",
      "state": "SP"
    }
  }
}

Campo que veio do cadastro oficial fica travado na jornada.

A jornada confere os dados do titular no cadastro oficial, e o valor de lá vence o do prefill.

O cliente começou a jornada, parou e não acha mais o link. A proposta ainda está em IN_PROGRESS.

O que mudaValorPor quê
RotaGerar um link da jornadaNenhuma consulta retorna o link guardado.
Link anteriorPara de abrirSó o link novo vale.
EtapasNão mudamO cliente volta de onde parou.

Depois do prazo, o caminho é outra proposta, com outro clientCode.

A emissão é recusada com proposal_expired depois de expiresAt. Na jornada por link, ela também é recusada em análise, com proposal_not_editable, e na proposta encerrada, com proposal_not_open.

Pedido de dados depois do envio

A proposta estava em IN_ANALYSIS e chegou proposal.waiting_data pedindo a foto do verso do documento.

O que mudaValorPor quê
statusWAITING_DATAA proposta volta ao cliente, com o prazo renovado.
data.steps[]["DOCUMENTS"]Só as etapas reabertas aceitam correção.
data.reasons[]62, "Envio sem foto necessária (verso)"Mostre a description ao cliente.
LinkO mesmo, ou um novoGere outro se o cliente não tiver mais o link.
  • O cliente corrige na jornada e envia de novo; chega outro proposal.submitted, com data.resubmitted em true.
  • O reenvio segue na mesma análise, e a decisão chega em proposal.decided.
  • O que cada motivo quer dizer está em Envio e análise.