Emissão de Dívida PJ com Assinatura Imediata (/signed_debt)

Este endpoint realiza a emissão da dívida para uma pessoa jurídica e processa a assinatura do contrato via opt-in em uma única chamada. O desembolso ocorre na data informada no campo disbursement_date, que pode ser diferente da data de emissão.

Não é necessário realizar o cadastro prévio do tomador: basta fornecer os dados cadastrais da empresa e de seus representantes legais no momento da requisição de emissão.

Pré-requisito — upload de documentos

Os documentos da empresa e dos representantes (estatuto/contrato social, documentos de identificação, etc.) devem ser enviados previamente via upload de documentos. Cada upload retorna uma document_key (UUID), que deve ser referenciada nos campos correspondentes do request.

Atenção — Onboarding e Antifraude

A QI Tech oferece uma solução de Onboarding de novos clientes e Antifraude.

Confira aqui a documentação das APIs deste serviço.

Para receber uma cotação, entre em contato com nosso time comercial: comercial@qitech.com.br ou (11) 3522-1301

O formato de assinatura do header e do body desta requisição é descrito em detalhes aqui.

Simulação de dívida

Antes de emitir, é possível simular os valores da operação de crédito. A simulação segue o mesmo padrão da emissão, porém não exige os dados cadastrais do tomador nem a conta de desembolso — basta informar borrower.person_type (legal para PJ) e o objeto financial. O exemplo abaixo simula com base no valor desembolsado (disbursed_amount + number_of_installments).

ENDPOINT

/debt_simulation

MÉTODO

POST

Request

Request Body

{
    "borrower": {
        "person_type": "legal"
    },
    "financial": {
        "interest_type": "pre_price_days",
        "disbursement_date": "2026-04-07",
        "fine_configuration": {
            "monthly_rate": 0.01,
            "interest_base": "calendar_days",
            "contract_fine_rate": 0.02
        },
        "disbursed_amount": 10000,
        "monthly_interest_rate": 0.03,
        "credit_operation_type": "ccb",
        "interest_grace_period": 0,
        "number_of_installments": 2,
        "principal_grace_period": 0
    }
}

Campos do Request

Campo	Tipo	Descrição
borrower.person_type*	enum	Natureza jurídica do tomador — usar legal para PJ
financial.interest_type*	enum	Método de amortização — Enumerador Interest Type
financial.credit_operation_type*	enum	Tipo do contrato de crédito — Enumerador Credit Operation Type
financial.disbursed_amount*	float	Valor desembolsado da operação
financial.monthly_interest_rate*	float	Taxa de juros mensal pré-fixada (em decimal)
financial.number_of_installments*	int	Número de parcelas
financial.disbursement_date	date	Data do desembolso (YYYY-MM-DD)
financial.interest_grace_period	int	Carência de juros (em meses)
financial.principal_grace_period	int	Carência do principal (em meses)
financial.fine_configuration	object	Configuração de multa e mora — Objeto Fine Configuration

Response

Response Body

{
    "type": "debt",
    "key": "bf84379c-d4cf-4f16-a63c-865c129e6fce",
    "status": "finished",
    "event_datetime": "2026-04-07 23:59:28",
    "data": {
        "interest_type": "pre_price_days",
        "credit_operation_type": "ccb",
        "interest_grace_period": 0,
        "principal_grace_period": 0,
        "prefixed_interest_rate": {
            "interest_base": "calendar_days",
            "annual_rate": 0.42576089,
            "monthly_rate": 0.03,
            "daily_rate": 0.00097227
        },
        "issue_date": "2026-04-07",
        "number_of_installments": 2,
        "final_disbursement_amount": 10000,
        "total_pre_fixed_amount": 453.94,
        "iof_amount": 51.07,
        "cet": 0.0335,
        "annual_cet": 0.4851,
        "disbursement_date": "2026-04-07",
        "issue_amount": 10076.2,
        "disbursed_issue_amount": 10000,
        "assignment_amount": 10106.4,
        "installments": [
            {
                "calendar_days": 30,
                "workdays": 20,
                "business_due_date": "2026-05-07",
                "due_date": "2026-05-07",
                "due_principal": 10076.2,
                "has_interest": true,
                "post_fixed_amount": 0,
                "pre_fixed_amount": 52.4,
                "tax_amount": 12.49,
                "total_amount": 5226.97,
                "principal_amortization_amount": 5174.57,
                "installment_number": 1
            },
            {
                "calendar_days": 31,
                "workdays": 20,
                "business_due_date": "2026-06-08",
                "due_date": "2026-06-07",
                "due_principal": 4901.63,
                "has_interest": true,
                "post_fixed_amount": 0,
                "pre_fixed_amount": 27.76,
                "tax_amount": 26.09,
                "total_amount": 5226.97,
                "principal_amortization_amount": 4901.63,
                "installment_number": 2
            }
        ]
    }
}

