跳到主要内容

Emissão com Assinatura Imediata (/signed_debt)

Este endpoint realiza a emissão da dívida 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 pré-cadastro; basta fornecer os dados do tomador durante a requisição de emissão.

Request​

ENDPOINT
/signed_debt
MÉTODO
POST
Testar no Playground
Request Body
{
    "borrower": {
        "name": "Dante Ferrarini",
        "email": "",
        "phone": {
            "number": "185633631",
            "area_code": "15",
            "country_code": "086"
        },
        "is_pep": false,
        "address": {
            "city": "São Paulo",
            "state": "SP",
            "number": "",
            "street": "Rua Gilberto Sabino",
            "postal_code": "05425020",
            "neighborhood": "Pinheiros",
            "complement": ""
        },
        "role_type": "issuer",
        "birth_date": "1993-09-10",
        "person_type": "natural",
        "attached_documents_list": [
            {
                "selfie": "250e7e95-57c8-40bd-a0cd-0be8eb172916"
            }
        ],
        "individual_document_number": "31057466093"
    },
    "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": 1000,
        "monthly_interest_rate": 0.052,
        "credit_operation_type": "ccb",
        "interest_grace_period": 0,
        "number_of_installments": 2,
        "principal_grace_period": 0
    },
    "simplified": true,
    "additional_data": {
        "contract": {
            "contract_number": "DWF1761222116",
            "signatures": [
                {
                    "signer": {
                        "name": "Dante Ferrarini",
                        "email": "",
                        "phone": {
                            "number": "185633631",
                            "area_code": "15",
                            "country_code": "086"
                        },
                        "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": [
        {
            "name": "Dante Ferrarini",
            "ispb_number": "32402502",
            "account_digit": "5",
            "branch_number": "0001",
            "account_number": "7617846",
            "document_number": "31057466093",
            "percentage_receivable": 100
        }
    ]
}

Detalhes do Request Body​

CampoTipoDescriçãoCaracteres
borrower*objectObjeto do tomador - O devedor da operação de créditoObjeto Borrower
financial*objectContém todos os detalhes financeiros e parâmetros de cálculo da operaçãoObjeto Financial
simplifiedbooleanSe verdadeiro, utiliza o fluxo simplificado de emissão-
additional_data*objectDados adicionais do contrato, incluindo assinaturasObjeto Additional Data
requester_identifier_keystringChave identificadora do solicitanteUUID
purchaser_document_number*stringCNPJ do cessionário – O comprador da operação de crédito (FIDC)14
disbursement_bank_accounts*arrayDados da conta bancária do tomador para recebimento do desembolsoObjeto Disbursement Bank Account

Objeto Borrower​

CampoTipoDescriçãoCaracteres
name*stringNome completo do tomador100
emailstringEndereço de e-mail do tomador254
phoneobjectDados de telefone do tomadorObjeto Phone
is_pep*booleanIndicador de Pessoa Politicamente Exposta5
address*objectEndereço residencial do tomadorObjeto Address
role_typestringPapel do tomador na operação (ex: "issuer")10
birth_date*dateData de nascimento do tomador (Formato: "YYYY-MM-DD")10
person_type*stringClassificação da pessoa (natural ou legal)7
attached_documents_listarrayLista de documentos anexados (ex: selfie)Objeto Attached Documents
individual_document_number*stringCPF do tomador - somente números11

Objeto Attached Documents​

CampoTipoDescriçãoCaracteres
selfiestringDOCUMENT_KEY do documento de selfie enviado via uploadUUID

Objeto Address​

CampoTipoDescriçãoCaracteres
city*stringNome da cidade100
state*stringSigla do estado (duas letras maiúsculas)2
numberstringNúmero do logradouro10
street*stringNome do logradouro100
complementstringComplemento do endereço (texto livre)100
postal_code*stringCEP - somente números8
neighborhood*stringNome do bairro100

Objeto Phone​

CampoTipoDescriçãoCaracteres
number*stringNúmero do telefone9
area_code*stringCódigo de área (DDD)2
country_code*stringCódigo internacional (ex: "055")3

Objeto Financial​

Formas de definir o valor da operação

É possível definir o valor da operação por meio das seguintes combinações mutuamente exclusivas (informe uma e somente uma das chaves de valor, junto com os demais campos obrigatórios):

  • disbursed_amount + monthly_interest_rate + number_of_installments: informe o valor líquido a ser desembolsado, a taxa de juros e o número de parcelas — o sistema calcula o valor de cada parcela.
  • amount + monthly_interest_rate + number_of_installments: informe o valor bruto (com IOF) da operação — o sistema calcula o desembolso líquido e o valor de cada parcela.
  • final_disbursement_amount + monthly_interest_rate + number_of_installments: informe o valor final que deve chegar ao destinatário e o sistema infla o issue_amount para cobrir o IOF.
  • installment_face_value + number_of_installments + (disbursed_amount ou amount): informe o valor desejado por parcela; quando essa combinação é usada sem monthly_interest_rate, o sistema assume taxa zero.
  • desired_installments: informe um array com a data e o valor total de cada parcela individualmente — o sistema calcula o valor de desembolso.
  • disbursed_amount + due_dates: informe o valor de desembolso e um array com as datas de vencimento — o sistema calcula os valores das parcelas para a agenda irregular informada.
CampoTipoDescriçãoCaracteres
interest_type*stringMétodo de amortização20
disbursement_date*stringData de desembolso10
first_due_datestringData de vencimento da primeira parcela (YYYY-MM-DD)10
limit_days_to_disburseintegerQuantidade de dias após disbursement_date em que o desembolso ainda pode ocorrer3
fine_configuration*objectConfiguração de multa e moraObjeto Fine Configuration
monthly_interest_ratefloatTaxa de juros mensal. Opcional quando installment_face_value é utilizado10,6
annual_interest_ratefloatTaxa de juros anual (alternativa a monthly_interest_rate)10,6
daily_interest_ratefloatTaxa de juros diária (alternativa a monthly_interest_rate)10,6
disbursed_amountfloatValor líquido a ser desembolsado15,2
amountfloatValor bruto da operação (issue_amount) — inclui IOF15,2
final_disbursement_amountfloatValor final a chegar no destinatário — sistema infla o issue_amount para cobrir IOF15,2
installment_face_valuefloatValor desejado de cada parcela15,2
number_of_installmentsintegerNúmero de parcelas3
desired_installmentsarrayArray de parcelas com data e valor definidos individualmenteObjeto Desired Installments
due_datesarrayLista de datas de vencimento (YYYY-MM-DD). Utilizado com disbursed_amount para agenda de parcelas irregular-
total_ioffloatValor total do IOF — quando omitido, o sistema calcula automaticamente15,2
credit_operation_type*stringTipo da operação de crédito (ex: "ccb")10
interest_grace_periodintegerPeríodo de carência de juros (em meses)3
principal_grace_periodintegerPeríodo de carência do principal (em meses)3

Objeto Desired Installments​

CampoTipoDescriçãoCaracteres
due_date*stringData de vencimento da parcela (YYYY-MM-DD)10
total_amount*floatValor total da parcela15,2

Objeto Fine Configuration​

CampoTipoDescriçãoCaracteres
monthly_rate*floatTaxa de mora mensal10,6
interest_base*stringBase de cálculo da mora (ex: "calendar_days")20
contract_fine_rate*floatTaxa de multa contratual10,6

Objeto Disbursement Bank Account​

CampoTipoDescriçãoCaracteres
namestringNome completo do titular da conta destino100
document_numberstringCPF ou CNPJ do titular da conta destino11 ou 14
transfer_methodstringMétodo de transferência. Valores: pix, ted (default: pix)3
pix_transfer_typestringSubtipo da transferência Pix. Valores: manual, key, qrcode6
ispb_numberstringCódigo ISPB da instituição financeira8
bank_codestringCódigo COMPE da instituição financeira (alternativa a ispb_number)3
branch_numberstringNúmero da agência (sem dígito verificador)4
account_numberstringNúmero da conta (sem dígito verificador)19
account_digitstringDígito verificador da conta (usar zero no lugar de letras)1
account_typestringTipo da conta destino. Valores: checking_account, saving_account, salary_account, payment_account, deposit_account, guaranteed_account, investment_account20
pix_keystringChave Pix do destinatário — obrigatório quando pix_transfer_type = key-
qr_code_keystringChave UUID de um QR Code Pix já registrado — obrigatório quando pix_transfer_type = qrcode36
qr_code_urlstringString EMV (copia-e-cola) do QR Code Pix — alternativa a qr_code_key250
digitable_linestringLinha digitável de boleto bancário — usado para desembolso por boleto47-48
end_to_end_idstringIdentificador end-to-end do Pix (preenchido na resposta)32
percentage_receivablefloatPercentual do desembolso destinado a esta conta. Obrigatório quando amount_receivable não é informado3
amount_receivablefloatValor fixo destinado a esta conta. Obrigatório quando percentage_receivable não é informado15,2
Modos de desembolso suportados

A combinação de campos depende do transfer_method e do pix_transfer_type:

  • Conta interna QI Tech ou TED: bank_code/ispb_number + branch_number + account_number + account_digit + document_number + name + percentage_receivable.
  • Pix manual: pix_transfer_type = manual + dados de conta (igual ao TED).
  • Pix por chave: pix_transfer_type = key + pix_key.
  • Pix por QR Code (registrado): pix_transfer_type = qrcode + qr_code_key.
  • Pix por QR Code (copia-e-cola): qr_code_url + transfer_method = pix.
  • Pagamento de boleto: digitable_line + amount_receivable.

Objeto Additional Data​

CampoTipoDescriçãoCaracteres
contract*objectDados do contratoObjeto Contract

Objeto Contract​

CampoTipoDescriçãoCaracteres
contract_number*stringNúmero identificador único do contrato20
signatures*arrayLista de objetos de evidência de assinatura digital (Opt-in)Objeto Signature

Objeto Signature​

CampoTipoDescriçãoCaracteres
signer*objectDados de identificação do assinanteObjeto Signer
signature*objectDados de evidência da assinatura digitalObjeto Signature Details

Objeto Signer​

CampoTipoDescriçãoCaracteres
name*stringNome completo do assinante255
document_number*stringCPF do assinante11
emailstringE-mail do assinante100
phoneobjectDados de telefone do assinanteObjeto Phone

Objeto Signature Details​

CampoTipoDescriçãoCaracteres
ip_address*stringEndereço IP utilizado na assinatura45
timestamp*stringData e hora da assinatura (ISO 8601: YYYY-MM-DDTHH:mm:ssZ)24
signature_file*objectArquivo da assinatura digitalObjeto Signature File

Objeto Signature File​

CampoTipoDescriçãoCaracteres
file_url*stringLink direto para o documento do contrato assinado (PDF)2048
file_type*stringFormato 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": "Dante Ferrarini",
            "document_number": "31057466093",
            "related_party_key": "24fac77e-7782-4f72-b31a-daee288e34ed"
        },
        "contract": {
            "document_key": null,
            "number": "DWF1761222116",
            "urls": [],
            "signature_information": [
                {
                    "signer_name": "Dante Ferrarini",
                    "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": 3.02
            }
        ],
        "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": 3.02,
        "issue_amount": 1007.62,
        "assignment_amount": 1010.64,
        "cet": "5,8200%",
        "annual_cet": "97,0501%",
        "number_of_installments": 2,
        "base_iof": 3.79,
        "additional_iof": 3.83,
        "total_iof": 7.62,
        "ipoc_code": "324025020203131057466093DWF1761222116",
        "prefixed_interest_rate": {
            "annual_rate": 0.8373372409,
            "created_at": "2026-04-07T23:59:22",
            "daily_rate": 0.0016911989,
            "interest_base": "calendar_days",
            "monthly_rate": 0.052
        },
        "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": 1007.62,
                "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",
                "original_due_principal": 1007.62,
                "original_pre_fixed_amount": 52.3996159,
                "original_principal_amortization_amount": 491.4903841,
                "original_total_amount": 543.89,
                "paid_amount": 0,
                "paid_at": null,
                "post_fixed_amount": 0,
                "pre_fixed_amount": 52.3996159,
                "principal_amortization_amount": 491.4903841,
                "qr_code_key": null,
                "qr_code_url": null,
                "renegotiation_proposal_key": null,
                "tax_amount": 1.20906634,
                "total_accrual_amount": null,
                "total_amount": 543.89,
                "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,
                "due_principal": 516.1296159,
                "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",
                "original_due_principal": 516.1296159,
                "original_pre_fixed_amount": 27.7603841,
                "original_principal_amortization_amount": 516.1296159,
                "original_total_amount": 543.89,
                "paid_amount": 0,
                "paid_at": null,
                "post_fixed_amount": 0,
                "pre_fixed_amount": 27.7603841,
                "principal_amortization_amount": 516.1296159,
                "qr_code_key": null,
                "qr_code_url": null,
                "renegotiation_proposal_key": null,
                "tax_amount": 2.58168034,
                "total_accrual_amount": null,
                "total_amount": 543.89,
                "total_paid_amount": 0,
                "workdays": 20
            }
        ],
        "total_pre_fixed_amount": 80.16
    }
}
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​

