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.

Atenção!

A QI Tech oferece uma solução de Onboarding 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

ENDPOINT

/debt

MÉTODO

POST

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",
    "credit_agent": {
        "document_number": "87237271016",
        "name": "Agente de credito"
    }
}

Atenção

O objeto credit_agent representa o agente de crédito, por vezes conhecido como pastinha, responsável pela originação desta dívida. Este campo é obrigatório para a emissão de dívidas de consignados.

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.

STATUS

200

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
email	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, CNH ou CIN)	-
document_identification_back	string	DOCUMENT_KEY do PDF da parte de trás do documento de identificação da pessoa com foto (RG, CNH ou CIN) (enviado previamente).	11
document_identification_type	enum	Enumerador Document Identification Type — Tipo do documento de identificação enviado.	-
document_identification_number	string	Número do documento de identificação. Quando `document_identification_type` for `cin`, este campo deve ser igual ao CPF (`individual_document_number`).	16
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

Enumerador Document Identification Type

Valor	Descrição
`rg`	RG — Registro Geral
`rne`	RNE — Registro Nacional de Estrangeiros
`cnh`	CNH — Carteira Nacional de Habilitação
`ctps`	CTPS — Carteira de Trabalho e Previdência Social
`class_document`	Documento de classe profissional (CRM, OAB, CRC, etc.)
`passport`	Passaporte
`other`	Outro
`cin`	CIN — Carteira de Identidade Nacional. O campo `document_identification_number` deve ser igual ao CPF do portador.

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
spread_merchant	Ágio destinado à remuneração do lojista, cobrado no valor de aquisição (cessão) da operação de crédito
tac_assignment_discount	Parcela da tarifa de abertura de cadastro (TAC) destinada ao fundo (cessionário), cobrada do tomador; compõe o valor de emissão da operação

Request​

Response​

Definições​

Objeto Request Body​

Objeto Borrower​

Enumerador Document Identification Type​

Objeto Address​

Objeto Phone​

Objeto Disbursement Bank Account​

Objeto Financial​

Objeto Fine Configuration​

Objeto Rebates​

Response Body​