Skip to main content

Loan Request Flow

The P2P lending process in usmewe is designed to be simple, transparent, and instant.

Overview

┌─────────────────────────────────────────────────────────────────┐
│  1. REQUEST          2. MATCH           3. FUND          4. USE │
│  ───────────────────────────────────────────────────────────────│
│  User submits    →  System finds   →  Funds sent   →  Borrow   │
│  loan request       best rates        instantly       & repay   │
└─────────────────────────────────────────────────────────────────┘

Step 1: Check Eligibility

Before requesting a loan, verify your borrowing limits:

Trust Score

Minimum score of 10 required to borrow

Active Loans

Maximum 3 active loans at once
// Check your borrowing eligibility
const eligibility = await usmewe.loans.checkEligibility();

// Response
{
  "eligible": true,
  "maxAmount": 100,
  "maxDuration": 30,
  "currentLoans": 1,
  "trustScore": 56
}

Step 2: Submit Request

Create a loan request with your desired parameters:
ParameterDescriptionConstraints
amountUSDC amountBased on Trust Score tier
durationLoan term in days7-90 days
purposeReason for loanOptional but recommended
const loanRequest = await usmewe.loans.create({
  amount: 50,
  duration: 14,
  purpose: "Emergency expense"
});

// Response
{
  "requestId": "loan_req_abc123",
  "status": "pending",
  "amount": 50,
  "duration": 14,
  "interestRate": 0.03, // 3%
  "totalRepayment": 51.50,
  "expiresAt": "2024-01-15T12:00:00Z"
}

Step 3: Automatic Matching

The system automatically matches your request with available liquidity:
1

Trust Vault Check

System checks if Trust Vault has sufficient liquidity
2

Rate Calculation

Interest rate calculated based on utilization and your Trust Score
3

Insurance Fee

10% of loan amount reserved for Insurance Pool
4

Instant Funding

Funds transferred to your wallet immediately

Step 4: Receive Funds

Once matched, funds are sent instantly to your connected wallet:
// Loan funded event
{
  "event": "loan.funded",
  "loanId": "loan_xyz789",
  "amount": 50,
  "netAmount": 45, // After 10% insurance fee
  "walletAddress": "0x...",
  "txHash": "0x...",
  "repaymentDue": "2024-01-29T12:00:00Z"
}
The 10% insurance fee is deducted upfront. If you request 50,youreceive50, you receive 45.

Interest Rates

Interest rates are dynamic based on:
FactorImpact
Trust ScoreHigher score = lower rate
Vault UtilizationHigher usage = higher rate
Loan DurationLonger term = slightly higher rate
Level BonusGold+ levels get rate discounts

Rate Tiers

Trust ScoreBase Rate
10-305%
31-504%
51-703%
71-852%
86-1001%

Loan States

Your loan can be in one of these states:
pending → funded → active → repaid

                   overdue → defaulted
StateDescription
pendingRequest submitted, awaiting funding
fundedFunds sent to wallet
activeLoan in progress
repaidSuccessfully repaid
overduePast due date, grace period
defaultedNot repaid within grace period

Cancellation

You can cancel a pending loan request before it’s funded:
await usmewe.loans.cancel("loan_req_abc123");
Once a loan is funded, it cannot be cancelled. You must repay the full amount.

Next Steps