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-03-26",
        "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": "DWF1761292996",
            "signatures": [
                {
                    "signer": {
                        "name": "Dante Ferrarini",
                        "email": "",
                        "phone": {
                            "number": "185633631",
                            "area_code": "15",
                            "country_code": "086"
                        },
                        "document_number": "31057466093"
                    },
                    "signature": {
                        "timestamp": "2026-01-28T06:36:35Z",
                        "ip_address": "192.168.1.1",
                        "signature_file": {
                            "file_url": "https://qitech.com.br/signature.pdf",
                            "file_type": "pdf"
                        }
                    }
                }
            ]
        }
    },
    "requester_identifier_key": "d2106ef5-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	5
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_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
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
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
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": "75f95e0a-48b6-451f-b12c-7db9aa514990",
    "status": "issued",
    "event_datetime": "2026-04-02T16:04:35Z",
    "data": {
        "borrower": {
            "name": "Dante Ferrarini",
            "document_number": "31057466093",
            "related_party_key": "69f51ee3-1aac-4c29-9d43-e2c989a680a3"
        },
        "contract": {
            "document_key": null,
            "number": "DWF1761292996",
            "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": "d2106ef5-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.66,
        "assignment_amount": 1010.68,
        "cet": "5,8100%",
        "annual_cet": "96,9634%",
        "number_of_installments": 2,
        "base_iof": 3.83,
        "additional_iof": 3.83,
        "total_iof": 7.66,
        "ipoc_code": "324025020203131057466093DWF1761292996",
        "prefixed_interest_rate": {
            "annual_rate": 0.8373372409,
            "created_at": "2026-04-02T16:04:31",
            "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-04-27",
                "calendar_days": 31,
                "digitable_line": null,
                "due_date": "2026-04-26",
                "due_interest": 0,
                "due_principal": 1007.66,
                "fine_amount": null,
                "has_interest": true,
                "installment_history": [],
                "installment_key": "b88734f5-d6b6-40f0-b87d-de5be7ccad61",
                "installment_number": 1,
                "installment_payment": [],
                "installment_status": "created",
                "installment_type": "principal",
                "original_due_principal": 1007.66,
                "original_pre_fixed_amount": 54.19129083,
                "original_principal_amortization_amount": 490.18870917,
                "original_total_amount": 544.38,
                "paid_amount": 0,
                "paid_at": null,
                "post_fixed_amount": 0,
                "pre_fixed_amount": 54.19129083,
                "principal_amortization_amount": 490.18870917,
                "qr_code_key": null,
                "qr_code_url": null,
                "renegotiation_proposal_key": null,
                "tax_amount": 1.2460597,
                "total_accrual_amount": null,
                "total_amount": 544.38,
                "total_paid_amount": 0,
                "workdays": 19
            },
            {
                "accrual_reference_date": null,
                "additional_costs": [],
                "advanced_paid_amount": 0,
                "bank_slip_key": null,
                "business_due_date": "2026-05-26",
                "calendar_days": 30,
                "digitable_line": null,
                "due_date": "2026-05-26",
                "due_interest": 0,
                "due_principal": 517.47129083,
                "fine_amount": null,
                "has_interest": true,
                "installment_history": [],
                "installment_key": "0157a4cf-9c16-4efb-8a96-5c5e5f2f7956",
                "installment_number": 2,
                "installment_payment": [],
                "installment_status": "created",
                "installment_type": "principal",
                "original_due_principal": 517.47129083,
                "original_pre_fixed_amount": 26.90870917,
                "original_principal_amortization_amount": 517.47129083,
                "original_total_amount": 544.38,
                "paid_amount": 0,
                "paid_at": null,
                "post_fixed_amount": 0,
                "pre_fixed_amount": 26.90870917,
                "principal_amortization_amount": 517.47129083,
                "qr_code_key": null,
                "qr_code_url": null,
                "renegotiation_proposal_key": null,
                "tax_amount": 2.5883914,
                "total_accrual_amount": null,
                "total_amount": 544.38,
                "total_paid_amount": 0,
                "workdays": 21
            }
        ],
        "total_pre_fixed_amount": 81.1
    }
}

Atenção

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

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 Signature​

Response​