CampoTipoDescrição
webhook_typestringIdentificador do tipo de evento
keystringDEBT-KEY — identificador único da dívida na QI SCD (UUID)
statusstringStatus atual da dívida
event_datetimestringData e hora do evento (ISO 8601)
dataobjectObjeto Data — Dados da operação

Objeto Data​

CampoTipoDescrição
borrowerobjectObjeto Borrower Response — Dados do tomador
contractobjectObjeto Contract Response — Dados do contrato
requester_identifier_keystringChave identificadora do solicitante (UUID)
iof_charge_methodstringMétodo de cobrança do IOF — sempre "financed"
collateralsarrayLista de garantias da operação
contract_feesarrayObjeto Contract Fees — Taxas QI Tech cobradas na operação
external_contract_feesarrayObjeto External Contract Fees — Taxas externas cobradas na operação
external_contract_fee_amountfloatValor total das taxas externas
net_external_contract_fee_amountfloatValor líquido das taxas externas após impostos
contract_fee_amountfloatValor total das taxas QI Tech
issue_amountfloatValor nominal da operação de crédito
assignment_amountfloatValor de cessão da operação de crédito
cetstringCusto Efetivo Total mensal
annual_cetstringCusto Efetivo Total anual
number_of_installmentsintegerNúmero de parcelas
base_ioffloatValor base do IOF
additional_ioffloatValor adicional do IOF
total_ioffloatValor total do IOF
ipoc_codestringCódigo de registro de crédito brasileiro gerado pela QI Tech
prefixed_interest_rateobjectObjeto Interest Rate Response — Taxa de juros nominal
installmentsarrayObjeto Installments Response — Parcelas da operação
disbursement_accountarrayObjeto Disbursement Account Response — Dados das contas de desembolso (PIX por chave ou QR Code)
total_pre_fixed_amountfloatValor total dos juros pré-fixados de todas as parcelas

