跳到主要内容

Roteiro de Homologação - Emissão de dívida PF com desembolso pagando QR Code

*: etapas obrigatórias para entrada em produção

1 - Cadastro e Autenticação APIs LaaS

CódigoEtapaDescriçãoLink DocumentaçãoPré-requisito
CAB0001*Cadastro no ambiente de SandboxRealizar 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 SandboxRealizar a validação do QI Token em SandboxDownload Manual de Inclusão do TokenCAB0001
CAB0003*Troca de chaves públicasRealizar a troca de chaves públicas dentro da plataforma da QI Tech em sandbox (sandbox.qitech.app)Link DocumentaçãoCAB0001 e CAB0002
CAB0004*Teste de autenticação de chamadasFinalizar teste de autenticação de chamadasPasso a Passo

Link Documentação
CAB0003
CAB0005*Configuração de webhooksRealizar 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çãoCAB0001 e CAB0002

2- Simulação da dívida

CódigoEtapaDescriçãoLinkPré-requisito
SID0001*Simulação de dívidaSimulação das condições da dívida, utilizando variáveis previamente determinadasLink DocumentaçãoItem 1

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

CódigoEtapaDescriçãoLinkPré-requisito
EMD0001*Emissão de dívida PFEmissão da CCB PF. Formada por quatro objetos principais: dados cadastrais do devedor (objeto borrower), dados financeiros da operação (objeto financial), dados para desembolso via QR Code Pix e indicação do cessionário (purchaser_document_number)Link DocumentaçãoItens 1 e 2
EMD0002*Implementação de dados adicionaisDados para preenchimento da CCB geradaPayload alinhado em paraleloObrigatório, se definido a utilização.

4 - Formalização de dívida

CódigoEtapaDescriçãoLinkPré-requisito
FOR0001Formalização da dívidaA assinatura da CCB será realizada via Opt-In após a emissão da dívida--Item 3
FOR0002*Leitura do webhook de assinatura finalizadaLeitura da resposta assíncrona da formalização da operação. Webhook status signature_finishedLink DocumentaçãoFOR0001

5 - Desembolso da dívida

CódigoEtapaDescriçãoLinkPré-requisito
DES0001*Escolha da data de desembolsoApó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çãoItem 4
DES0002*Autorização de desembolsoFlag de liberação do pagamento, impede que uma operação seja desembolsada ser estar previamente autorizadaLink DocumentaçãoDES0001
DES0003*Leitura do webhook de desembolso da operaçãoLeitura 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 boletosLink DocumentaçãoDES0001 e DES0002

6 - Cancelamento da operação

CódigoEtapaDescriçãoLinkPré-requisito
CAN0002*Cancelamento permanente da dívida antes do desembolsoPermite o cancelamento definitivo (status final) da dívida antes do pagamentoLink DocumentaçãoEMD0001
CAN0003*Leitura do webhook de cancelamentoLeitura da resposta assíncrona do cancelamento da operação. Webhook status: canceledLink DocumentaçãoCAN0002
CAN0004Cancelamento de dívida em até sete dias após o desembolsoConsiderando 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çãoLink DocumentaçãoDES0002