Loss Risk Agreement

To request a new renegotiation of type loss_risk_agreement, you can follow these steps:

1. Get the Loan's present_value and outstanding_principal through the API

Make a request to this endpoint GET /loans/{uuid}

And find the present_value and outstanding_principal fields.

The outstanding_principal is useful for this type of renegotiation, because with it you can calculate the max discount allowed for this Loan.

In this example, you could request a max discount of 21.72, which is the present_value - outstanding_principal.

If the present _value is less than outstanding_principal, the max discount allowed will be 0

2. Simulate the new payment schedule

Make a request to this endpoint POST /loans/simulate/:

• here you can send the present_valueamount, in case you don't want yo apply any discounts
• or the outstanding_principal, in case you want to renegotiate the lower possible amount
• the interest rate can be changed, but cannot be lower than 0.0679 (6.79%) for example (which is configurable per facility)

By doing it, you'll receive the new payment schedule that you can now use in the renegotiations endpoint.

In this case, we used the outstanding_principalamount to simulate, and because of that, when requesting the renegotiation, we'll need to inform the discount we applied (21.72)

3. Request the renegotiation

To do it, you can make a request to the POST /loans/{uuid}/schedule-requests/ endpoint, using the exact same amount and due dates for the installments.

Observation: when requesting the renegotiation, the payment field of the simulation becomes fixed_amount, and the payment_date becomes due_date

And just to show the validation, in the first request we tried to apply a discount of 100.0, and then we received an error:

Then, we changed it to the max discount allowed (present_value - outstanding_principal), and now it worked!

Note that the inferrred interest rate is exactly the same you used in the simulation:

Great!

The contract will be crafted and sent to the DocuSign to be signed, and you'll receive the first webook: contract_sent.

That's it! 🚀