🚀 Executive Overview

India's MF AUM has crossed ₹81 lakh crore, representing India's largest untapped lending pool. Finsire’s New-to-Bank (NTB) Loan Against Mutual Funds (LAMF) infrastructure enables distributors to unlock this liquidity. Instead of clients redeeming their investments during a cash crunch, they can borrow against their portfolio—keeping their compounding intact and your AUM secure.

The Multi-Lender Advantage: Go-live with India's top lenders in one quick integration. Provide LAMF at industry best rates starting at 9.00% p.a. We automate digital onboarding, KYC, and lien marking, allowing you to serve customers instantly with better LTVs and higher ticket sizes than single-lender NBFCs and traditional banks.

🛠️ Distributor Product Suite & Features

Everything you need to go live fast, engineered specifically for your distribution structure.

💻 Multi-Tier Portal Access

Tailored Portal Access for admins and RMs, Distributors, Platform & Aggregators, and Sub-MFDs & Partners. Get a complete 360° lifecycle view—every lead, application, disbursement, repayment, and analytics in one dashboard.

🤝 Support & Conversion Pack

Dedicated SPOC across tech, product, and training. Leverage our Conversion Assist Pack to ensure your team is never blocked and your LAMF adoption remains high.

🔗 Redirection and Native Flows

Deploy quickly using our out-of-the-box Redirection flows, or sign as a Loan Service Provider to access Native flows via LOS APIs and build your own branded borrower experience.

⚡ Comprehensive Journey Control

Assisted Journeys: Empower your team with RM Assisted Customer Flows and Partner Assisted Customer Flows to handhold high-value clients.
Webhooks For Loan Lifecycle Mapping: Track real-time status updates directly into your internal systems.

🎯 Who is this for?

Built to fit your exact operational model and technical bandwidth.

Partner Type	Tailored Product Suite Features
Dedicated LAMF & Individual MFDs	Utilize Distributor Portal Access and standard Redirection flows. Perfect for enabling RM & Partner Assisted Customer Flows to guide retail investors effortlessly.
MFD Platforms & Referral Aggregators	Manage hierarchies with Platform & Aggregator Portal Access and Sub-MFDs & Partners Portal Access. Drive volume across your network utilizing our Conversion Assist Pack.
General Superapps	Embed high-value credit entirely via Native Flows (LSP). Synchronize data using Webhooks For Loan Lifecycle Mapping and manage operations via comprehensive Portal Access for admins.

📊 Choosing Your Integration Strategy

Launch in days, not months. Whether you have a full tech team or zero engineering bandwidth, you can go live in 21 days (Week 1: Agreement & UAT, Week 2: Prod API & Docs, Week 3: Go-Live).

Feature	Direct Model (V1)	Referral Model (V2)
Business Context	Best for direct distributor-to-customer relationships.	Designed for MFDs with sub-partner networks.
Implementation	Simple registration; customer selects assets on-link.	Rich data support; pre-fills portfolios for the user.

🔐 Authentication

Finsire APIs utilize Basic Authentication via Base64 encoded credentials in the Authorization header. This single authentication method applies to both Direct (V1) and Referral (MFD/V2) integrations.

Header Format

Combine your Client ID and Client Secret with a colon, then Base64 encode the resulting string.

Authorization: Basic <Base64(client_id:client_secret)>

Encoding Process Example

1. Credentials:
   Client ID: "YOUR_CLIENT_ID"
   Client Secret: "YOUR_CLIENT_SECRET"

2. Combined String:
   "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET"

3. Base64 Encoded Result:
   "WU9VUl9DTElFTlRfSUQ6WU9VUl9DTElFTlRfU0VDUkVU"

4. Final Header:
   Authorization: Basic WU9VUl9DTElFTlRfSUQ6WU9VUl9DTElFTlRfU0VDUkVU

🟦 User Creation V1 (Direct)

The User Creation API helps you set up new customer profiles in your system directly under a DSA/Lender. By gathering their essential information, you register users and generate a secure journey link.

Important: Upon success, you will receive a finsire_id. This unique identifier is crucial for identifying the customer within your system and must be securely stored on your server. No other APIs can be accessed without it.

POST /v1/api/dsa/assets_selection

Field	Type	Requirement	Professional Context
phone	String	Mandatory	Primary customer mobile for OTP/Communications.
pan	String	Mandatory	Tax identifier for real-time asset fetching.
latitude	String	Mandatory	Geo-location for regulatory compliance.
longitude	String	Mandatory	Geo-location for regulatory compliance.
name	String	Optional	Legal name as per PAN records.
email	String	Optional	Customer email for transaction notifications.
dob	Date (YYYY-MM-DD)	Optional	Customer date of birth.

Comprehensive Request Body

{
  "user": {
    "phone": "9876543210",
    "pan": "ABCDE1234F",
    "latitude": "12.9716",
    "longitude": "77.5946",
    "name": "John Doe",
    "email": "john.doe@example.com",
    "dob": "1990-01-01"
  }
}

Response (New User)

{
  "status": true,
  "finsire_id": "44f4bc0dc887714440a6001731a454b4c4",
  "link": "https://dsa.dpiwealth.com/api/link/XXXX"
}

Response (Existing User)

{
  "status": true,
  "message": "Phone number already exists",
  "finsire_id": "47a712f2cb4f774a7c9b6c8934b6d365fb",
  "link": "https://dsa.dpiwealth.com/api/link/XXXX"
}

🟩 Partner Onboarding

