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
  • Special Offer Responses
  • Product Sub Type - Possible Values
  • Mapping API Fields to Offer Card
  • Compliance
  • General Disclosures

Was this helpful?

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

Displaying 2L Marketplace Offers

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

Special Offer Responses

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

  • Partner Logo

  • Offer Name

  • CTA (as url in the response)

  • Product Sub Type

  • Offer Description

  • Offer Disclaimer (may or may not be present - if present, it must be displayed in the UI)

Second Look Marketplaces are returned in the specialOffersarray in the offer response, and they may be static or dynamic.

Similar to loan offers, dynamic alternative product offers may appear in pendingResponses before ultimately resolving.

Here’s an example of an individual offer after resolving:

{
    "uuid": "1f7a2465-f5ae-4789-9f85-6d0ff135622f",
    "name": "Get 0% APR cash advances up to $500",    
    "desc": "Unplanned expenses? Use a cash advance from Partner Test..",
    "disclaimer": "These products are subject to stipulations...",
    "url": "https://offers.engine.tech/ref/db7c6f9e-505b-40af-af23-6e241af3e826",
    "partnerName": "Partner Test",
    "partnerImageUrl": "https://s3.amazonaws.com/images.engine.tech/logos/prod/partner",
    "recommendationScore": 264,
    "payout": 2.64,
    "productSubType": "credit_builder"
}

Currently, responses will have up to 11 offer objects in the `specialOffers` array in the response, one offer per productSubType. In the future, Engine by MoneyLion may add support for different configurations.

Product Sub Type - Possible Values

Here is a list of possible values for productSubType in a specialOffers response object, each with a suggested mapping to its plain English text representation:

  • cash_advance => Cash Advance

  • credit_builder => Credit Builder

  • credit_card => Credit Card

  • credit_repair => Credit Repair

  • debt_relief => Debt Relief

  • education_offers => Education Offers

  • employment_opportunity => Employment Opportunity

  • financial_wellness => Financial Wellness

  • installment_loans => Installment Loans

  • overdraft_protection => Overdraft Protection

  • revenue_based_financing => Revenue Based Financing

Mapping API Fields to Offer Card

When a disclaimer is not present, Engine does not display the "Disclaimers" field:

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.”

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 certain 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.”

PreviousCollecting User Information for 2LMNextAdding Your Client Tags to Reporting for Native API Integrations

Last updated 2 months ago

Was this helpful?

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

2nd Look Offer without the "Disclaimers" field

Please see our for more information.

Appendix D
Sample Fiona 2nd Look Offer Table
Compliance Guidelines
Screenshot of Fiona 2nd Look Offer Table