Emissão de dívida PF
Com a API de emissão de dívida é possível solicitar a emissão de uma dívida para uma pessoa física. Não é necessário realizar o cadastro prévio do tomador, basta informar os dados cadastrais no momento da solicitação da dívida.
A QI Tech oferece uma solução de Oboarding de novos clientes e Anti-fraude.
Para receber uma cotação, entre em contato com nosso time comercial:
comercial@qitech.com.br ou (11) 3522-1301
A API de dívida foi desenhada para ser executada em apenas uma requisição, após um prévio envio dos arquivos (upload de documentos). O formato de assinatura do header e do body desta requisição é descrito em detalhes aqui.
Request
Request Body
{
"borrower": {
"name": "Alan Mathison Turing",
"email": "alan.turing@email.com",
"phone": {
"number": "912345678",
"area_code": "11",
"country_code": "055"
},
"is_pep": false,
"address": {
"city": "São Paulo",
"state": "SP",
"number": "1000",
"street": "Avenida Feliz",
"complement": "AP 801",
"postal_code": "49026100",
"neighborhood": "Centro"
},
"role_type": "issuer",
"birth_date": "1990-11-20",
"mother_name": "Nome da Mãe do Alan",
"nationality": "brasileiro",
"person_type": "natural",
"individual_document_number": "96969879003",
"document_identification": "494598fd-c226-4332-a500-591ae3884673"
},
"financial": {
"disbursed_amount": 123456,
"interest_type": "pre_price_days",
"credit_operation_type": "ccb",
"monthly_interest_rate": 0.018,
"disbursement_date": "2026-03-01",
"rebates": [
{
"amount": 10,
"fee_type": "tac",
"amount_type": "absolute",
"rebate_bank_account": {
"name": "CONTA BANCARIA",
"bank_code": "329",
"account_digit": "1",
"branch_number": "0001",
"account_number": "00003",
"document_number": "32402502000135"
}
}
],
"interest_grace_period": 0,
"principal_grace_period": 0,
"number_of_installments": 2,
"fine_configuration": {
"contract_fine_rate": 0.02,
"interest_base": "calendar_days",
"monthly_rate": 0.01
}
},
"disbursement_bank_account": {
"name": "Alan Mathison Turing",
"document_number": "96969879003",
"bank_code": "341",
"branch_number": "8615",
"account_number": "22110",
"account_digit": "2",
"account_type": "checking_account"
},
"purchaser_document_number": "32402502000135"
}
Response
A resposta desse pedido de dívida retornará o plano de pagamento assim como uma DEBT-KEY, que é o identificador da dívida na QI SCD.
Response Body
{
"webhook_type": "debt",
"key": "1baea8a0-0fca-4f7c-8857-a227d4da72f8",
"status": "waiting_signature",
"event_datetime": "2025-03-27 22:46:10",
"data": {
"requester_identifier_key": "1baea8a0-0fca-4f7c-8857-a227d4da72f8",
"iof_charge_method": "financed",
"prefixed_interest_rate": {
"annual_rate": 0.2387205316,
"created_at": "2025-03-27T22:46:04",
"daily_rate": 0.0005866899,
"interest_base": "calendar_days_365",
"monthly_rate": 0.018
},
"borrower": {
"name": "Alan Mathison Turing",
"document_number": "96969879003",
"related_party_key": "d5cbcada-42e7-4d5b-84fc-3c2dc8038411"
},
"contract": {
"number": "0000192840/AMT",
"urls": [
"https://storage.googleapis.com/sandbox-doc-api/documents/b2d974f9-c710-42e3-8ea4-69cc31561c38/GENERICTEST-ALAN_MATHISON_TURING-CCB-0000192840-20250327224604.pdf"
],
"signers": [
{
"signer_name": "Alan Mathison Turing",
"signer_document_number": "96969879003",
"signer_role": "issuer",
"signer_email": "alan.turing@email.com",
"signer_external_key": null,
"signature_url": null
}
]
},
"installments": [
{
"accrual_reference_date": null,
"additional_costs": [],
"advanced_paid_amount": 0.0,
"bank_slip_key": null,
"business_due_date": "2026-04-01",
"calendar_days": 31,
"digitable_line": null,
"due_date": "2026-04-01",
"due_interest": 0.0,
"due_principal": 124424.89,
"fine_amount": null,
"has_interest": true,
"installment_history": [],
"installment_key": "b4c722a1-c977-415d-891a-342308edd52f",
"installment_number": 1,
"installment_payment": [],
"installment_status": "created",
"installment_type": "principal",
"original_due_principal": 124424.89,
"original_pre_fixed_amount": 2282.99189209,
"original_principal_amortization_amount": 61684.03810791,
"original_total_amount": 63967.03,
"paid_amount": 0.0,
"paid_at": null,
"post_fixed_amount": 0,
"pre_fixed_amount": 2282.99189209,
"principal_amortization_amount": 61684.03810791,
"qr_code_key": null,
"qr_code_url": null,
"renegotiation_proposal_key": null,
"tax_amount": 156.80082487,
"total_accrual_amount": null,
"total_amount": 63967.03,
"total_paid_amount": 0.0,
"workdays": 23
},
{
"accrual_reference_date": null,
"additional_costs": [],
"advanced_paid_amount": 0.0,
"bank_slip_key": null,
"business_due_date": "2026-05-04",
"calendar_days": 33,
"digitable_line": null,
"due_date": "2026-05-04",
"due_interest": 0.0,
"due_principal": 62740.85189209,
"fine_amount": null,
"has_interest": true,
"installment_history": [],
"installment_key": "0d042ffc-1629-4ed4-8ec9-0972b2f715ba",
"installment_number": 2,
"installment_payment": [],
"installment_status": "created",
"installment_type": "principal",
"original_due_principal": 62740.85189209,
"original_pre_fixed_amount": 1226.17810791,
"original_principal_amortization_amount": 62740.85189209,
"original_total_amount": 63967.03,
"paid_amount": 0.0,
"paid_at": null,
"post_fixed_amount": 0,
"pre_fixed_amount": 1226.17810791,
"principal_amortization_amount": 62740.85189209,
"qr_code_key": null,
"qr_code_url": null,
"renegotiation_proposal_key": null,
"tax_amount": 329.26399073,
"total_accrual_amount": null,
"total_amount": 63967.03,
"total_paid_amount": 0.0,
"workdays": 20
}
],
"total_pre_fixed_amount": 3509.17,
"contract_fees": [
{
"fee_type": "spread",
"fee_amount": 497.7
},
{
"fee_type": "spread_ted_fee",
"fee_amount": 1.0
}
],
"contract_fee_amount": 498.7,
"external_contract_fees": [
{
"fee_type": "tac",
"fee_amount": 10.0,
"tax_amount": 1.42,
"description": null,
"net_fee_amount": 8.58,
"rebate_bank_account": {
"account_branch": "0001",
"account_digit": "1",
"account_number": "00003",
"created_at": "2025-03-27T22:46:04",
"document_number": "32402502000135",
"financial_institutions": {
"code_number": 329,
"is_active": true,
"is_pix_participant": true,
"ispb": 32402502,
"name": "QI SOCIEDADE DE CRÉDITO DIRETO S.A."
},
"financial_institutions_code_number": "329",
"name": "CONTA BANCARIA"
}
},
{
"fee_type": "spread",
"fee_amount": 0.0,
"tax_amount": 0.0,
"description": null,
"net_fee_amount": 0.0,
"rebate_bank_account": null
},
{
"fee_type": "insurance_premium",
"fee_amount": 0.0,
"tax_amount": 0.0,
"description": null,
"net_fee_amount": 0.0,
"rebate_bank_account": null
}
],
"external_contract_fee_amount": 10.0,
"net_external_contract_fee_amount": 8.58,
"assignment_amount": 124923.59,
"issue_amount": 124424.89,
"disbursed_issue_amount": 123456.0,
"cet": "2,3100%",
"annual_cet": "31,5716%",
"number_of_installments": 2,
"base_iof": 486.06,
"additional_iof": 472.83,
"total_iof": 958.89,
"collaterals": [],
"entry": null
}
}
Definições
Objeto Request Body
Campo | Tipo | Descrição | Máx. Caract. |
---|---|---|---|
borrower * | object | Objeto Borrower - Devedor da operação de crédito | - |
disbursement_bank_account * | object | Objeto Disbursement Bank Account - Dados da conta bancária para desembolso da operação | - |
financial * | object | Objeto Financial - Dados da conta bancária para desembolso da operaçãoIdentificador de que o objeto enviado é uma pessoa física. Deve conter SEMPRE o valor "natural" para borrower PF | - |
purchaser_document_number * | string | CNPJ do cessionário (comprador) da operação de crédito | - |
Objeto Borrower
Campo | Tipo | Descrição | Máx. Caract. |
---|---|---|---|
name * | string | Nome do devedor | 100 |
string | Email do devedor | 254 | |
phone | object | Objeto Phone - Telefone de contato do devedor | - |
is_pep * | boolean | Indicador de PEP (http://www.portaldatransparencia.gov.br/download-de-dados/pep) | - |
address * | object | Objeto Address - Endereço do devedor | - |
role_type * | enum | default: issuer | - |
birth_date * | date | Data de nascimento do devedor (formato "AAAA-MM-DD") | - |
mother_name * | string | Nome da mãe do devedor | 100 |
nationality | string | Nacionalidade do devedor | 50 |
person_type * | string | Indicador de pessoa física - default: natural | - |
individual_document_number * | string | CPF do devedor (apenas números) | 11 |
document_identification * | string | DOCUMENT_KEY do PDF do documento de identificação do devedor com foto (RG ou CNH) | - |
document_identification_back | string | DOCUMENT_KEY do PDF da parte de trás do documento de identificação da pessoa com foto (RG ou CNH) (enviado previamente). | 11 |
wedding_certificate | string | DOCUMENT_KEY do PDF do certificado de casamento da pessoa (enviado previamente). No caso de marital_status ser "single", o valor deste campo deve ser NULL. | 11 |
proof_of_residence * | string | DOCUMENT_KEY do PDF do comprovante de endereço do endereço enviado (enviado previamente). | 11 |
Objeto Address
Campo | Tipo | Descrição | Máx. Caract. |
---|---|---|---|
city * | string | Cidade do endereço | 100 |
state * | string | Estado do endereço (com dois caracteres maiúsculos) | 2 |
number * | string | Número do endereço | 10 |
street * | string | Rua do endereço | 100 |
complement * | string | Complemento do endereço (texto livre) | 100 |
postal_code * | string | CEP do endereço (http://www.buscacep.correios.com.br/sistemas/buscacep/) | 8 |
neighborhood * | string | Bairro do endereço | 100 |
Objeto Phone
Campo | Descrição | Exemplo | Máx. Caract. |
---|---|---|---|
number * | string | Número de telefone | 10 |
area_code * | string | Código DDD do telefone (https://ddd.guiamais.com.br/) | 2 |
country_code * | string | Código DDI do telefone (https://ddi.guiamais.com.br/) | 3 |
Objeto Disbursement Bank Account
Uma emissão de dívida deve conter as informações bancárias para desembolso, por padrão, uma conta de titularidade do devedor.
Campo | Tipo | Descrição | Máx. Caract. |
---|---|---|---|
name | string | Nome do titular da conta | 50 |
document_number | string | CPF do titular da conta | 11 |
bank_code * | string | Código COMPE da instituição financeira (https://www.bcb.gov.br/pom/spb/estatistica/port/ASTR003.pdf) | 3 |
branch_number * | string | Número da agência (não informar o dígito verificador da agência!) | 4 |
account_number * | string | Número da conta (sem o dígito verificador da conta!) | 10 |
account_digit * | string | Dígito verificador da conta (informar zero no lugar de letras) | 1 |
account_type | enum | Enumerador Account Type Tipo da conta | 1 |
Objeto Financial
O objeto financial descreve as informações financeiras da operação de crédito.
Campo | Tipo | Descrição | Máx. Caract. |
---|---|---|---|
amout | float | Valor de emissão/nominal da operação de crédito | - |
interest_type | object | Enumerador Interest Type - Método de amortização e forma de cálculo de juros | - |
credit_operation_type | object | Enumerador Credit Operation Type - Tipo do contrato de crédito | - |
annual_interest_rate | float | Taxa de juros pré-fixada expressa em decimal ao ano | - |
disbursement_date | date | Data do desembolso da operação | - |
interest_grace_period | int | Carência de juros (em meses) | - |
principal_grace_period | int | Período carência de principal | - |
number_of_installments | int | Número de parcelas da operação de crédito | - |
fine_configuration | object | Objeto Fine Configuration - Configuração de juros e multa por atraso | - |
Objeto Fine Configuration
No Objeto Fine Configuration são informados os valor de multa e juros por atraso da operação de crédito.
Campo | Tipo | Descrição | Máx. Caract. |
---|---|---|---|
contract_fine_rate | float | Percentual de multa por atraso | - |
interest_base | enum | Enumerador Interest Base - Base de cálculo de juros | - |
monthly_rate | float | Percentual de juros de atraso ao mês | - |
Objeto Rebates
Campo | Tipo | Descrição | Máx. Caract. |
---|---|---|---|
fee_type * | enum | Tipo da tarifa. | - |
amount_type * | object | Tipo do valor a ser cobrado. | - |
amount * | object | Valor da tarifa. Se o tipo da tarifa for percentual, o valor deverá ser entre 0 e 100. | - |
Response Body
Campo | Tipo | Descrição | Máx. Caract. |
---|---|---|---|
data[n].data | object | Objeto Data | - |
data[n].event_datetime | date | Momento da geração da operação de crédito | - |
data[n].key | string | DEBT-KEY - Chave única da operação de crédito dentro da QI | - |
data[n].status | string | Possívies Status de uma dívida | - |
data[n].type | string | debt | - |
Enumeradores
Enumerador Person Type
Enumerador | Descrição |
---|---|
legal | Pessoa juridica |
natural | Pesso física |
Enumerador Amount Type
Enumerador | Descrição |
---|---|
tac | Tarifa cobrada do tomador. |
spread | Tarifa cobrada do fundo adicionada ao preço de cessão da operação. |
Enumerador Account Type
Enumerador | Descrição |
---|---|
checking_account | Conta corrente |
deposit_account | Conta de depósito |
guaranteed_account | Conta de garantia |
investment_account | Conta de investimento |
payment_account | Conta de pagamento |
saving_account | Conta poupança |
salary_account | Conta salário |
Enumerador Interest Type
Enumerador | Descrição |
---|---|
pre_price_days | Método de amortização Price (parcelas iguais) com cálculo do juros pré-fixado ao dia |
pre_price | Método de amortização Price (parcelas iguais) com cálculo do juros pré-fixado em períodos fixos (30 dias) |
pre_sac | Método de amortização SAC (amortização constante) com cálculo do juros pré-fixado ao dia |
post_sac | Método de amortização SAC (amortização constante) com cálculo do juros baseado em uma taxa pré-fixada + indexador pós-fixado (cdi, ipca ou igpm) ao dia |
post_price | Método de amortização Price (parcelas iguais) com cálculo do juros baseado em uma taxa pré-fixada + indexador pós-fixado (cdi, ipca ou igpm) em períodos fixos (30 dias) |
post_price_days | Método de amortização Price (parcelas iguais) com cálculo do juros baseado em uma taxa pré-fixada + indexador pós-fixado (cdi, ipca ou igpm) 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 |
Enumerador Interest Base
Enumerador | Descrição |
---|---|
workdays | Base de cálculo de juros em dias úteis considerando um ano de 252 dias |
calendar_days | Base de cálculo de juros em dias corridos considerando um ano de 360 dias |
calendar_days_365 | Base de cálculo de juros em dias corridos considerando um ano de 365 dias |
Enumerador Fee Type
Cada tipo de fee deve ser previamente habilitado e configurado pela QI Tech
Enumerador | Descrição |
---|---|
tac | Tarifa de abertura de cadastro |
spread | Ágio cobrado no valor de aquisição da operação de crédito |
warranty_analysis | Tarifa de análise de garantias |
ted_fee | Tarifa de TED |
spread_ted_fee | Ágio da tarifa de TED cobrado no valor de aquisição da operação de crédito |