Proposta de Renegociação em Lote - BNPL
Resumo
Após simular os valores, é possível criar uma proposta de renegociação em lote para múltiplas operações BNPL. A proposta gera um único meio de pagamento (boleto e/ou Pix) que cobre todas as operações incluídas no lote.
Para o tipo de amortização present_amount, cada parcela informada em operations[].installments[] deve incluir paid_amount (valor pago/alocado naquela parcela) e discount_amount (desconto em R$ aplicado na parcela), além de installment_key.
A renegociação em lote só pode ser criada com operações de um mesmo emitente e mesma chave de integração. Há um limite de 50 operações para cada renegociação em lote.
Request
Os campos discount_amount e discount_percentage NÃO podem ser enviados juntos no mesmo payload (nível raiz).
Na raiz do body, discount_amount e discount_percentage são alternativas para desconto global sobre o valor presente. Já os campos paid_amount e discount_amount dentro de cada objeto em operations[].installments[] definem a composição por parcela quando amortization_type é present_amount (são obrigatórios nesse modo e não conflitam com a regra da raiz).
Request Body
{
"amortization_type": "present_amount",
"reference_date": "2026-04-08",
"proposal_due_date": "2026-04-15",
"discount_percentage": 0.0,
"payment_type": "pix",
"request_control_key": "94b31045-c8e7-45be-a88d-2ae25c5df5db",
"operations": [
{
"debt_key": "1baea8a0-0fca-4f7c-8857-a227d4da72f8",
"installments": [
{
"installment_key": "ca5741c7-99a2-42e7-92a1-9328a36e4e88",
"paid_amount": 500,
"discount_amount": 50
}
]
},
{
"debt_key": "2cbfb9b1-1fdb-5f8d-9967-b338e5eb83f9",
"installments": [
{
"installment_key": "2ef25ed8-7124-44f5-9e3d-1d1a7196166e",
"paid_amount": 150,
"discount_amount": 10
}
]
}
]
}
Body Params
| Campo | Tipo | Descrição | Caracteres |
|---|---|---|---|
amortization_type* | string | Tipo de amortização | Enumeradores Amortization Type |
reference_date* | string | Data de referência para cálculo do valor presente (D+1) | 10 |
proposal_due_date* | string | Data de vencimento da proposta de renegociação | 10 |
payment_type* | string | Tipo de pagamento | Enumeradores Payment Type |
request_control_key | string | Chave de controle para rastreamento e identificação única (opcional) | UUID |
discount_percentage | float | Percentual de desconto sobre o valor presente | 10 |
discount_amount | float | Valor de desconto sobre o valor presente | 10 |
operations* | array | Lista de operações a serem renegociadas | Objeto Operations |
Objeto Operations
| Campo | Tipo | Descrição | Caracteres |
|---|---|---|---|
debt_key* | string | Chave única da operação de crédito (DEBT-KEY) | UUID |
installments* | array | Parcelas a serem renegociadas | Objeto Installments |
Objeto Installments
| Campo | Tipo | Descrição | Caracteres |
|---|---|---|---|
installment_key* | string | Chave da parcela a ser renegociada | UUID |
paid_amount | float | Valor pago (ou alocado) na parcela, em reais (R$). Obrigatório quando amortization_type é present_amount. | 15,2 |
discount_amount | float | Valor de desconto em reais (R$) aplicado na parcela. Obrigatório quando amortization_type é present_amount (use 0 se não houver desconto). Para outros tipos de amortização, permanece opcional por parcela. | 15,2 |
Enumeradores Payment Type
| Campo | Descrição |
|---|---|
bank_slip | Pagamento via boleto bancário (gera boleto e Pix) |
pix | Pagamento via Pix (gera apenas Pix) |
internal | Pagamento via transferência interna (processamento automático) |
manual | Pagamento feito de forma manual (não gera forma de pagamento) |
Enumeradores Amortization Type
| Campo | Descrição |
|---|---|
| present_amount | Renegociação com composição por valor presente por parcela. Em cada item de installments[] é obrigatório informar installment_key, paid_amount e discount_amount. |
| installment_payment | Renegociação para pagamento de parcelas específicas. Requer installment_key de cada parcela. |
| overdue_installment_payment | Renegociação direcionada para pagamento de parcelas em atraso. Requer installment_key de cada parcela. |
Response
Response Body
{
"batch_proposal_key": "ff5ad6dd-2087-4850-a3e8-b37634448b4e",
"discount_percentage": 0,
"discount_amount": 0,
"amortization_type": "present_amount",
"payment_amount": 517.88,
"requester_name": "Dante Ltda",
"requester_key": "78287247-947d-4730-9bd1-7efb068175b6",
"issuer_name": "Dante Ferrarini",
"reference_date": "2026-04-08",
"issuer_document_number": "31057466093",
"batch_proposal_status": "pending_payment",
"proposal_due_date": "2026-04-15",
"payment_type": "pix",
"request_control_key": "94b31045-c8e7-45be-a88d-2ae25c5df5db",
"origin_key": null,
"operations": [
{
"requester_key": "78287247-947d-4730-9bd1-7efb068175b6",
"contract_number": "DWF1761222116",
"payment_amount": 517.88,
"discount_amount": 0,
"origin_key": null,
"affected_installments": [
{
"installment_key": "1dea396f-beb1-4df3-9822-35800b4c095a",
"due_date": "2026-05-07",
"principal_amount": 491.49,
"interest_amount": 52.4,
"fine_amount": 0,
"total_amount": 543.89,
"present_amount": 517.88,
"paid_amount": 517.88,
"principal_amortization_payment_amount": 491.49,
"prefixed_interest_payment_amount": 26.39,
"fine_payment_amount": 0,
"discount_amount": 0
}
],
"remaining_installments": [
{
"installment_key": "370e73d1-55d8-431e-9b22-d08fb8297999",
"due_date": "2026-06-07",
"principal_amount": 516.13,
"interest_amount": 27.76,
"fine_amount": 0,
"total_amount": 543.89
}
],
"debt_key": "72760166-4ddf-41fb-8a8c-605f8f4fc35c"
}
],
"payment": {
"digitable_line": null,
"qr_code_url": "00020126930014br.gov.bcb.pix2571qrcode-h.sandbox.qitech.app/bacen/cobv/acaeb341e1264cde99b93e247e12b3725204000053039865802BR5925QISOCIEDADEDECREDITODIRET6008SaoPaulo61080145200062070503***63043AD0",
"qr_code_key": "acaeb341-e126-4cde-99b9-3e247e12b372",
"bank_slip_key": null,
"paid_method_type": "pix",
"source_account_key": null,
"payment_data": {
"creditor_bank_account_key": "6108dd45-580d-48c4-b3bb-74c1e843be49",
"batch_renegotiation_proposal_key": "ff5ad6dd-2087-4850-a3e8-b37634448b4e"
}
}
}
Salve a batch_proposal_key retornada na resposta. Ela será necessária para consultar o status da renegociação em lote e para receber os webhooks de pagamento.