Objeto Disbursement Account Response​

Retornado apenas quando o desembolso é via chave PIX (pix_key) ou QR Code (qr_code_key / qr_code_url). Em desembolsos por TED, manual, PIX manual ou boleto, o campo disbursement_account não aparece na resposta.

CampoTipoDescrição
namestringNome do titular da conta destino (sempre por extenso).
document_numberstringCPF ou CNPJ do titular da conta destino. CPF (11 dígitos) vem mascarado como ***XXXXXX** quando a conta foi resolvida via QR Code; CNPJ (14 dígitos) vem íntegro. Em fluxo pix_key consultado no DICT, retorna sem máscara.
pix_keystringChave PIX do destinatário (input do cliente ou extraída do QR Code decodificado).
qr_code_keystringUUID do QR Code PIX, quando o desembolso foi por QR registrado.
qr_code_urlstringEMV "copia-e-cola" do QR Code, quando o desembolso foi por QR copia-e-cola.
account_branchstringAgência da conta destino (preenchida em fluxos pix_key consultado no DICT).
account_numberstringNúmero da conta destino.
account_digitstringDígito verificador da conta destino.
account_typestringTipo da conta destino.
ispbstringCódigo ISPB da instituição financeira destino.
percentage_receivablefloatPercentual do desembolso destinado a esta conta.
amount_receivablefloatValor fixo destinado a esta conta.
end_to_end_idstringIdentificador end-to-end do PIX, atribuído após o decode/consulta.
Comportamento condicional

