Emissão BNPL

Resumo

Este endpoint realiza a emissão da dívida e processa a assinatura do contrato via opt-in. O desembolso ocorre automaticamente logo após a 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,
        "credit_operation_type": "ccb",
        "interest_grace_period": 0,
        "number_of_installments": 2,
        "principal_grace_period": 0,
        "monthly_interest_rate": 0.052
    },
    "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": "company name",
            "ispb_number": "32402502",
            "account_digit": "5",
            "branch_number": "0001",
            "account_number": "7617846",
            "document_number": "32246162000281",
            "percentage_receivable": 100
        }
    ]
}

Detalhes do Request Body

Campo	Tipo	Descrição	Caracteres
borrower*	object	Objeto do tomador - O devedor 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
simplified	boolean	Se verdadeiro, utiliza o fluxo simplificado de emissão	-
additional_data*	object	Dados adicionais do contrato, incluindo assinaturas	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 técnicos da conta bancária onde os recursos serão depositados	Objeto Disbursement Bank Account

Objeto Borrower

Campo	Tipo	Descrição	Caracteres
name*	string	Nome completo do tomador	100
email	string	Endereço de e-mail do tomador	254
phone	object	Dados de telefone do tomador	Objeto Phone
is_pep*	boolean	Indicador de Pessoa Politicamente Exposta	5
address*	object	Endereço residencial do tomador	Objeto Address
role_type	string	Papel do tomador na operação (ex: "issuer")	10
birth_date*	date	Data de nascimento do tomador (Formato: "YYYY-MM-DD")	10
person_type*	string	Classificação da pessoa (natural ou legal)	7
attached_documents_list	array	Lista de documentos anexados (ex: selfie)	Objeto Attached Documents
individual_document_number*	string	CPF do tomador - somente números	11

Objeto Attached Documents

Campo	Tipo	Descrição	Caracteres
selfie	string	DOCUMENT_KEY do documento de selfie enviado via upload	UUID

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	9
area_code*	string	Código de área (DDD)	2
country_code*	string	Código internacional (ex: "055")	3

Objeto Financial

Campo	Tipo	Descrição	Caracteres
interest_type*	string	Método de amortização	20
disbursement_date*	string	Data de desembolso	10
fine_configuration*	object	Configuração de multa e mora	Objeto Fine Configuration
disbursed_amount*	float	Valor a ser desembolsado	15,2
credit_operation_type*	string	Tipo da operação de crédito (ex: "ccb")	10
interest_grace_period	integer	Período de carência de juros (em meses)	3
number_of_installments*	integer	Número de parcelas	3
principal_grace_period	integer	Período de carência do principal (em meses)	3
monthly_interest_rate*	float	Taxa de juros mensal	10,6

Objeto Fine Configuration

Campo	Tipo	Descrição	Caracteres
monthly_rate*	float	Taxa de mora mensal	10,6
interest_base*	string	Base de cálculo da mora (ex: "calendar_days")	20
contract_fine_rate*	float	Taxa de multa contratual	10,6

Objeto Disbursement Bank Account

Campo	Tipo	Descrição	Caracteres
name	string	Nome completo do titular da conta	50
ispb_number	string	Código ISPB da instituição financeira	8
account_digit*	string	Dígito verificador da conta (usar zero no lugar de letras)	1
branch_number*	string	Número da agência (sem dígito verificador)	4
account_number*	string	Número da conta (sem dígito verificador)	10
document_number	string	CPF/CNPJ do titular da conta	14
percentage_receivable*	float	Percentual do desembolso para esta conta	3

Objeto Additional Data

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)	Objeto Signature

Objeto Signature

Campo	Tipo	Descrição	Caracteres
signer*	object	Dados de identificação do assinante	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	Dados de 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 (ISO 8601: YYYY-MM-DDTHH:mm:ssZ)	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": "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

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
event_datetime	string	Data e hora do evento (ISO 8601)
data	object	Objeto Data — Dados da operação

Objeto Data

Campo	Tipo	Descrição
borrower	object	Objeto Borrower Response — Dados do tomador
contract	object	Objeto Contract Response — Dados do contrato
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	Objeto Contract Fees — Taxas QI Tech cobradas na operação
external_contract_fees	array	Objeto External Contract Fees — Taxas externas cobradas na operação
external_contract_fee_amount	float	Valor total das taxas externas
net_external_contract_fee_amount	float	Valor líquido das taxas externas após impostos
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	Objeto Interest Rate Response — Taxa de juros nominal
installments	array	Objeto Installments Response — Parcelas da operação
total_pre_fixed_amount	float	Valor total dos juros pré-fixados de todas as parcelas