Campos do Response

A simulação não gera dívida nem retorna DEBT-KEY: o campo key é apenas o identificador da simulação e o status é finished. Os valores ficam dentro de data.

Campo	Tipo	Descrição
disbursed_issue_amount	float	Valor desembolsado informado na simulação
final_disbursement_amount	float	Valor efetivamente desembolsado para o tomador
issue_amount	float	Valor de emissão/nominal da operação
assignment_amount	float	Valor de aquisição (cessão) da operação
cet	float	Custo Efetivo Total mensal (em decimal)
annual_cet	float	Custo Efetivo Total anual (em decimal)
iof_amount	float	Valor total do IOF
total_pre_fixed_amount	float	Total de juros pré-fixados da operação
prefixed_interest_rate	object	Taxa de juros nominal (anual, diária, mensal e base de cálculo)
installments	array	Parcelas simuladas (data, valor, amortização, juros e IOF de cada parcela)

Emissão de dívida

ENDPOINT

/signed_debt

MÉTODO

POST

Testar no Playground

Request

Estrutura mínima (PJ + PIX)

Este é o corpo mínimo aceito para emitir uma dívida de pessoa jurídica com desembolso via PIX. Contém apenas os campos obrigatórios — todos os demais campos descritos neste manual são opcionais para este fluxo.

{
    "borrower": {
        "person_type": "legal",
        "name": "RAZAO SOCIAL EMPRESA",
        "phone": { "country_code": "055", "area_code": "11", "number": "991112222" },
        "address": {
            "street": "Rua Gilberto Sabino",
            "number": "215",
            "neighborhood": "Pinheiros",
            "city": "São Paulo",
            "state": "SP",
            "postal_code": "05425020"
        },
        "company_document_number": "80282008000127",
        "company_statute": "aa28e598-55e2-40f1-8884-671772c541a1",
        "company_type": "ltda",
        "cnae_code": "6822-6/00",
        "foundation_date": "2019-07-05",
        "trading_name": "NOME FANTASIA DA EMPRESA",
        "company_representatives": [
            {
                "person_type": "natural",
                "name": "NOME DO REPRESENTANTE",
                "phone": { "country_code": "055", "area_code": "11", "number": "990121234" },
                "address": {
                    "street": "Rua Gilberto Sabino",
                    "number": "215",
                    "neighborhood": "Pinheiros",
                    "city": "São Paulo",
                    "state": "SP",
                    "postal_code": "05425020"
                },
                "birth_date": "1993-09-10",
                "is_pep": false,
                "individual_document_number": "31057466093"
            }
        ]
    },
    "financial": {
        "disbursed_amount": 10000,
        "interest_type": "pre_price_days",
        "credit_operation_type": "ccb",
        "number_of_installments": 2,
        "interest_grace_period": 0,
        "principal_grace_period": 0,
        "monthly_interest_rate": 0.03,
        "fine_configuration": {
            "contract_fine_rate": 0.02,
            "monthly_rate": 0.01,
            "interest_base": "calendar_days"
        }
    },
    "additional_data": {},
    "disbursement_bank_accounts": [
        {
            "pix_key": "2f205c99-3161-4120-badd-854039d12de6",
            "pix_transfer_type": "key"
        }
    ]
}

Observações sobre o mínimo

• A chave additional_data é obrigatória, mas pode ser enviada vazia ({}). O bloco de assinatura (contract.signatures / opt-in) é opcional para este fluxo.
• monthly_interest_rate e disbursement_bank_accounts são operacionalmente obrigatórios: sem a taxa o cálculo pré-fixado não é possível, e sem a conta não há desembolso.
• postal_code deve ter 8 dígitos, sem traço.
• cnae_code deve ter de 7 a 9 caracteres (ex.: 6822-6/00 ou 6822600).
• company_representatives[].address é obrigatório.
• interest_grace_period e principal_grace_period são obrigatórios neste modo (use 0 quando não houver carência).

