Roteiro de Homologação Bankme - Abertura de Conta e Emissão de Nota Comercial
O roteiro de homolgoação descreve todos os recursos e funcionalidades que precisam ser testados pelo parceiro integrador no ambiente de sandbox da QI Tech (ambiente de testes), antes da entrada em ambiente de produção do produto.
Este roteiro descreve todos os recursos e funcionalidades envolvidos no produto.
Cadastro e Autenticação APIs LaaS e BaaS
| 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) | cs@qitech.com.br | |
| CAB0002* | Validação de token em Sandbox | Realizar a validação do QI Token em Sandbox | Link Documentação | 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 | Link Documentação 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 |
Antifraude
Cadastro e Autenticação
| Código | Etapa | Descrição | Link Documentação | Pré-requisito |
|---|---|---|---|---|
| ATF0002* | Obtenção de API-key de onboarding | Obter junto ao time de integração da QI Tech a chave de API para uso da API de /onboarding | suporte.caas@qitech.com.br | |
| ATF0003* | Obtenção de mobile-token de OCR | Obter junto ao time de integração da QI Tech o Mobile Token para uso da SDK de OCR | suporte.caas@qitech.com.br | |
| ATF0004* | Obtenção de mobile-token de Face Recognition | Obter junto ao time de integração da QI Tech o Mobile Token para uso da SDK de Face Recognition | suporte.caas@qitech.com.br | |
| ATF0005* | Obtenção de mobile-token de Device scan | Obter junto ao time de integração da QI Tech o Mobile Token para uso da SDK de Device scan | suporte.caas@qitech.com.br |
SDK OCR
| Código | Etapa | Descrição | Link Documentação | Pré-requisito |
|---|---|---|---|---|
| ATF0007* | Build da SDK | Definir o template e customizações para coleta dos documentos e buildar a SDK com sucesso dentro da sua aplicação (aplicação do cliente QI Tech) | Android: Link Documentação iOS: Link Documentação | |
| ATF0008* | Envio de documentos | Realizar a coleta de documentos utilizando o SDK dentro da sua aplicação (aplicação cliente QI Tech) | ATF0003 e ATF0007 | |
| ATF0009* | Armazenamento de ocr_key | Armazenar as chaves retornadas pela SDK, identificando a natureza do documento coletado (ex: cnh_front, cnh_back, etc) | Android: Link Documentação iOS: Link Documentação | ATF0008 |
SDK Face Recognition
| Código | Etapa | Descrição | Link Documentação | Pré-requisito |
|---|---|---|---|---|
| ATF0011* | Build da SDK | Definir customizações e buildar a SDK com sucesso dentro da sua aplicação (aplicação do cliente QI Tech) | Android: Link Documentação iOS: Link Documentação | |
| ATF0012* | Fluxo de prova de vida | Realizar o fluxo de prova de vida utilizando o SDK dentro da sua aplicação (aplicação cliente QI Tech) | ATF0004 e ATF0011* | |
| ATF0013* | Armazenamento de chave de imagem | Armazenar a image_key retornada pela SDK após finalização do fluxo de prova de vida | Android: Link Documentação iOS: Link Documentação | ATF0012 |
SDK Device Scan
| Código | Etapa | Descrição | Link Documentação | Pré-requisito |
|---|---|---|---|---|
| ATF0015* | Build da SDK | Definição das permissões a serem solicitadas ao usuário por sua aplicação (aplicação do cliente QI Tech) e buildar a SDK com sucesso dentro da sua aplicação (aplicação do cliente QI Tech) | Android: Link Documentação iOS: Link Documentação | |
| ATF0016* | Armazenamento da sessão do usuário | Realizar o armazenamento da sessão do usuário (sessionId) que terá o dispositivo escaneado | Android: Link Documentação iOS: Link Documentação | ATF0015 e ATF0017 |
| ATF0017* | Coleta de informações | Instanciar o SDK com o sessionId armazenado e chamar o método de coleta de informações dentro de sua aplicação (aplicação do cliente QI Tech) | Android: Link Documentação iOS: Link Documentação | ATF0005 e ATF0015 |
Antifraude
| Código | Etapa | Descrição | Link Documentação | Pré-requisito |
|---|---|---|---|---|
| ATF0019* | Antifraude PF | Realizar com sucesso o antifraude de uma cliente pessoa física | Link Documentação | ATF0002 |
| ATF0020* | Antifraude PJ | Realizar com sucesso o antifraude de uma cliente pessoa jurídica | Link Documentação | ATF0002 |
| ATF0021* | Leitura de webhooks de analises derivadas para fluxo assíncrono | Recepcionar com sucesso o webhook de análise derivada para o fluxo de resposta assíncrona | Link Documentação | ATF0019 ou ATF0020 |
Cadastro Plataforma
| Código | Etapa | Descrição | Link Documentação | Pré-requisito |
|---|---|---|---|---|
| ATF0022* | Cadastro de usuário Master | Realizar o cadastro de um usuário Master na plataforma do CaaS, para resolução de solicitações derivadas para “Análise manual” | suporte.caas@qitech.com.br | ATF0019 ou ATF0020 |
QI Conta
Abertura de Conta
| Código | Etapa | Descrição | Link Documentação | Pré-requisito |
|---|---|---|---|---|
| QIC0002* | Reserva de conta PF | Solicitar a reserva de uma conta cujo titular seja uma pessoa física | Link Documentação | CAB0005 e CAB0006 |
| QIC0003* | Abertura de conta PF | Realizar a abertura de uma conta cujo titular seja uma pessoa física | Link Documentação | QIC0002 |
| QIC0004* | Reserva de conta PJ | Solicitar a reserva de uma conta cujo titular seja uma pessoa jurídica | Link Documentação | CAB0005 e CAB0006 |
| QIC0005* | Abertura de conta PJ | Realizar a abertura de uma conta cujo titular seja uma pessoa jurídica | Link Documentação | QIC0004 |
| QIC0009* | Reserva de conta escrow PF | Solicitar a reserva de uma conta escrow cujo titular seja uma pessoa física | Link Documentação | CAB0005 e CAB0006 |
| QIC0010* | Abertura de conta escrow PF | Realizar a abertura de uma conta escrow cujo titular seja uma pessoa física | Link Documentação | CAB0005 e CAB0006 |
| QIC0011* | Reserva de conta escrow PJ | Solicitar a reserva de uma conta escrow cujo titular seja uma pessoa jurídica | Link Documentação | CAB0005 e CAB0006 |
| QIC0012* | Abertura de conta escrow PJ | Realizar a abertura de uma conta escrow cujo titular seja uma pessoa jurídica | Link Documentação | CAB0005 e CAB0006 |
| QIC0006* | Leitura de webhooks de abertura de conta | Ler corretamente os webhooks de abertura de conta | Item 1.2. ou 1.3: Link Documentação | QIC0003 ou QIC0005 |
| QIC0007* | Listar contas | Listar contas abertas | Link Documentação | QIC0003 ou QIC0005 |
| QIC0008* | Consulta de dados de uma conta | Consultar dados como saldo, dados do titular, data de abertura, dentre outros | Link Documentação | QIC0003 ou QIC0005 |
Movimentações
| Código | Etapa | Descrição | Link | Pré-requisito |
|---|---|---|---|---|
| QIC0008* | Consulta de Extrato | Realizar a consulta do extrato de uma conta | Link Documentação | QIC0003 ou QIC0005 |
| QIC0009* | Solicitação de comprovante de transferência | Solicitar um comprovante de transferência | Link Documentação | |
| QIC0010* | Leitura de webhooks de transação | Recepcionar com sucesso todos os webhooks de transação | Link Documentação | QIC0003 ou QIC0005 |
| QIC0011* | Consulta de lista de instituições financeiras | Consultar lista de instituições financeiras habiliatadas para recebimento de TED e Pix | Link Documentação | QIC0003 ou QIC0005 |
Upload de Documentos
| Código | Etapa | Descrição | Link | Pré-requisito |
|---|---|---|---|---|
| UDD0001* | Upload de documento | Realizar o upload de um documento através da nossa API de documentos | Link Documentação |
Simulação de Nota Comercial
| Código | Etapa | Descrição | Link | Pré-requisito |
|---|---|---|---|---|
| SID0001* | Simulação de Nota Comercial | Simulação das condições da nota comercial, utilizando variáveis previamente determinadas. OBS: Conforme discutido, alguns ajustes para determinados serão direcionados para ao time da Bankme posteriormente. | Link Documentação | CAB0005 |
Emissão de Nota Comercial
| Código | Etapa | Descrição | Link | Pré-requisito |
|---|---|---|---|---|
| EMD0002* | Emissão de Nota Comercial | Formada por quatro objetos principais: dados cadastrais do devedor (objeto borrower, dentro desse objeto teremos a lista de representantes da empresa -> company_representatives), dados financeiros da operação (objeto financial), dados bancários para pagamento (disbursement_bank_account) e indicação do cessionário (purchaser_document_number). OBS: Conforme discutido, alguns ajustes para determinados serão direcionados para ao time da Bankme posteriormente. | Link Documentação | SID0001 |
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 | -- | EMD0002 |
| 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 |
Desembolso da dívida
| Código | Etapa | Descrição | Link | Pré-requisito |
|---|---|---|---|---|
| DES0001* | Escolha da data de desembolso | Após o cumprimento de todos os requisitos para pagamento da operação (envio de documentos, assinatura e averbação), deve-se obrigatoriamente escolher uma data de desembolso para que a operação seja paga, dentro do range de desembolso. | Link Documentação | FOR0002 |
| 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. Além do retorno das chaves identificadoras das parcelas e seus respectivos boletos | Link Documentação | DES0001 |
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 paga um QR Code de devolução | Link Documentação | DES0002 |
Reapresentação da dívida
| Código | Etapa | Descrição | Link | Pré-requisito |
|---|---|---|---|---|
| PAG0001* | Alteração/atualização da data de desembolso | 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. | Link Documentação | CAN0003 |
| PAG0002* | Alteração dos dados bancários | Mudança dos dados para pagamento da operação, obrigatório um conta de mesma titularidade do devedor | Link Documentação | PAG0001. Obrigatório, caso exista retentativa |