Criação - Refinanciamento BNPL

Resumo

A criação de um refinanciamento utiliza o mesmo endpoint e payload da emissão (/signed_debt), com a adição do objeto refinanced_credit_operations contendo a lista de operações que serão quitadas. O somatório do valor presente dos contratos anteriores será retido e apenas o excedente será liberado na conta do tomador.

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"
                        }
                    }
                }
            ]
        }
    },
    "refinanced_credit_operations": [
        {
            "operation_key": "d897f8fa-30d0-4a25-b7e5-5daa61c7480d"
        },
        {
            "operation_key": "f8f0d7a9-4f0c-426c-ac50-33a09d4a0d78"
        }
    ],
    "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
        }
    ]
}

Atenção

O payload é idêntico ao da emissão (/signed_debt), com a adição do campo refinanced_credit_operations contendo a lista de operações a serem quitadas.

Detalhes do Request Body

O payload contém todos os campos da Emissão BNPL, com a adição de:

Campo	Tipo	Descrição	Caracteres
refinanced_credit_operations*	array	Lista de operações a serem refinanciadas	Objeto Refinanced Credit Operations

Todos os demais campos seguem a mesma especificação da emissão:

• Objeto Borrower
• Objeto Financial
• Objeto Additional Data
• Objeto Disbursement Bank Account

Objeto Refinanced Credit Operations

Campo	Tipo	Descrição	Caracteres
operation_key*	string	Chave da operação a ser refinanciada (DEBT-KEY da operação original)	UUID

Response

A resposta segue o mesmo formato da emissão de dívida, retornando a DEBT-KEY do novo contrato.

STATUS

201

Observação

• O valor presente das operações listadas em refinanced_credit_operations será automaticamente retido para quitação dos contratos anteriores
• Apenas o excedente (diferença entre o valor desembolsado e o valor retido) será liberado na conta do tomador
• Após a criação, os contratos refinanciados serão automaticamente liquidados
• Os webhooks de emissão (assinatura, desembolso, cancelamento) seguem o mesmo padrão descrito na seção de Webhooks da Emissão