The Personal Loan is an accessible and flexible financial solution designed for individuals, without the need for a justification for using the loan. This case study explores the various types of personal loans, illustrating how each modality can be used to meet different profiles and financial needs. Below is the step-by-step guide for using the use case:
To implement this service, you must configure the CaaS service authentication. For more information, access the Authentication Instructions document.
To implement the Personal Loan, use the Simulation, Onboarding, Contracting, Signature Collection, and Proposal Release APIs.

1 - Simulations

The first step in applying for a Personal Loan is a simulation. The simulation can be performed in two ways:
The nroDiasAcrescimo field defines how many days will be added or subtracted from the default due date of the first installment. By default, the due date occurs on the same day as the simulation, but in the following month. Example: if the simulation is on 05/27, the default due date will be 06/27. If you enter “20”, the due date will be 20 days after this default date (e.g., 07/17). If the simulation is run on the 30th or 31st and the following month does not have these dates, the due date will be adjusted to the last day of the month (for example, a simulation on 01/31 will be due on 02/28).

2 - Onboarding

To apply for a Personal Loan, you must register the details and address of the customer who will receive the payment. This registration step is performed using two different endpoints: Person/Save for registering customer details and /Person/SaveAddress for registering the customer’s address.

3 - Hiring

After the simulation and onboarding, it is necessary to apply for credit. To use a contract with a TED split, add the object below to the previous request within the dto array: To use a contract with a payment slip split, add the object below to the previous request within the dto array:

4 - Signature Collection

The signature can be performed in three ways:
  • Electronic Signature, where the client signs electronically via a link sent by email or WhatsApp;
  • Relogon Signature, where the client signs via a link sent by email or WhatsApp, but the signature is performed in the backend;
  • Certifying Signature, where the client signs via a digital certificate.
To learn more about the signature models, access the Signatures document.

5 - Proposal release

This is the final step in the credit hiring process for Working Capital. The partner can release the proposal to the payment queue after receiving the “finalized” proposal status, with the disbursement process being the responsibility of BMP. In this step, it is necessary to release the proposal through integration with our Proposal Release URL for payment to validate the model after signing. To release the proposal, it is necessary to inform:
  • Proposal code;
  • Operation code;
  • Proposal parameters (if necessary).
For more information about this endpoint, see the reference document 43 - Proposal Release.

Endpoints and auxiliary documents

For this journey, it is very important that the partner knows the Technical Procedure for CaaS Callback. The following endpoints may also be useful: