Pular para o conteúdo principal

Cenários - Renegociação em Lote BNPL

Resumo​

Este documento apresenta os principais cenários de renegociação em lote para operações BNPL. Todos os cenários utilizam o amortization_type: "present_amount" e permitem aplicar descontos individuais por parcela através do campo discount no objeto de cada installment.

Lógica de Desconto por Parcela

É possível aplicar descontos diferentes em cada parcela individualmente. Basta adicionar o campo discount (valor absoluto em reais) dentro do objeto da parcela desejada. Parcelas sem o campo discount serão cobradas pelo valor presente integral.

Cenário 1: Empréstimo de 1 Parcela - Pagamento Padrão​

O tomador possui um empréstimo BNPL de 1 parcela e deseja quitá-lo pelo valor presente.

Exemplo de Payload​

{
    "payment_type": "pix",
    "amortization_type": "present_amount",
    "proposal_due_date": "2026-04-10",
    "discount_percentage": 0,
    "reference_date": "2026-04-10",
    "request_control_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "operations": [
        {
            "debt_key": "bf1175f4-750d-42b9-b264-5e7cd8c1c189",
            "installments": [
                {
                    "installment_key": "0298c572-7b6b-4db0-88d6-4bf1622d3e2d"
                }
            ]
        }
    ]
}

Cenário 2: Empréstimo de 1 Parcela - Pagamento Sem Juros (Interest Free)​

O tomador possui um empréstimo BNPL de 1 parcela e negocia o pagamento sem juros. O desconto aplicado corresponde ao valor dos juros da parcela.

Exemplo de Payload​

{
    "payment_type": "pix",
    "amortization_type": "present_amount",
    "proposal_due_date": "2026-04-10",
    "discount_percentage": 0,
    "reference_date": "2026-04-10",
    "request_control_key": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "operations": [
        {
            "debt_key": "bf1175f4-750d-42b9-b264-5e7cd8c1c189",
            "installments": [
                {
                    "installment_key": "0298c572-7b6b-4db0-88d6-4bf1622d3e2d",
                    "discount": 54.19
                }
            ]
        }
    ]
}
Observação

O valor do discount (54.19) corresponde ao valor dos juros (pre_fixed_amount) da parcela. Dessa forma, o tomador paga apenas o valor do principal.

Cenário 3: Empréstimo de 1 Parcela - Pagamento Sem Juros e Sem IOF (Interest + IOF Free)​

O tomador possui um empréstimo BNPL de 1 parcela e negocia o pagamento sem juros e sem IOF. O desconto aplicado corresponde à soma dos juros e do IOF da parcela.

Exemplo de Payload​

{
    "payment_type": "pix",
    "amortization_type": "present_amount",
    "proposal_due_date": "2026-04-10",
    "discount_percentage": 0,
    "reference_date": "2026-04-10",
    "request_control_key": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "operations": [
        {
            "debt_key": "bf1175f4-750d-42b9-b264-5e7cd8c1c189",
            "installments": [
                {
                    "installment_key": "0298c572-7b6b-4db0-88d6-4bf1622d3e2d",
                    "discount": 55.44
                }
            ]
        }
    ]
}
Observação

O valor do discount (55.44) corresponde à soma dos juros (pre_fixed_amount: 54.19) + IOF (tax_amount: 1.25) da parcela. Dessa forma, o tomador paga apenas o valor de amortização do principal.

Cenário 4: Empréstimo de Múltiplas Parcelas com Desconto Individual​

O tomador possui um empréstimo BNPL com várias parcelas e negocia descontos diferentes para parcelas específicas. Parcelas sem o campo discount são cobradas pelo valor presente integral.

Exemplo de Payload​

{
    "payment_type": "pix",
    "amortization_type": "present_amount",
    "proposal_due_date": "2026-04-10",
    "discount_percentage": 0,
    "reference_date": "2026-04-10",
    "request_control_key": "d4e5f6a7-b8c9-0123-defa-234567890123",
    "operations": [
        {
            "debt_key": "bf1175f4-750d-42b9-b264-5e7cd8c1c189",
            "installments": [
                {
                    "installment_key": "0298c572-7b6b-4db0-88d6-4bf1622d3e2d",
                    "discount": 20
                },
                {
                    "installment_key": "5e267f58-0f55-4b12-9582-63e0e9e082a8"
                },
                {
                    "installment_key": "5be492bf-b637-4999-986d-ecf423cc5dd1"
                },
                {
                    "installment_key": "15abfbfd-8608-45e9-abbb-a04c021dcf7b",
                    "discount": 10
                },
                {
                    "installment_key": "c8eb83b3-5b0d-4326-947c-79279cdce2d6"
                }
            ]
        }
    ]
}
Observação

