Roteiro de Homologação Porto Seguro - Crédito Novo INSS
*: etapas obrigatórias para entrada em produção
1 - Cadastro e Autenticação APIs LaaS
| Código | Etapa | Descrição | Link Documentação | Pré-requisito |
|---|---|---|---|---|
| CAB0001* | Cadastro no ambiente de Sandbox | Realizar o cadastro na plataforma da QI Tech no ambiente de Sandbox (sandbox.qitech.app) | https://sandbox.qitech.com.br/register | |
| CAB0002* | Validação de token em Sandbox | Realizar a validação do QI Token em Sandbox | Download Manual de Inclusão do Token | CAB0001 |
| CAB0003* | Troca de chaves públicas | Realizar a troca de chaves públicas dentro da plataforma da QI Tech em sandbox (sandbox.qitech.app) | Link Documentação | CAB0001 e CAB0002 |
| CAB0004* | Teste de autenticação de chamadas | Finalizar teste de autenticação de chamadas | Passo a Passo Link Documentação | CAB0003 |
| CAB0005* | Configuração de webhooks | Realizar a configuração da url para envio dos webhooks por parte da QI, através da plataforma da QI Tech em sandbox (sandbox.qitech.app) | Link Documentação | CAB0001 e CAB0002 |
2 - Consulta da lista de benefícios
| Código | Etapa | Descrição | Link | Pré-requisito |
|---|---|---|---|---|
| CLB0001* | Consulta da lista de benefícios com envio do termo de autorização | Listagem dos benefícios associados à um CPF | Link Documentação | Item 1 |
| CLB0002* | Leitura do webhook de sucesso e falha na consulta da lista de benefícios | Recebimento do webhook com todos os benefícios associados à um CPF e recebimento de um webhook com um enumerador específico de erro na consulta | Link Documentação | CLB0001 |
| CLB0003* | Simulação de cenários de sucesos e insucesso na consulta da lista de benefícios | Teste de sucesso (detalhamento de todos os números de benefício) e teste de insucesso (retorno de enumeradores de erros específicos) | Link Documentação | CLB0002 |
3 - Consulta de dados do benefício
| Código | Etapa | Descrição | Link | Pré-requisito |
|---|---|---|---|---|
| CDB0001* | Consulta de dados do benefício com ou sem envio do termo de autorização | Retorno dos dados associados à um número de benefícios associado à um CPF | Link Documentação | Item 1 |
| CDB0002* | Leitura do webhook de sucesso e falha na consulta de dados do benefício | Recebimento do webhook com os dados específicos de determinado benefício e o recebimento de um webhook com um enumerador específico de erro na consulta | Link Documentação | CDB0001 |
| CDB0003* | Simulação de cenários de sucesos e insucesso na consulta de dados do benefício | Teste de sucesso (detalhamento de todos os dados associados à um número de benefício) e teste de insucesso (retorno de enumeradores de erros específicos) | Link Documentação | CDB0002 |
4 - Simulação da dívida
| Código | Etapa | Descrição | Link | Pré-requisito |
|---|---|---|---|---|
| SID0001* | Simulação de dívida | Simulação das condições da dívida, utilizando variáveis previamente determinadas | Link Documentação | Item 1 |
5 - Emissão de dívida
| Código | Etapa | Descrição | Link | Pré-requisito |
|---|---|---|---|---|
| EMD0001* | Emissão de dívida PF | Emissão da CCB PF. Formada por cinco estruturas principais: dados cadastrais do devedor (objeto borrower), dados financeiros da operação (objeto financial), dados bancários para pagamento (disbursement_bank_account), dados de garantia (lista collateral_data) e indicação do cessionário (purchaser_document_number) | Link Documentação | Itens 4 |
6 - Formalização de dívida
| Código | Etapa | Descrição | Link | Pré-requisito |
|---|---|---|---|---|
| FOR0001* | Formalização da dívida | A assinatura da CCB será disparada automaticamente do lado da QI SCD via QI Sign, após a emissão da dívida | -- | Item 5 |
| FOR0002* | Leitura do webhook de assinatura finalizada | Leitura da resposta assíncrona da formalização da operação. Webhook status signature_finished | Link Documentação | FOR0001 |
7 - Averbação e desaverbação
| Código | Etapa | Descrição | Link | Pré-requisito |
|---|---|---|---|---|
| COL0001* | Leitura do webhook de collateral constituído | Leitura da resposta assíncrona que indica a averbação do saldo do cliente. Webhook credit_operation.collateral | Link Documentação | Item 5 |
| COL0002* | Simulação dos cenários de sucesso e insucesso na averbação do saldo de um cliente. | Temos um mock de casos de insucesso para serem testados, eles usam uma lógica aplicada aos primeiros números do documento do tomador em sandbox | Link Documentação | COL0001 |
| COL0003* | Acompanhamento e mapeamento dos status das reservas | O objeto "last_response" traz os dados da última tentativa de reserva ou liberação (averbação ou desaverbação) realizada pela QI no Dataprev. | Link Documentação | COL0002 |
8 - Desembolso da dívida
| Código | Etapa | Descrição | Link | Pré-requisito |
|---|---|---|---|---|
| DES0002* | Leitura do webhook de desembolso da operação | Leitura da resposta assíncrona que indica o sucesso no pagamento da operação. Webhook status: disbursed. Aqui teremos o comprovante de pagamento em PDF. | Link Documentação | DES0001 |
9 - Reapresentação da dívida
| Código | Etapa | Descrição | Link | Pré-requisito |
|---|---|---|---|---|
| PAG0001* | Atualização da data de desembolso e Alteração dos dados bancários | Quando uma operação está cancelada, a atualização da data de desembolso faz com que a operação volte ao status anterior ao cancelamento. A Mudança dos dados para pagamento da operação, obrigatório um conta de mesma titularidade do devedor | Link Documentação | Item 5 |
10 - Cancelamento da operação
| Código | Etapa | Descrição | Link | Pré-requisito |
|---|---|---|---|---|
| CAN0002* | Cancelamento permanente da dívida antes do desembolso | Permite o cancelamento definitivo (status final) da dívida antes do pagamento | Link Documentação | EMD0001 |
| CAN0003* | Leitura do webhook de cancelamento | Leitura da resposta assíncrona do cancelamento da operação. Webhook status: canceled | Link Documentação | CAN0002 |
| CAN0004* | Cancelamento de dívida em até sete dias após o desembolso | Considerando que o tomador do crédito pode realizar o cancelamento da dívida em até 7 dias do desembolso, é possível que ele faça um chargeback do PIX recebido ou pagar um QR Code de devolução | Link Documentação | DES0002 |
11 - Renegociação de dívida
| Código | Etapa | Descrição | Link | Pré-requisito |
|---|---|---|---|---|
| REN0001 | Simulação de uma renegociação | Permite a simulação parcial ou total de uma renegociaç ão | Link Documentação | DES0002 |
| REN0002 | Criar uma renegociação | Permite a criação de uma renegociação parcial ou total (geração de um boleto de antecipação para pagamentos de parcelas) | Link Documentação | DES0002 |
| REN0003 | Consultar uma renegociação | Verificar as condições de uma renegociação, parcelas que foram afetadas, dados financeiros, vencimento e tipo de pagamento | Link Documentação | REN0002 |
| REN0004 | Listar Renegociações | Verificar uma listagem das condições de mais de uma renegociação | Link Documentação | REN0002 |
| REN0005 | Cancelar uma renegociação | Efetuar o cancelamento de uma renegociação | Link Documentação | REN0002 |
| REN0006 | Pagamento de uma renegociação | Webhooks de atualização de status de uma renegociação. Webhook_type: renegotiation.proposal | Link Documentação | REN0002 |