O exemplo completo abaixo inclui também os campos opcionais (e-mail, assinatura opt-in, etc.).

Request Body

Valor líquido

{
    "borrower": {
        "name": "RAZAO SOCIAL EMPRESA",
        "email": "emailempresa@email.com",
        "phone": {
            "number": "991112222",
            "area_code": "11",
            "country_code": "055"
        },
        "is_pep": false,
        "address": {
            "city": "São Paulo",
            "state": "SP",
            "number": "215",
            "street": "Rua Gilberto Sabino",
            "complement": "3 andar",
            "postal_code": "05425020",
            "neighborhood": "Pinheiros"
        },
        "cnae_code": "6822-6/00",
        "role_type": "issuer",
        "person_type": "legal",
        "company_type": "ltda",
        "trading_name": "NOME FANTASIA DA EMPRESA",
        "foundation_date": "2019-07-05",
        "attached_documents_list": [],
        "company_document_number": "80282008000127",
        "company_statute": "aa28e598-55e2-40f1-8884-671772c541a1",
        "company_representatives": [
            {
                "name": "NOME DO REPRESENTANTE",
                "email": "nomedorepresentante@email.com",
                "phone": {
                    "number": "990121234",
                    "area_code": "11",
                    "country_code": "055"
                },
                "is_pep": false,
                "final_beneficiary": true,
                "address": {
                    "city": "São Paulo",
                    "state": "SP",
                    "number": "215",
                    "street": "Rua Gilberto Sabino",
                    "complement": "3 andar",
                    "postal_code": "05425020",
                    "neighborhood": "Pinheiros"
                },
                "role_type": "company_representative",
                "birth_date": "1993-09-10",
                "profession": "DIRETOR",
                "mother_name": "NOME DA MAE DO REPRESENTANTE",
                "nationality": "BRASILEIRO",
                "person_type": "natural",
                "marital_status": "single",
                "attached_documents_list": [],
                "individual_document_number": "31057466093",
                "document_identification_number": "20202020200"
            }
        ]
    },
    "financial": {
        "interest_type": "pre_price_days",
        "disbursement_date": "2026-04-07",
        "fine_configuration": {
            "monthly_rate": 0.01,
            "interest_base": "calendar_days",
            "contract_fine_rate": 0.02
        },
        "disbursed_amount": 10000,
        "monthly_interest_rate": 0.03,
        "credit_operation_type": "ccb",
        "interest_grace_period": 0,
        "number_of_installments": 2,
        "principal_grace_period": 0
    },
    "additional_data": {
        "contract": {
            "contract_number": "DWF1761222116",
            "signatures": [
                {
                    "signer": {
                        "name": "NOME DO REPRESENTANTE",
                        "email": "nomedorepresentante@email.com",
                        "phone": {
                            "number": "990121234",
                            "area_code": "11",
                            "country_code": "055"
                        },
                        "document_number": "31057466093"
                    },
                    "signature": {
                        "timestamp": "28-01-2026 06:36:35",
                        "ip_address": "192.168.1.1",
                        "signature_file": {
                            "file_url": "https://qitech.com.br/signature.pdf",
                            "file_type": "pdf"
                        }
                    }
                }
            ]
        }
    },
    "requester_identifier_key": "d1905ef5-19df-4183-bf0e-802b8229933c",
    "purchaser_document_number": "32402502000135",
    "disbursement_bank_accounts": [
        {
            "document_number": "31233261000185",
            "name": "Fornecedor",
            "pix_key": "2f205c99-3161-4120-badd-854039d12de6",
            "pix_transfer_type": "key"
        }
    ]
}

Detalhes do Request Body

Campo	Tipo	Descrição	Caracteres
borrower*	object	Objeto do tomador pessoa jurídica — a empresa devedora da operação de crédito	Objeto Borrower
financial*	object	Contém todos os detalhes financeiros e parâmetros de cálculo da operação	Objeto Financial
additional_data*	object	Dados adicionais do contrato. A chave é obrigatória, mas pode ser enviada vazia ({}); seu conteúdo (opt-in) não é validado	Objeto Additional Data
requester_identifier_key	string	Chave identificadora do solicitante	UUID
purchaser_document_number	string	CNPJ do cessionário — o comprador da operação de crédito (FIDC)	14
disbursement_bank_accounts ⚠	array	Dados de desembolso via PIX. Não exigido pelo schema, mas operacionalmente obrigatório (sem ele não há desembolso)	Objeto Disbursement Bank Account

