Início rápido
No Marketplace de Crédito, toda solicitação seque o seguinte ciclo de vida:
Etapa 1 - Auth (Autenticação)
A autenticação é o primeiro passo importante para garantir a segurança ao acessar os endpoints de nossa API de crédito. Utilizamos um sistema baseado em tokens para autenticar solicitações, garantindo que apenas clientes autorizados possam acessar nossos serviços.
Passo 1: Usando suas credenciais fornecidas, solicite um token de autenticação através do método POST.
Passo 2: Após a solicitação bem-sucedida, você receberá um token JWT como token de acesso. Este deve ser usado como Bearer Token em todas as chamadas subsequentes para autenticar sua sessão, incluindo o token de acesso como um cabeçalho de autorização em todas as solicitações.
Informações:
- Bearer Token: Um tipo de token de acesso usado em autenticações HTTP para permitir acesso a recursos específicos.
- Nesta etapa, é utilizado o modelo request-response.
Etapa 2 - Signup (Cadastro)
A API de crédito oferece dois principais endpoints de cadastro via método POST: o signupMatch e o signupSimple. Ambos são projetados para registrar usuários na plataforma, mas com diferentes finalidades e características.
Passo 3: Escolha entre SignupSimple para registro básico ou SignupMatch para incluir informações detalhadas do usuário e suas preferências de produtos financeiros, neste ultimo, retornamos a pré-disposição do cliente a produtos específicos.
Passo 4: Após o cadastro, é retornado o Pipeline ID, um identificador de referência do processo usado nas etapas subsequentes. Neste passo, é onde se inicia o ciclo de vida do pipeline, retornando neste passo o status indicando que o processo está em análise (SignUp Analysis).
Passo 5: Via Webhook, é retornado o status, que pode ser: SignUp Denied ou SignUp Completed, do processo de cadastro referenciado pelo Pipeline ID, aqui é informado se o cadastro foi concluído ou negado. Neste passo, nosso ciclo de vida do pipeline continua, caso o status retornar SignUp Completed o processo pode prosseguir para a Etapa 3 Proposal (Proposta), caso retorne SignUp Denied, o processo é finalizado.
Informações:
- Pipeline ID: Identificador usado para acompanhar e referenciar processos específicos ao longo de diferentes etapas da jornada do cliente.
- Webhook: Utilizado para notificar sistemas de eventos ocorridos, como a análise de uma proposta.
- Status: Utilizado para gerenciar e exibir informações específicas em cada etapa do processo, variando conforme o produto e o contexto.
Etapa 3 - Proposal (Proposta)
A etapa de proposta é projetada para coletar e validar os dados necessários para a criação de propostas de produtos de empréstimo ou abertura de contas bancárias digitais.
Passo 6: Envie informações detalhadas do solicitante via método POST; os dados são organizados e analisados pelo pipeline.
Passo 7: Neste passo, o status do pipeline é retornado em Proposal Analysis, indicando que estamos chamando as API's dos parceiros para criar as propostas.
Passo 8: Um Webhook retorna o status do pipeline que pode ser Proposal Completed retornando todas as propostas, ou Proposal Denied, quando não é possível criar propostas de crédito para aquele CPF.
Etapa 4 - Sending Documents (Envio de Documentos)
Esta etapa permite o envio de documentos para análise, essencial para a validação de dados e processos de aprovação de crédito.
Passo 9: Utilize o método PUT para enviar individualmente os documentos necessários durante o processo de solicitação de crédito. Cada documento enviado recebe um Pipeline ID para referenciar o processo.
Informações:
- Nesta etapa, a selfie deve ser enviada nos formatos PNG ou JPG; arquivos em PDF não são permitidos.
- O Documento deve ser encriptado em base 64.
- É necessário enviar um documento por vez. Caso o mesmo documento seja enviado duas vezes, o mais recente será o utilizado; no entanto, o cliente terá acesso a todos os documentos enviados.
- Nesta etapa, é utilizado o modelo request-response, não há webhook.
Etapa 5 - Contract (Contrato)
Esta seção trata do processo de obtenção e assinatura de contratos relacionados a propostas de crédito.
Passo 10: Utilize o método GET para obter contratos que precisam ser revisados e assinados pelo cliente. O Customer Service Number (CSN) é utilizado para referenciar cada proposta específica no processo de contratação.
Passo 11: O Checksum (usado para referenciar o contrato em questão) será retornado.
Passo 12: Utilize o método POST para enviar dados que confirmam a assinatura de um contrato associado a uma proposta de crédito. Inclua o checksum, empregado para referenciar especificamente o contrato mencionado, no corpo da solicitação. Essa inclusão é necessária para verificar a autenticidade do contrato assinado, conforme registrado pelo logdata.
Informações:
- Customer Service Number (CSN): Usado para identificar propostas específicas dentro de um processo, importante para a geração e assinatura de contratos.
- Neste etapa é utilizado o modelo request-response, não há webhook.
- A chamada de envio de contrato não é uma chamada obrigatória, apenas utilizada caso a proposta tenha a necessidade de contrato, para verificar é necessário observar a variável HasContracts = true dentro das informações da proposta.
Updated 4 days ago