O campo disbursement_account é estritamente populado com name e document_number quando o fluxo é por PIX (chave ou QR Code). Os demais campos seguem o tipo do desembolso: por exemplo, em qr_code_url os campos account_branch/account_number/account_digit vêm null porque o EMV dinâmico não os carrega.

Objeto Borrower Response​

CampoTipoDescrição
namestringNome completo do tomador
document_numberstringCPF do tomador
related_party_keystringIdentificador único do tomador na QI Tech (UUID)

Objeto Contract Response​

CampoTipoDescrição
document_keystringChave do documento do contrato
numberstringNúmero do contrato
urlsarrayLista de URLs do documento do contrato
signature_informationarrayObjeto Signature Information — Informações de assinatura

Objeto Signature Information​

CampoTipoDescrição
signer_namestringNome completo do assinante
signer_document_numberstringCPF do assinante
signer_rolestringPapel do assinante na operação
signer_emailstringE-mail do assinante
signer_external_keystringChave externa do assinante
signature_urlstringURL do documento assinado

Objeto Contract Fees​

CampoTipoDescrição
fee_typestringTipo da taxa
fee_amountfloatValor da taxa

Objeto External Contract Fees​

CampoTipoDescrição
fee_typestringTipo da taxa externa
fee_amountfloatValor da taxa externa
tax_amountfloatValor do imposto sobre a taxa
net_fee_amountfloatValor líquido da taxa após impostos