Legenda

* campo obrigatório no schema · ⚠ não exigido pelo schema, mas operacionalmente necessário · sem marcação: opcional.

Objeto Borrower

O borrower representa a pessoa jurídica tomadora. Por isso o campo person_type deve conter sempre o valor legal.

Campo	Tipo	Descrição	Caracteres
name*	string	Razão social da empresa	100
trading_name*	string	Nome fantasia da empresa	100
email	string	E-mail institucional da empresa	254
phone*	object	Telefone da empresa	Objeto Phone
is_pep	boolean	Indicador de Pessoa Politicamente Exposta	-
address*	object	Endereço da empresa	Objeto Address
role_type	string	Papel do tomador na operação — default: issuer	-
person_type*	string	Classificação da pessoa — deve ser sempre legal	5
company_type*	enum	Tipo da empresa	Enumerador Company Type
company_document_number*	string	CNPJ da empresa — somente números	14
cnae_code*	string	Classificação Nacional de Atividades Econômicas	-
foundation_date*	date	Data de abertura da empresa (Formato: "YYYY-MM-DD")	10
company_statute*	string	document_key do PDF do contrato social/estatuto da empresa (enviado previamente)	UUID
directors_election_minute	string	document_key do PDF da ata de eleição (recomendado para company_type igual a sa; não é forçado pelo schema)	UUID
attached_documents_list	array	Lista de documentos anexados da empresa	-
company_representatives*	array	Lista de representantes legais da empresa	Objeto Company Representatives

Objeto Company Representatives

Lista dos representantes legais da empresa. O representante que assina o contrato deve também constar no array signatures em Objeto Contract.

Campo	Tipo	Descrição	Caracteres
person_type*	string	Identificador do tipo de pessoa — deve ser natural	7
name*	string	Nome completo do representante	100
birth_date*	date	Data de nascimento (Formato: "YYYY-MM-DD")	10
is_pep*	boolean	Declaração se o representante é PEP	-
individual_document_number*	string	CPF do representante — somente números	11
phone*	object	Telefone do representante	Objeto Phone
address*	object	Endereço do representante	Objeto Address
mother_name	string	Nome da mãe do representante	100
profession	string	Profissão do representante	64
nationality	string	Nacionalidade do representante	50
marital_status	string	Estado civil do representante	-
property_system	string	Regime de bens (recomendado para marital_status igual a married; não é forçado pelo schema)	Enumerador Property System
wedding_certificate	string	document_key do PDF da certidão de casamento (null se solteiro)	UUID
spouse	object	Dados do cônjuge (null se solteiro; não é forçado pelo schema)	Objeto Spouse
final_beneficiary	boolean	Declaração se o representante é beneficiário final da empresa	-
document_identification	string	document_key do PDF do documento de identificação com foto (RG ou CNH)	UUID
document_identification_back	string	document_key do PDF do verso do documento de identificação	UUID
document_identification_type	string	Tipo do documento de identificação enviado	-
document_identification_number	string	Número do documento de identificação enviado	16
email	string	E-mail do representante	254
role_type	string	Papel na operação — default: company_representative	-
proof_of_residence	string	document_key do PDF do comprovante de endereço (enviado previamente)	UUID

Objeto Spouse

Campo	Tipo	Descrição	Caracteres
person_type*	string	Identificador do tipo de pessoa — deve ser natural	7
name*	string	Nome completo do cônjuge	100
mother_name*	string	Nome da mãe do cônjuge	100
birth_date*	date	Data de nascimento (Formato: "YYYY-MM-DD")	10
profession*	string	Profissão do cônjuge	64
is_pep*	boolean	Declaração se o cônjuge é PEP	-
individual_document_number*	string	CPF do cônjuge — somente números	11
document_identification_number*	string	Número do documento de identificação do cônjuge	16
email*	string	E-mail do cônjuge	254
phone*	object	Telefone do cônjuge	Objeto Phone
address	object	Endereço do cônjuge	Objeto Address

Objeto Address

Campo	Tipo	Descrição	Caracteres
city*	string	Nome da cidade	100
state*	string	Sigla do estado (duas letras maiúsculas)	2
number*	string	Número do logradouro	10
street*	string	Nome do logradouro	100
complement	string	Complemento do endereço (texto livre)	100
postal_code*	string	CEP — somente números	8
neighborhood*	string	Nome do bairro	100

Objeto Phone