Objeto Borrower Response

Campo	Tipo	Descrição
name	string	Nome completo do tomador
document_number	string	CPF do tomador
related_party_key	string	Identificador único do tomador na QI Tech (UUID)

Objeto Contract Response

Campo	Tipo	Descrição
document_key	string	Chave do documento do contrato
number	string	Número do contrato
urls	array	Lista de URLs do documento do contrato
signature_information	array	Objeto Signature Information — Informações de assinatura

Objeto Signature Information

Campo	Tipo	Descrição
signer_name	string	Nome completo do assinante
signer_document_number	string	CPF do assinante
signer_role	string	Papel do assinante na operação
signer_email	string	E-mail do assinante
signer_external_key	string	Chave externa do assinante
signature_url	string	URL do documento assinado

Objeto Contract Fees

Campo	Tipo	Descrição
fee_type	string	Tipo da taxa
fee_amount	float	Valor da taxa

Objeto External Contract Fees

Campo	Tipo	Descrição
fee_type	string	Tipo da taxa externa
fee_amount	float	Valor da taxa externa
tax_amount	float	Valor do imposto sobre a taxa
net_fee_amount	float	Valor líquido da taxa após impostos

Objeto Interest Rate Response

Campo	Tipo	Descrição
annual_rate	float	Taxa de juros anual
created_at	string	Timestamp de criação da taxa (ISO 8601)
daily_rate	float	Taxa de juros diária
interest_base	string	Base de cálculo dos juros
monthly_rate	float	Taxa de juros mensal

Objeto Installments Response

Campo	Tipo	Descrição
accrual_reference_date	string	Data de referência de cálculo da parcela
additional_costs	array	Lista de custos adicionais da parcela
advanced_paid_amount	float	Valor pago antecipadamente
bank_slip_key	string	Chave do boleto bancário
business_due_date	string	Data de vencimento ajustada para o próximo dia útil
calendar_days	integer	Dias corridos entre parcelas
digitable_line	string	Linha digitável do boleto
due_date	string	Data de vencimento da parcela
due_interest	float	Valor de juros remanescente na data de vencimento antes do pagamento
due_principal	float	Saldo devedor no momento da parcela
fine_amount	float	Valor de multa aplicado
has_interest	boolean	Indicador de incidência de juros na parcela
installment_history	array	Histórico de eventos da parcela
installment_key	string	Identificador único da parcela (UUID)
installment_number	integer	Número da parcela
installment_payment	array	Lista de pagamentos realizados na parcela
installment_status	string	Status atual da parcela
installment_type	string	Tipo da parcela — sempre "principal"
original_due_principal	float	Saldo devedor original no momento da emissão
original_pre_fixed_amount	float	Valor original dos juros pré-fixados na emissão
original_principal_amortization_amount	float	Valor original de amortização do principal na emissão
original_total_amount	float	Valor total original da parcela na emissão
paid_amount	float	Valor já pago na parcela
paid_at	string	Data do pagamento
post_fixed_amount	float	Valor dos juros pós-fixados — sempre 0
pre_fixed_amount	float	Valor atual dos juros pré-fixados
principal_amortization_amount	float	Valor de amortização do principal
qr_code_key	string	Chave do QR Code PIX
qr_code_url	string	URL do QR Code PIX
renegotiation_proposal_key	string	Chave da proposta de renegociação, se aplicável
tax_amount	float	Valor do IOF na parcela
total_accrual_amount	float	Valor total de juros acumulados
total_amount	float	Valor total da parcela
total_paid_amount	float	Valor total pago na parcela até o momento
workdays	integer	Dias úteis entre parcelas

Resumo​

Request​

Detalhes do Request Body​

Objeto Borrower​

Objeto Attached Documents​

Objeto Address​

Objeto Phone​

Objeto Financial​

Objeto Fine Configuration​

Objeto Disbursement Bank Account​

Objeto Additional Data​

Objeto Contract​

Objeto Signature​

Objeto Signer​

Objeto Signature Details​

Objeto Signature File​

Response​

Detalhes do Response Body​

Objeto Data​

Objeto Borrower Response​

Objeto Contract Response​

Objeto Signature Information​

Objeto Contract Fees​

Objeto External Contract Fees​

Objeto Interest Rate Response​

Objeto Installments Response​