Objeto Interest Rate Response​

CampoTipoDescrição
annual_ratefloatTaxa de juros anual
created_atstringTimestamp de criação da taxa (ISO 8601)
daily_ratefloatTaxa de juros diária
interest_basestringBase de cálculo dos juros
monthly_ratefloatTaxa de juros mensal

Objeto Installments Response​

CampoTipoDescrição
accrual_reference_datestringData de referência de cálculo da parcela
additional_costsarrayLista de custos adicionais da parcela
advanced_paid_amountfloatValor pago antecipadamente
bank_slip_keystringChave do boleto bancário
business_due_datestringData de vencimento ajustada para o próximo dia útil
calendar_daysintegerDias corridos entre parcelas
digitable_linestringLinha digitável do boleto
due_datestringData de vencimento da parcela
due_interestfloatValor de juros remanescente na data de vencimento antes do pagamento
due_principalfloatSaldo devedor no momento da parcela
fine_amountfloatValor de multa aplicado
has_interestbooleanIndicador de incidência de juros na parcela
installment_historyarrayHistórico de eventos da parcela
installment_keystringIdentificador único da parcela (UUID)
installment_numberintegerNúmero da parcela
installment_paymentarrayLista de pagamentos realizados na parcela
installment_statusstringStatus atual da parcela
installment_typestringTipo da parcela — sempre "principal"
original_due_principalfloatSaldo devedor original no momento da emissão
original_pre_fixed_amountfloatValor original dos juros pré-fixados na emissão
original_principal_amortization_amountfloatValor original de amortização do principal na emissão
original_total_amountfloatValor total original da parcela na emissão
paid_amountfloatValor já pago na parcela
paid_atstringData do pagamento
post_fixed_amountfloatValor dos juros pós-fixados — sempre 0
pre_fixed_amountfloatValor atual dos juros pré-fixados
principal_amortization_amountfloatValor de amortização do principal
qr_code_keystringChave do QR Code PIX
qr_code_urlstringURL do QR Code PIX
renegotiation_proposal_keystringChave da proposta de renegociação, se aplicável
tax_amountfloatValor do IOF na parcela
total_accrual_amountfloatValor total de juros acumulados
total_amountfloatValor total da parcela
total_paid_amountfloatValor total pago na parcela até o momento
workdaysintegerDias úteis entre parcelas