Campo	Tipo	Descrição	Caracteres
number*	string	Número do telefone	10
area_code*	string	Código de área (DDD)	2
country_code*	string	Código internacional (ex: "055")	3

Objeto Financial

Nesta modalidade, o valor da operação é definido pelo valor líquido a ser desembolsado (disbursed_amount), em conjunto com a taxa de juros (monthly_interest_rate) e o número de parcelas (number_of_installments). A partir desses dados, o sistema calcula o valor de cada parcela.

Campo	Tipo	Descrição	Caracteres
interest_type*	string	Método de amortização	Enumerador Interest Type
fine_configuration*	object	Configuração de multa e mora	Objeto Fine Configuration
disbursed_amount*	float	Valor líquido a ser desembolsado	15,2
credit_operation_type*	string	Tipo da operação de crédito	Enumerador Credit Operation Type
number_of_installments*	integer	Número de parcelas	3
interest_grace_period*	integer	Período de carência de juros (em meses) — use 0 quando não houver	3
principal_grace_period*	integer	Período de carência do principal (em meses) — use 0 quando não houver	3
monthly_interest_rate ⚠	float	Taxa de juros mensal (em decimal). Não exigida pelo schema, mas necessária para o cálculo pré-fixado (interest_type pre_*)	10,6
disbursement_date	string	Data de desembolso (YYYY-MM-DD). Se omitida, assume a data de emissão	10

Objeto Fine Configuration

Campo	Tipo	Descrição	Caracteres
monthly_rate*	float	Taxa de mora mensal (alternativamente, informe daily_rate ou annual_rate)	10,6
interest_base*	string	Base de cálculo da mora	Enumerador Interest Base
contract_fine_rate*	float	Taxa de multa contratual	10,6

Objeto Disbursement Bank Account

O desembolso desta operação é realizado via chave PIX. Informe os dados do recebedor do desembolso no array disbursement_bank_accounts.

Campo	Tipo	Descrição	Caracteres
pix_key*	string	Chave PIX para a qual o desembolso será realizado	-
pix_transfer_type*	string	Tipo de transferência PIX — utilizar key para transferência via chave	-
document_number	string	CPF/CNPJ do titular da chave PIX. Obrigatório apenas quando há mais de uma conta de desembolso	14
name	string	Nome do titular da chave PIX. Obrigatório apenas quando há mais de uma conta de desembolso	50
percentage_receivable	float	Percentual do desembolso para esta conta. Obrigatório com múltiplas contas (a soma deve ser 100)	3

Objeto Additional Data

A chave additional_data é obrigatória no request, mas seu conteúdo não é validado pelo schema — pode ser enviada vazia ({}). Os campos abaixo são opcionais e descrevem a estrutura caso você opte por enviar a evidência de assinatura (opt-in).

Campo	Tipo	Descrição	Caracteres
contract	object	Dados do contrato	Objeto Contract

Objeto Contract

Campo	Tipo	Descrição	Caracteres
contract_number*	string	Número identificador único do contrato	20
signatures*	array	Lista de objetos de evidência de assinatura digital (Opt-in) dos representantes legais	Objeto Signature

Objeto Signature

Campo	Tipo	Descrição	Caracteres
signer*	object	Dados de identificação do assinante (representante legal)	Objeto Signer
signature*	object	Dados de evidência da assinatura digital	Objeto Signature Details

Objeto Signer

Campo	Tipo	Descrição	Caracteres
name*	string	Nome completo do assinante	255
document_number*	string	CPF do assinante	11
email	string	E-mail do assinante	100
phone	object	Telefone do assinante	Objeto Phone

Objeto Signature Details

Campo	Tipo	Descrição	Caracteres
ip_address*	string	Endereço IP utilizado na assinatura	45
timestamp*	string	Data e hora da assinatura	24
signature_file*	object	Arquivo da assinatura digital	Objeto Signature File

Objeto Signature File

Campo	Tipo	Descrição	Caracteres
file_url*	string	Link direto para o documento do contrato assinado (PDF)	2048
file_type*	string	Formato do arquivo de assinatura (ex: "pdf")	4

Response

A resposta à requisição de emissão retornará o plano de pagamento e uma DEBT-KEY, que é o identificador da dívida na QI SCD.

STATUS

201

Response Body