Used to onboard Referral Partners. This implies a "Multi-Tier Network Model" of distribution—a distributor that manages other distributors. It’s designed for large platforms that have hundreds of sub-MFDs or referral partners onboarded. This is a mandatory prerequisite for V2 onboarding. Successful creation generates a partner_code.

POST /api/mfd/v1/onboarding

Note on mfd_code: Must be formatted as FIN-{Last 4 Digits of ClientID}-{MFD code}.

Comprehensive Request Body

{
  "mfd": {
    "mfd_code": "FIN-6c52-MFD90876",
    "partner_email": "partner@example.com",
    "mapping_id": "MAP001",
    "arn_no": "ARN12345",
    "company_name": "ABC Financials",
    "gst_no": "29ABCDE1234F1Z5",
    "pan_no": "ABCDE1234F",
    "pan_type": "INDIVIDUAL",
    "partner_name": "John Doe",
    "partner_mobile_number": "9876543210",
    "partner_alternate_mobile_number": "9876500000",
    "address_line1": "Level 1, Tech Park",
    "address_line2": "MG Road",
    "address_line3": "Sector 4",
    "city": "Bangalore",
    "state": "Karnataka",
    "country": "India",
    "pincode": "560001",
    "bank_account_number": "1234567890",
    "bank_ifsc_code": "ICIC0000002"
  }
}

Success (HTTP 201)

{
  "status": true,
  "message": "MFD onboarded successfully",
  "partner_code": "FNSR_PARTNER_XXXXXXXX"
}

Error (HTTP 422 Duplicate)

{
  "status": false,
  "errors": "Partner email already exists for this account"
}

🟨 User Creation V2 (Referral)

Onboard customers mapped specifically to a referral partner. Supports rich data enrichment via Mutual Fund folios and Bank Details.

POST /v2/api/dsa/assets_selection

Field	Type	Requirement	Professional Context
phone, pan, lat, long	String	Mandatory	Core registration identity and location data.
partner_code	String	Mandatory (From Partner API)	Partner attribution code from Onboarding API.
name, email, dob, address, aadhar	String	Optional	Secondary identity points.
mf_details	Array of Objects	Optional	Pre-filled asset list to reduce user friction.
bank_details	Array of Objects	Optional	Target bank details for the credit line.

Comprehensive Request Body

{
  "user": {
    "phone": "9876543210",
    "pan": "ABCDE1234F",
    "latitude": "12.9716",
    "longitude": "77.5946",
    "partner_code": "FNSR_PARTNER_82JS92K",
    "name": "Jane Smith",
    "email": "jane@example.com",
    "address": "Bangalore",
    "dob": "1992-05-15",
    "aadhar": "123456789012",
    "mf_details": [
      {
        "repository": "CAMS",
        "isinno": "INF209K01YY2",
        "scheme_name": "SBI Bluechip Fund",
        "lein_eligible_units": "150.500",
        "mode_of_holding": "SI",
        "folio": "1234567890",
        "tax_status": "01",
        "scheme_type": "Equity",
        "scheme_code": "D010",
        "amc_code": "S",
        "amc_name": "SBI Mutual Fund",
        "nav": "85.25"
      },
      {
        "repository": "KFIN",
        "isinno": "INF846K01DP8",
        "scheme_name": "HDFC Top 100",
        "lein_eligible_units": "120.750",
        "mode_of_holding": "Individual",
        "folio": "9876543210",
        "tax_status": "1",
        "scheme_type": "Equity",
        "scheme_code": "HDF123",
        "amc_code": "H",
        "amc_name": "HDFC Mutual Fund",
        "nav": "95.40"
      }
    ],
    "bank_details": [
      {
        "bank_name": "State Bank of India",
        "account_number": "1234567890123",
        "ifsc": "SBIN0001234",
        "account_type": "SAVINGS"
      }
    ]
  }
}

Success (HTTP 200)

{
  "status": true,
  "finsire_id": "904390sdfbk0403ndf00093490u0",
  "link": "https://DOMAIN/api/link/ID?token=JWE"
}

Validation Error (HTTP 422)

{
  "status": false,
  "error": "mf_details[0]: isinno is required"
}

📖 Business Glossary

Zero-assumption definitions for key financial terms used in the LAMF ecosystem.

Term	Definition
AUM	Assets Under Management. By offering LAMF, distributors protect their AUM from being redeemed during a client's cash crunch.
Auto-Renewable Overdraft	The loan structure that allows your revenue (distributor spread) to compound quietly in the background without needing to resell to the client.
Lien Marking	A digital hold on units to secure a loan. The customer retains ownership, earns dividends, and compounding continues.
Haircut	The risk margin. If a fund is worth ₹100 and the haircut is 20%, the customer can borrow ₹80.

🔄 Detailed Journey Status Guide

Track your customer's exact position in the loan lifecycle via webhooks or the distributor portal. Below is the end-to-end milestone mapping.

Journey Status Code	Milestone Description
`USER_CREATED`	Profile created in the lender's system (e.g., CUB) and ID successfully verified via Aadhaar/PAN APIs.
`HOLDINGS_FETCHED`	RTA data (CAMS & KFIN) successfully retrieved for the user.
`PLEDGE_CONFIRMED`	User completed the pledging page and RTAs confirmed the mutual fund pledges.
`BANK_DETAILS_ADDED`	Target bank account information submitted for the loan disbursal.
`DIGISIGN_COMPLETED`	The final loan agreement has been digitally signed by the customer.
`VKYC_COMPLETED`	Video KYC processing successfully completed.
`OD_APPROVED`	Overdraft loan facility officially approved by the lender.
`WITHDRAWAL_INITIATED`	Processing fee is debited, funds are available, and the user can withdraw their liquidity.