Developer Center
Back to Engine.tech
  • Welcome!
  • Top of Funnel Applications
    • Embeddable Calculators
      • Embeddable Personal Loan Calculator
      • Embeddable Debt Consolidation Loan Calculator
      • Embeddable Personal Loan vs Debt Relief Calculator
      • Embeddable Savings Calculator
      • Adding Your Client Tags for Reporting Attribution
  • Loans / Savings / Second Look Marketplace
    • Hosted Integrations
      • Partner Pages / Embeds
        • Loans Partner Pages
          • Frond-End Customization Options
          • Preferred Look Partner Pages
          • Bridge Partner Pages
          • Special Offer Partner Pages
        • Loans Embeds
        • Pre-Populating Existing Customer Data
        • Adding Your Client Tags for Reporting Attribution
      • Mobile SDK
        • Mobile SDK - Prefilling Lead Data
        • Adding Your Client Tags to Reporting for Mobile SDK Integrations
        • Event Handlers for Real-Time Tracking in the Engine Mobile SDK
    • Native API (Build Your Own)
      • Financial Product Verticals
        • Loans
          • Personal Loans
            • Collecting User Information for Personal Loans
            • Displaying Personal Loan Offers
            • API Specifications
            • FAQs
          • Home Equity Line of Credit (HELOC)
            • Displaying Offers HELOC
            • Risk Factors & Requirements
            • Dos & Don’ts for All HELOC Supply Partners
            • Dos & Don’ts for HELOC Native Partners (API)
            • Our Embed/Partner Page Implementation
            • HELOC-specific disclosures
          • Auto Loan Refinancing (ALR)
            • Collecting User Information
            • Displaying Auto Loan Refinance Offers
            • API Specifications
            • FAQs
        • Savings
          • Collection User Information for Savings
          • Displaying Savings Offers
          • Marketplace Display Requirements
          • Reporting
          • API Specifications
        • 2nd Look Marketplace
          • 2nd Look Marketplace (Financial Services Providers)
          • 2nd Look Marketplace (Channel Partners)
            • Collecting User Information for 2LM
            • Displaying 2L Marketplace Offers
      • Adding Your Client Tags to Reporting for Native API Integrations
      • General Compliance Guidelines
        • Consumer Information Fields
          • Additional Compliance Recommendations & Best Practices
        • Disclosures
        • Consents
        • Offer Display Fields
    • Reporting Options for Channel Partners
      • Channel Partner Reporting - Looker
      • Channel Partner Reporting - Analytics API
  • Credit Cards Marketplace
    • Native API (Build Your Own)
      • Getting Started
      • Flow Design
      • Collecting User Information for Credit Cards
      • Displaying Credit Card Offers
      • API Specifications
      • Compliance Guidelines
  • New Marketplaces (Credit Builders, Earned Wage Access, Debt Relief)
    • Hosted Integrations
      • New Marketplaces Embeds
      • Adding Your Client Tags for Reporting Attribution
  • References
    • Brand Guidelines and Assets
    • Appendix
      • Appendix A - Notices
      • Appendix B - Disclosures
      • Appendix C - Consents
      • Appendix D: API Field to Offer Card Mappings
      • Appendix E: Appending Client Tags for Partner Page and Embed Integrations
Powered by GitBook
On this page
  • How to Implement Pre-pop Fields (for Either Hosted Integration Type)
  • Where to Place Pre-pop Fields (Different by Hosted Integration Type)
  • Supported Client Tag Keys

Was this helpful?

  1. Loans / Savings / Second Look Marketplace
  2. Hosted Integrations
  3. Partner Pages / Embeds

Pre-Populating Existing Customer Data

Partner Pages and Embeds support pre-populating select fields on the application form, which is useful when you already have that info on hand for that user, or want the front-end to default to particular values.

How to Implement Pre-pop Fields (for Either Hosted Integration Type)

Regardless of the implementation type (Partner Page vs Embed), we support pre-pop for certain non-PII fields to decrease UX friction and increase app submit rates. Fields can be pre-populated by adding query parameters to the respective URL in the below format*:

?app.key_1=value_1&app.key_2=value_2

*The first query parameter appended at the end of a URL/path should start with a question mark ?; all subsequent parameters should start with an ampersand &.

Where to Place Pre-pop Fields (Different by Hosted Integration Type)

As an example, you may want to pre-populate the application with a requested Loan Amount of $10,000 and Credit Rating of "excellent". You may do so by appending ?app.loanAmount=10000&app.providedCreditRating=excellent to your Partner Page or Embed:

Partner Page

To pre-populate fields in a Partner Page, append the parameters to the end of the URL path as follows:

https://moneylion.com/network/{channel}/{zone}/search?app.loanAmount=10000&app.providedCreditRating=excellent

Embed

To pre-populate fields in an Embed, use the following syntax in the tags attribute on the opening moneylion-lending-search tag as follows:

Supported Client Tag Keys

The following is a list of params that can be added to the URL:

Loan Form Step
Key (in url param)
Notes

Loan Purpose

app.purpose

Requested Loan Amount

app.loanAmount

No dollar signs, e.g. '6000'

Credit Rating

app.providedCreditRating

City*

app.city

Spaces should be converted to '%20', e.g. 'New%20York'

State*

app.state

Zip Code*

app.zipcode

Either 5 digits, or 9 digits separated by hyphen (5+4)

Property Status

app.propertyStatus

Date of Birth

app.dateOfBirth

Format: mm/dd/yyyy, e.g. '01/01/1990'

Highest Level of Education

app.educationLevel

Employment Status

app.employmentStatus

Annual Income

app.annualIncome

No dollar signs, e.g. '100000'

Pay Frequency

app.employmentPayFrequency

*These fields will be overwritten if the user’s location is detected

PreviousLoans EmbedsNextAdding Your Client Tags for Reporting Attribution

Last updated 3 months ago

Was this helpful?

Allowed values - LoanPurpose
Allowed values - ProvidedCredRating
Allowed values - State
Allowed values - PropertyStatus
Allowed values - EducationLevel
Allowed values - EmploymentStatus
Allowed values - EmploymentPayFrequency