{
    "webhook_type": "debt",
    "key": "72760166-4ddf-41fb-8a8c-605f8f4fc35c",
    "status": "issued",
    "event_datetime": "2026-04-07 23:59:28",
    "data": {
        "borrower": {
            "name": "RAZAO SOCIAL EMPRESA",
            "document_number": "80282008000127",
            "related_party_key": "24fac77e-7782-4f72-b31a-daee288e34ed"
        },
        "contract": {
            "document_key": null,
            "number": "DWF1761222116",
            "urls": [],
            "signature_information": [
                {
                    "signer_name": "NOME DO REPRESENTANTE",
                    "signer_document_number": "31057466093",
                    "signer_role": "issuer",
                    "signer_email": null,
                    "signer_external_key": null,
                    "signature_url": null
                }
            ]
        },
        "requester_identifier_key": "d1905ef5-19df-4183-bf0e-802b8229933c",
        "iof_charge_method": "financed",
        "collaterals": [],
        "contract_fees": [
            {
                "fee_type": "spread",
                "fee_amount": 30.2
            }
        ],
        "external_contract_fees": [
            {
                "fee_type": "tac",
                "fee_amount": 0,
                "tax_amount": 0,
                "net_fee_amount": 0
            }
        ],
        "external_contract_fee_amount": 0,
        "net_external_contract_fee_amount": 0,
        "contract_fee_amount": 30.2,
        "issue_amount": 10076.2,
        "assignment_amount": 10106.4,
        "cet": "3,3500%",
        "annual_cet": "48,5100%",
        "number_of_installments": 2,
        "base_iof": 12.49,
        "additional_iof": 38.58,
        "total_iof": 51.07,
        "ipoc_code": "324025020203180282008000127DWF1761222116",
        "prefixed_interest_rate": {
            "annual_rate": 0.42576089,
            "created_at": "2026-04-07T23:59:22",
            "daily_rate": 0.00097227,
            "interest_base": "calendar_days",
            "monthly_rate": 0.03
        },
        "installments": [
            {
                "accrual_reference_date": null,
                "additional_costs": [],
                "advanced_paid_amount": 0,
                "bank_slip_key": null,
                "business_due_date": "2026-05-07",
                "calendar_days": 30,
                "digitable_line": null,
                "due_date": "2026-05-07",
                "due_interest": 0,
                "due_principal": 10076.2,
                "fine_amount": null,
                "has_interest": true,
                "installment_history": [],
                "installment_key": "1dea396f-beb1-4df3-9822-35800b4c095a",
                "installment_number": 1,
                "installment_payment": [],
                "installment_status": "created",
                "installment_type": "principal",
                "paid_amount": 0,
                "paid_at": null,
                "post_fixed_amount": 0,
                "qr_code_key": null,
                "qr_code_url": null,
                "renegotiation_proposal_key": null,
                "total_amount": 5226.97,
                "total_paid_amount": 0,
                "workdays": 20
            },
            {
                "accrual_reference_date": null,
                "additional_costs": [],
                "advanced_paid_amount": 0,
                "bank_slip_key": null,
                "business_due_date": "2026-06-08",
                "calendar_days": 31,
                "digitable_line": null,
                "due_date": "2026-06-07",
                "due_interest": 0,
                "fine_amount": null,
                "has_interest": true,
                "installment_history": [],
                "installment_key": "370e73d1-55d8-431e-9b22-d08fb8297999",
                "installment_number": 2,
                "installment_payment": [],
                "installment_status": "created",
                "installment_type": "principal",
                "paid_amount": 0,
                "paid_at": null,
                "post_fixed_amount": 0,
                "qr_code_key": null,
                "qr_code_url": null,
                "renegotiation_proposal_key": null,
                "total_amount": 5226.97,
                "total_paid_amount": 0,
                "workdays": 20
            }
        ],
        "total_pre_fixed_amount": 453.94
    }
}

Atenção

Lembre-se de salvar a DEBT-KEY retornada, pois ela será necessária para consultas, renegociações e estornos da operação.

Detalhes do Response Body

Campo	Tipo	Descrição
webhook_type	string	Identificador do tipo de evento
key	string	DEBT-KEY — identificador único da dívida na QI SCD (UUID)
status	string	Status atual da dívida — veja os status de uma dívida
event_datetime	string	Data e hora do evento
data	object	Objeto Data — Dados da operação

Objeto Data

