Roteiro de Homologação BCJ - Crédito Pessoal

*: 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- 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

3 - Emissão de dívida (PF)

Código	Etapa	Descrição	Link	Pré-requisito
EMD0001*	Emissão de dívida PF	Emissão da CCB PF. Formada por quatro objetos principais: dados cadastrais do devedor (objeto borrower), dados financeiros da operação (objeto financial), dados bancários para pagamento (disbursement_bank_account) e indicação do cessionário (purchaser_document_number)	Link Documentação	Itens 1 e 2
EMD0002	Implementação de dados adicionais	Dados para preenchimento da CCB gerada	Payload alinhado em paralelo	Obrigatório, se definido a utilização.

4 - Formalização de dívida

Código	Etapa	Descrição	Link	Pré-requisito
FOR0001	Formalização da dívida	A assinatura da CCB será via opt-in, com o envio do máximo de evidências possível	--	Item 3
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

        Request

ENDPOINT

debt/[DEBT_KEY]/signed

MÉTODO

POST

Request Body

{
    "type": "data-signature",
    "signatures": [
        {
            "signed_object": {
                "raw_text": "Lorem ipsum dolor sit amet, consectetur a...."
            },
            "authenticity": {
                "timestamp": "2024-07-31T19:56:27",
                "ip_address": "192.168.1.22",
                "fingerprint": {
                    "lat": "-23.6698999",
                    "long": "-46.5401819",
                    "name": "Andre 1",
                    "model": "Chrome",
                    "localeHashValue": "hash cliente"
                },
                "session_id": "7edd8a8b-e25a-49ce-8fc3-593dc5984dd9",
                "signer": {
                    "name": "TESTE DE SENA LIMA",
                    "email": "teste2604@gmail.com",
                    "phone": {
                        "country_code": "055",
                        "area_code": "11",
                        "number": "999999999"
                    },
                    "document_number": "61766976204"
                },
                "authentication_type": "selfie"
            }
        }
    ]
}

        Response

MÉTODO

POST

ENDPOINT

debt/[DEBT_KEY]/signed

Response Body

{
  "data": {},
  "event_datetime": "2023-01-17 17:17:28",
  "key": "4630cd58-ab00-49b3-b8cb-cb0f4a5af7a4",
  "status": "signature_received",
  "webhook_type": "debt"
}

5 - Desembolso da dívida

Código	Etapa	Descrição	Link	Pré-requisito
DES0001*	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	item 4

6 - 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	Item 5
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

8 - Cancelamento da operação

Código	Etapa	Descrição	Link	Pré-requisito
CAN0002*	Cancelamento da dívida antes do desembolso	Permite o cancelamento 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