Loans

The Loans module covers the full lifecycle of a loan to an affiliate: application → evaluation → decision → disbursement → repayment. The affiliate simulates and applies from the app or the portal; the platform evaluates the risk automatically; the operator decides the amount and the term; and, once disbursed, the affiliate checks and pays their installments.

This guide is written for two profiles:

• Affiliates — the people who simulate, apply for and pay off their loans.
• Operators / advisors — the people who review the evaluation, make the decision and manage the disbursement and the loan portfolio.

Note. Loan products, their amounts, terms and rates, as well as the evaluation rules, are configured by your family compensation fund (caja de compensación). This guide describes the platform’s standard behavior.

The lifecycle of a loan #

A loan application moves through a sequence of statuses from the moment the affiliate submits it until the loan is active and being repaid.

stateDiagram-v2
    [*] --> Draft
    Draft --> Submitted: the affiliate submits
    Submitted --> InReview: automatic evaluation
    InReview --> PendingInfo: request information
    PendingInfo --> InReview: the affiliate completes it
    InReview --> Approved: approve with amount and term
    InReview --> Rejected: reject
    Approved --> Disbursing: start disbursement
    Disbursing --> Disbursed: payment confirmation
    Disbursed --> Active: in repayment
    Draft --> Cancelled: cancel
    Submitted --> Cancelled: cancel
    InReview --> Cancelled: cancel
    Active --> [*]: loan paid off
    Rejected --> [*]
    Cancelled --> [*]

Affiliate tasks #

How to simulate a loan (affiliate) #

1. Sign in to the app or the web portal and open Loans.
2. In the Available tab, review the products: minimum and maximum amount, term in months and rate.
3. Tap Simulate loan and choose the product.
4. Enter the amount and term you want. The platform adjusts the values to the product’s allowed ranges and shows you:
   • The estimated monthly installment.
   • The total interest and the total amount to pay.
   • The full installment schedule (amortization table).
5. If you’re happy with it, tap Apply for loan to start the application.

Note. The simulation is for information only; it doesn’t commit the compensation fund or guarantee approval. The final amount and term are confirmed by the operator when making the decision.

How to apply for a loan (affiliate) #

The application is completed through a step-by-step guided flow. You can pause and resume: your progress is saved as a Draft.

1. From the simulation or from Loans, tap Apply for loan.
2. Consent. Accept the authorizations and declarations shown to you.
3. Information. Fill in your personal and financial data.
4. Documents. Upload the documents the product requires.
5. Confirmation. Review the summary of the loan you’re applying for.
6. Electronic signature. Sign the promissory note with the one-time code you receive by SMS or email.
7. The application becomes Submitted and enters evaluation.

Note. If your compensation fund sent you a pre-approved offer, you’ll see a notice in Loans. You can accept it with a single tap and turn it directly into an application, without simulating again.

How to track my application (affiliate) #

1. In Loans, open the applications section.
2. Each application shows its status with a visual indicator: Draft → Submitted → Under review → Approved → Disbursed.
3. Tap an application to see:
   • The operator’s review notes, if any.
   • Action buttons depending on the stage: Continue application, Information pending or Electronic signature.
   • The disbursement card once the loan is approved or disbursed.

How to check my installments and pay (affiliate) #

1. Open your active loan and go to Installments.
2. At the top you’ll see the total due and how many installments are overdue.
3. Use the tabs to filter: All, Pending, Overdue or Paid.
4. Each installment shows its number, due date, amount and breakdown (principal, interest and, if applicable, insurance), plus the days past due.
5. Tap Pay on a pending or overdue installment to record the payment; you’ll receive the receipt.

Note. If your loan is a payroll-deduction loan (libranza), the installment is deducted automatically from your salary through your employer and you’ll see it marked as paid for its period.

What the platform evaluates #

When an application is submitted, the platform runs an automatic risk evaluation before the operator decides. In business terms, it checks:

With those inputs, the platform applies the decision rules your compensation fund configured and produces one of these outcomes:

• Automatic approval — when a rule approves it directly.
• Manual review — when no rule resolves the case and it’s left to the operator.
• Rejection — when a rule denies the application.

Note. Cases flagged by compliance as high risk are routed to the corresponding team for analysis before continuing.

Operator tasks #

The operator works from the loan management dashboard, which includes the application queue, the risk evaluation result, the disbursement queue and loan portfolio tracking.

How to review an application (operator) #

1. In the dashboard, open Applications and select one.
2. On the detail screen, review:
   • The applicant’s data, the requested amount and term, and the product.
   • The risk metrics produced by the automatic evaluation.
   • The step-by-step review of the flow (consent, form, documents, confirmation, signature).
3. Approve or send back each step of the flow (Approved, Rejected or Changes requested) with your comments. Once all the steps are approved, you can make the final decision.

How to request information from the affiliate (operator) #

1. In the application, tap Request information.
2. Specify exactly which document or data is missing.
3. Confirm. The affiliate will see an “Information pending” notice and can upload what was requested (a file or text). Once they complete it, the application returns to your queue.

How to approve a loan application (operator) #

1. With the application Under review and its steps approved, tap Make decision and choose Approve.
2. Confirm the loan’s terms:
   • Approved amount (it can match or be lower than the requested amount).
   • Approved term in months.
   • Annual rate, if it needs adjusting.
   • Review notes, optional.
3. Confirm. The application moves to Approved, with the affiliate’s signature and/or the disbursement still pending.

How to reject an application (operator) #

1. Tap Make decision and choose Reject.
2. Select the rejection reason:

3. Add a note and confirm. The application moves to Rejected and the affiliate receives the reason.

How to disburse a loan (operator) #

1. Open an Approved application with the affiliate’s signature complete.
2. Verify the affiliate’s destination account (or the employer link if it’s a payroll-deduction loan).
3. Send the disbursement from the disbursement queue. Each disbursement moves through statuses: Pending → Sent → Confirmed. If one fails, you can retry it.
4. Once confirmed, the loan becomes Disbursed and enters repayment: the platform generates the installment schedule and the affiliate starts seeing it in their app.

Note. For payroll-deduction loans, collection is handled through the deduction authorizations and the payroll change files the employer uploads every month. The platform matches the employee with their loan and applies the installment automatically.

Loan portfolio tracking (operator) #

Once active, loans are tracked from the monitoring and collections views.

From the dashboard, the operator can:

• View the loan’s detail: amortization, installments and payment transactions.
• Update the status or restructure a loan (new term or rate).
• Check collections indicators: past-due amount, delinquency rate, portfolio at risk and average days past due.

Warning. Restructuring a loan recalculates the installment schedule. Let the affiliate know, since their installment dates and amounts will change.

Frequently asked questions #

Does the simulation guarantee approval? No. The simulation is for information only. The final amount and term are confirmed by the operator after the risk evaluation.

What happens if the affiliate leaves the application half-finished? It’s saved as a Draft. When they come back, the app offers Continue application from where they left off.

Why does an application end up in manual review if the evaluation was automatic? Because no rule resolved the case automatically, or because there was a finding (identity, compliance) that requires human analysis before deciding.

Where does the affiliate sign the promissory note? In the electronic signature step of the flow, with a one-time code sent to their phone or email. The disbursement is only enabled after signing.

How does the affiliate pay if their loan is a payroll-deduction loan? They don’t pay manually: the installment is deducted from their payroll through the employer and shows as paid for the corresponding period.