Campo	Tipo	Descrição
borrower	object	Dados do tomador (razão social, CNPJ e related_party_key)
contract	object	Dados do contrato, incluindo informações de assinatura
requester_identifier_key	string	Chave identificadora do solicitante (UUID)
iof_charge_method	string	Método de cobrança do IOF — sempre "financed"
collaterals	array	Lista de garantias da operação
contract_fees	array	Taxas QI Tech cobradas na operação
external_contract_fees	array	Taxas externas cobradas na operação
contract_fee_amount	float	Valor total das taxas QI Tech
issue_amount	float	Valor nominal da operação de crédito
assignment_amount	float	Valor de cessão da operação de crédito
cet	string	Custo Efetivo Total mensal
annual_cet	string	Custo Efetivo Total anual
number_of_installments	integer	Número de parcelas
base_iof	float	Valor base do IOF
additional_iof	float	Valor adicional do IOF
total_iof	float	Valor total do IOF
ipoc_code	string	Código de registro de crédito brasileiro gerado pela QI Tech
prefixed_interest_rate	object	Taxa de juros nominal (anual, diária, mensal e base de cálculo)
installments	array	Parcelas da operação
total_pre_fixed_amount	float	Valor total dos juros pré-fixados de todas as parcelas

Webhooks

Durante o ciclo de vida da operação, a QI Tech envia webhooks para a URL configurada. Abaixo estão os eventos relevantes para este fluxo.

Informação

O timeout para resposta dos nossos webhooks é de 5 segundos.

Atenção!

Os webhooks da QI Tech não devem ser mapeados de forma restrita. Campos adicionais podem ser incluídos aos payloads retornados.

Webhook de documento gerado

Enviado quando o contrato da operação é gerado. Traz a document_key e as URLs do documento (incluindo a versão assinada).

Response Body

{
    "key": "cc91aac2-8d15-4349-b155-7c23080c61e8",
    "data": {
      "contract": {
        "urls": [
          "https://storage.googleapis.com/live-doc-api/documents/50711223-dfe2-4ed6-9c41-42d68638cfff.pdf"
        ]
      },
      "document_key": "50711223-dfe2-4ed6-9c41-42d68638cfff",
      "signed_contract_url": "https://storage.googleapis.com/live-doc-api/documents/_signed.pdf"
    },
    "status": "generated_document",
    "webhook_type": "debt",
    "event_datetime": "2026-03-24 08:27:11"
}

Webhook de desembolso

Enviado quando o desembolso da operação é realizado (status: disbursed). Traz a agenda de parcelas e os comprovantes de transferência (ted_receipt_list).

Response Body

{
    "key": "bb81d525s-aa4b-4ddf-81d6-aa4b41fd04nb",
    "data": {
        "installments": [
        {
            "due_date": "2025-11-24",
            "total_amount": 8304.16,
            "installment_key": "7ec2f4d-b21e-4bd5-ahs6-60e998267249",
            "pre_fixed_amount": 2475.77421509,
            "installment_number": 1,
            "principal_amortization_amount": 5828.23857532
        },
        {
            "due_date": "2025-12-22",
            "total_amount": 8304.16,
            "installment_key": "54g37d78-a9a9-bf82-9f8e-fd3ba123797a",
            "pre_fixed_amount": 2001.06342502,
            "installment_number": 2,
            "principal_amortization_amount": 6303.43346322
        }
        ],
        "ted_receipt_list": [
        {
            "fee": 0,
            "url": "https://storage.storage.com/sandbox-doc-api/documents/f9as9329-22bd-4dbg-91a2-f2sdgeth4h04/fheth459-bhrf-4hrt-9hra-fdsfsgehth42.pdf",
            "amount": 123456.0,
            "origin": {
            "name": "QI SOCIEDADE DE CRÉDITO DIRETO S.A.",
            "type": "payment_account",
            "branch": "0001",
            "document": "32402502000777",
            "bank_code": "329",
            "account_key": "5d068423-7774-49e4-b15b-7741238df5a8",
            "branch_digit": null,
            "account_digit": "5",
            "account_branch": "0001",
            "account_number": "00002",
            "financial_institution_name": "QI SOCIEDADE DE CRÉDITO DIRETO S.A."
            },
            "timestamp": "2025-10-26T17:00:51",
            "description": "60701190 8615 22110-2 96969879003 - Fornecedor",
            "destination": {
            "name": "Fornecedor",
            "type": "checking_account",
            "branch": "8612",
            "purpose": "Crédito PIX em Conta",
            "document": "31233261000185",
            "bank_ispb": "60111190",
            "branch_digit": null,
            "account_digit": "2",
            "account_number": "44110",
            "financial_institution_name": "BANCO S.A."
            },
            "end_to_end_id": "E32402402200510221300gNgeefVNtVr",
            "transaction_key": "25044504-1902-412a-a445-23b813bee6c1",
            "origin_transaction_key": "542224ea-b5ea-49ff-b7b7-673b81af387b"
        }
        ],
        "requester_identifier_key": null
    },
    "status": "disbursed",
    "webhook_type": "debt",
    "event_datetime": "2025-10-26 17:00:52"
}

Webhook de cancelamento

Enviado quando a operação é cancelada (status: canceled). O campo cancel_reason_enumerator indica o motivo.

Response Body

{
    "webhook_type": "debt",
    "key": "27a099df-4688-43cb-87fa-515b1cf343a5",
    "event_datetime": "2022-09-27 07:03:49",
    "data": {
        "cancel_reason": "Operacao cancelada manualmente",
        "cancel_reason_enumerator": "manual"
    },
    "status": "canceled"
}

Motivos de cancelamento

cancel_reason_enumerator	Descrição
disbursing_error	Operação cancelada por erro no momento do desembolso.
waiting_signature	Operação cancelada por falta de assinatura.
is_portability	A operação foi cancelada pois é uma portabilidade que não foi concluída.
not_collateral_constituted	A operação foi cancelada pois as garantias não foram constituídas.
entry_not_paid	A operação foi cancelada pois a entrada não foi paga.
not_assigned	Operação cancelada porque o processo de cessão não foi realizado.
pix_max_retry	Operação cancelada pois o banco recebedor não conseguiu receber o desembolso.
lack_of_resource	Operação cancelada por falta de recurso.
manual	Operação cancelada manualmente.
kyc_not_accepted	Operação cancelada pois não foi aprovada no compliance.
not_collateral_fgts	Operação cancelada por erro com FGTS.
agencia_conta_invalida	Agência ou conta destinatária do crédito inválida.
invalid_account	Número da conta de destino é inexistente ou inválido.
invalid_document_number	CPF/CNPJ da conta de destino está incorreto.
unsupported_transaction	A conta de destino não suporta este tipo de transação.
bank_slip_payment	Operação cancelada por erro no pagamento do boleto.
bank_slip_paid	Operação cancelada pois o boleto já está pago.
bank_slip_written_off	Operação cancelada pois o boleto já está baixado.
invalid_ispb	Número ISPB é inválido ou inexistente.
rejected_payment	Ordem de pagamento foi rejeitada pelo banco recebedor.
disbursed_amount_refunded	Operação cancelada devido à devolução do valor de desembolso.

Enumeradores

Enumerador Company Type

Enumerador	Descrição
ltda	Sociedade Limitada
sa	Sociedade Anônima
micro_enterprise	Microempresa
freelancer	Profissional autônomo

Enumerador Property System

Enumerador	Descrição
total_communion_of_goods	Comunhão total de bens
partial_communion_of_goods	Comunhão parcial de bens
final_participation_of_acquisitions	Participação final nos aquestos
compulsory_separation_of_goods	Separação obrigatória de bens

Enumerador Interest Type

Enumerador	Descrição
pre_price_days	Amortização Price (parcelas iguais) com juros pré-fixado ao dia
pre_price	Amortização Price (parcelas iguais) com juros pré-fixado em períodos fixos (30 dias)
pre_sac	Amortização SAC (amortização constante) com juros pré-fixado ao dia
post_sac	Amortização SAC com juros pré-fixado + indexador pós-fixado (cdi, ipca ou igpm) ao dia
post_price	Amortização Price com juros pré-fixado + indexador pós-fixado em períodos fixos (30 dias)
post_price_days	Amortização Price com juros pré-fixado + indexador pós-fixado ao dia

Enumerador Credit Operation Type

Enumerador	Descrição
ccb	Cédula de Crédito Bancário
cce	Cédula de Crédito à Exportação
cci	Cédula de Crédito Imobiliário
nce	Nota de Crédito à Exportação
ncom	Nota Comercial

Enumerador Interest Base

Enumerador	Descrição
workdays	Cálculo de juros em dias úteis considerando um ano de 252 dias
calendar_days	Cálculo de juros em dias corridos considerando um ano de 360 dias
calendar_days_365	Cálculo de juros em dias corridos considerando um ano de 365 dias