Neste exemplo:

  • Parcela 1: desconto de R$ 20,00
  • Parcela 2: sem desconto (valor presente integral)
  • Parcela 3: sem desconto (valor presente integral)
  • Parcela 4: desconto de R$ 10,00
  • Parcela 5: sem desconto (valor presente integral)

Cenário 5: Pagamento de Parcelas em Atraso (Overdue)​

O tomador possui parcelas vencidas e deseja quitá-las. As parcelas em atraso já incluem multa e juros de mora calculados automaticamente. É possível aplicar descontos individuais para reduzir o valor.

Exemplo de Payload​

{
    "payment_type": "bank_slip",
    "amortization_type": "present_amount",
    "proposal_due_date": "2026-04-10",
    "discount_percentage": 0,
    "reference_date": "2026-04-10",
    "request_control_key": "e5f6a7b8-c9d0-1234-efab-345678901234",
    "operations": [
        {
            "debt_key": "bf1175f4-750d-42b9-b264-5e7cd8c1c189",
            "installments": [
                {
                    "installment_key": "0298c572-7b6b-4db0-88d6-4bf1622d3e2d",
                    "discount": 15
                },
                {
                    "installment_key": "5e267f58-0f55-4b12-9582-63e0e9e082a8",
                    "discount": 15
                }
            ]
        }
    ]
}
Atenção

Para parcelas em atraso, o valor presente já inclui multa (fine_amount) e juros de mora calculados automaticamente com base na fine_configuration do contrato. O discount é aplicado sobre esse valor total.

Cenário 6: Múltiplas Operações com Desconto Individual por Parcela​

O tomador possui empréstimos BNPL em diferentes operações e deseja quitar parcelas de todas em um único pagamento, com descontos individuais.

Exemplo de Payload​

{
    "payment_type": "pix",
    "amortization_type": "present_amount",
    "proposal_due_date": "2026-04-10",
    "discount_percentage": 0,
    "reference_date": "2026-04-10",
    "request_control_key": "f6a7b8c9-d0e1-2345-fabc-456789012345",
    "operations": [
        {
            "debt_key": "bf1175f4-750d-42b9-b264-5e7cd8c1c189",
            "installments": [
                {
                    "installment_key": "0298c572-7b6b-4db0-88d6-4bf1622d3e2d",
                    "discount": 20
                },
                {
                    "installment_key": "5e267f58-0f55-4b12-9582-63e0e9e082a8"
                }
            ]
        },
        {
            "debt_key": "a2c3d4e5-860f-4b7a-9c1d-2e3f4a5b6c7d",
            "installments": [
                {
                    "installment_key": "7b8c9d0e-1f2a-3b4c-5d6e-7f8a9b0c1d2e",
                    "discount": 30
                }
            ]
        }
    ]
}

Objeto Installments - Campo Discount​

CampoTipoDescriçãoObrigatório
installment_key*stringChave da parcela a ser renegociadaSim
discountfloatValor de desconto em reais (R$) aplicado individualmente na parcelaNão
Sobre o campo discount
  • O campo discount é opcional e pode ser informado em qualquer parcela
  • O valor é um desconto absoluto em reais (não percentual)
  • Parcelas sem o campo discount são cobradas pelo valor presente integral
  • O desconto é aplicado sobre o valor presente da parcela na reference_date

Tabela Resumo dos Cenários​

CenárioDescriçãoDiscount
1 parcela - padrãoPagamento pelo valor presenteSem desconto
1 parcela - interest freeDesconto = valor dos jurosdiscount = pre_fixed_amount
1 parcela - interest + IOF freeDesconto = juros + IOFdiscount = pre_fixed_amount + tax_amount
Múltiplas parcelasDescontos individuais por parceladiscount por parcela
Parcelas em atrasoParcelas vencidas com multa/moradiscount opcional
Múltiplas operaçõesOperações diferentes em um lotediscount por parcela

Regras Importantes​

Regras da Renegociação em Lote
  • Todas as operações devem ser do mesmo emitente e mesma chave de integração
  • Limite de 50 operações por lote
  • Um único meio de pagamento (boleto/Pix) é gerado para o valor total do lote
  • Se uma parcela incluída no lote for paga por fora antes da confirmação, o lote é rejeitado
  • Se o pagamento não for realizado até a proposal_due_date, o lote é rejeitado
  • O amortization_type utilizado é sempre present_amount
  • O campo discount é aplicado individualmente por parcela