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
  • Required Fields
  • Special Instructions for Integrations within Mobile Apps
  • Mapping API Fields to Offer Card
  • Offer Display - Ranking Logic
  • Compliance
  • General Disclosures

Was this helpful?

  1. Loans / Savings / Second Look Marketplace
  2. Native API (Build Your Own)
  3. Financial Product Verticals
  4. Loans
  5. Personal Loans

Displaying Personal Loan Offers

PreviousCollecting User Information for Personal LoansNextAPI Specifications

Last updated 4 months ago

Was this helpful?

This section of the guide is divided into two parts:

  • Required Fields: This covers all of the fields partners building a Native API integration will need to display from Engine's offer responses

  • Compliance: This covers the various consents, disclosures and guidance required to receive approval from the Engine Compliance team and Financial Services partners

Required Fields

This section is meant for Loan product offers only. Leads who are not eligible for any Loan offers may receive Secondary Offers instead. For Info on displaying other product type offers:

  • (non-personal-loan products)

Engine’s Financial Services partners require partners building a Native API integration to display a basic set of information associated with their Loan offers. Here are the required fields to display:

  • Financial Services Partner Logo

  • Offer Amount ($)

  • Offer APR Amount (%)

  • Offer Monthly Payment Amount ($)

  • Offer Term Length (#)

  • Offer Term Unit (e.g. Month)

  • CTA (hyperlinked to clickthrough URL), exemplified below as "Continue" Button

  • Pre-Approved or Pre-Qualified designation

  • Offer Description

  • Offer Disclaimer

Special Instructions for Integrations within Mobile Apps

When an offer is sanitized, that offer object (i.e. an element object in the loanOffers array) will have the following fields returned as null:

termLength = null, 
termUnit = null, 
maxApr = null, 
minApr = null, 
meanApr = null, 
feeRate = null, 
maxFeeRate = null, 
minFeeRate = null, 
feeFixed = null, 
maxFeeFixed = null, 
minFeeFixed = null, 
prepaymentFee = null, 
monthlyPayment = null, 
maxMonthlyPayment = null, 
minMonthlyPayment = null, 
meanMonthlyPayment = null, 
maxTotalPayment = null, 
minTotalPayment = null, 
meanTotalPayment = null, 
displayTermUnit = null, 
aprType = AprType.Fixed, 
aprDescription = null, 
monthlyPaymentDescription = null, 
termDescription = null

Your front-end UI should not break if any of these fields is null - in this scenario, you should display the other fields returned as normal (logo, max amount, CTA URL, etc). In Engine's owned and operated spaces, that offer card will look like this:

Once the user clicks on the CTA and enters the lender's site, they will see the other relevant details for that offer.

Mapping API Fields to Offer Card

Please see Appendix D for guidance on mapping API response fields to an offer card for the following products:

Offer Display - Ranking Logic

Engine recommends partners building a Native API integration to display the highest Recommendation Score offer (calculated by Engine’s Machine Learning Algorithm) from each Financial Services partner, and group offers by the Financial Services partner.

Here is an example of how it is represented on Engine-owned experiences:

In order to receive approval from the Engine Compliance team and Financial Services partners, partners building a Native API integration must adhere to the following compliance requirements on the offer display page.

Compliance

In order to receive approval from the Engine by MoneyLion Compliance team and Financial Services partners, partners building a Native API integration must include the following items on the offer display page.

General Disclosures

Partners building a Native API integration must include the Advertiser Disclosure, Representative Example & APR Disclosure, and Other Disclosure on the offer display page, using the same guidance as provided in the previous section.

The below language must be displayed on the offers page, regardless of whether or not offers were available for the user:

  • “If you did not receive an offer from a specific Lending Partner, they may not have been able to determine whether you qualified for a personal loan based on the information you provided. No credit decision has been made. You may still qualify for a personal loan from our partners.”

In order for an app to be available in the Google Play App Store, it must adhere to Google’s established . Google prohibits offers for loans with an APR of 36% or higher. To ensure product offerings on our marketplace do not impact an app’s availability in the Google Play App Store, our API allows some fields in responses to be returned with null values. The following guidance explains how to present these offers.

Please see our for more information.

HELOC offers
Secondary offers
advertising guidelines for financial services
Sample Fiona Offer Table
Compliance Guidelines
Personal Loan (Unsecured)
Secured Loan
Line of Credit
Offer card with details sanitized for the Google Play store
Screenshot of Sample Fiona Offer Table