Scripts de Integração - BNPL Full

Resumo

Disponibilizamos scripts Python prontos para uso que demonstram o fluxo completo de integração BNPL Full com a API Sandbox da QI Tech. Cada script corresponde a uma chamada de API testada e validada.

Todos os payloads e respostas exibidos nesta documentação refletem as respostas reais da API Sandbox, obtidas através destes scripts.

Download

Os scripts estão disponíveis no repositório do projeto:

📦 Baixar pacote Python completo

Pre-requisitos

• Python 3.8+
• Dependencias: requests, python-jose, python-dotenv
• Arquivo _local.env com suas credenciais Sandbox:
  • API_KEY - Sua chave de API
  • QI_PUBLIC_KEY - Chave publica da QI Tech
  • CLIENT_PRIVATE_KEY - Sua chave privada EC (PEM)

Scripts Disponiveis

Emissao

#	Script	Endpoint	Metodo	Descricao
01	01_issuance_simulation.py	/v2/credit_operation/simulation	POST	Simular uma operacao de credito antes da emissao
02	02_issuance_issuance.py	/signed_debt	POST	Emitir a divida com assinatura de contrato via opt-in
03	03_issuance_query.py	/v2/credit_operation/requester_identifier_key/{key}	GET	Consultar a operacao emitida

Estorno

#	Script	Endpoint	Metodo	Descricao
04	04_reversal_cancel_before_disbursement.py	/debt/{debt_key}/cancel	PATCH	Cancelar operacao antes do desembolso
05	05_reversal_cancel_after_disbursement.py	/debt/reversal	POST	Estornar operacao apos desembolso (gera Pix de devolucao)

Renegociacao

#	Script	Endpoint	Metodo	Descricao
06	06_renegotiation_simulation.py	/renegotiation/batch_proposal_simulation	POST	Simular renegociacao em lote
07	07_renegotiation_proposal.py	/renegotiation/batch_proposal	POST	Criar proposta de renegociacao em lote
08	08_renegotiation_query.py	/renegotiation/batch_proposal/{key}	GET	Consultar proposta por chave
09	09_renegotiation_list.py	/renegotiation/batch_proposal	GET	Listar todas as propostas
10	10_renegotiation_cancel.py	/renegotiation/batch_proposal/{key}	DELETE	Cancelar proposta pendente

Refinanciamento

#	Script	Endpoint	Metodo	Descricao
11	11_refinancing_present_value.py	/debt	GET	Consultar valor presente para calculo de refinanciamento
12	12_refinancing_simulation.py	/debt_simulation	POST	Simular operacao de refinanciamento
13	13_refinancing_issuance.py	/signed_debt	POST	Criar refinanciamento (emite nova divida, liquida a anterior)

Como Usar

1. Baixe os scripts do repositorio
2. Crie um arquivo _local.env com suas credenciais Sandbox
3. Execute os scripts em ordem numerica
4. Atualize as chaves (DEBT_KEY, BATCH_PROPOSAL_KEY, etc.) entre os scripts conforme necessario

Sobre os exemplos da documentacao

Cada script inclui a resposta real da API como bloco de comentario no final do arquivo. Esses exemplos sao a fonte de verdade para os payloads exibidos nas paginas desta documentacao.