For the complete documentation index, see llms.txt. This page is also available as Markdown.

Mortgage Marketplace

How to get started with an Engine by MoneyLion marketplace Partner Page integration for Mortgage

Standard Partner Page Implementation

All Partner Pages utilize custom URLs and tracking to ensure all transactions are correctly attributed. To integrate the Partner Pages on your website, you would place the following URL on your page in your desired location.

PLEASE NOTE: Your Engine representative will provide you with your specific partner page URL. Do not try to reproduce from the sample URL outlined below.

https://moneylion.com/network/{channel}/{zone}/

URL Components

  • Channel: placeholder that will be replaced with precise values in the embed code provided to you.

  • Zone: placeholder that will be replaced with precise values in the embed code provided to you.

If implementing using an anchor tag, you may consider having the link open in a new tab with a target="_blank" attribute:

<a href="https://moneylion.com/network/{channel}/{zone}/" target="_blank">Desired Link Text</a>

Brand Customization

All Partner Pages can be co-branded with your company logo and colors to deliver a seamless customer journey. The headline is also customizable (with Engine by MoneyLion compliance approval).

The Consumer Experience

Engine's Mortgage embed covers purchase, refinance, and home equity (HELOC and HELOAN). The embed renders three surfaces, and your zone configuration decides which one the consumer lands on first:

  • Explore. A rate-trend chart built on current APR data. It shows how rates have moved rather than listing offers, so a consumer can arrive with no information and still see something useful. Its call-to-action hands off to Search.

  • Search. The question flow that qualifies the consumer and ends by creating an offer search with Engine's lending partners.

  • Compare. The results page for that offer search. The consumer can sort the offers, page through them, and narrow them with filters, and each offer's call-to-action sends the consumer to that lender. Compare is the last Engine screen in the flow.

Your Engine representative will provide a link to either the Explore or Search Partner Page. Compare is not available as an entrypoint, because the page is scoped to the offer search that Search created - the only way to reach it is to complete the question flow.

Which filters appear on Compare depends on the mortgage type. Purchase and refinance offers can be narrowed by loan term and by FHA and VA program eligibility. Home equity offers can be narrowed by property value, current mortgage balance, and requested loan amount.

Search Funnel Defined

Mortgage asks a different opening question than Engine's other marketplaces: the consumer states a goal - buying a home, refinancing, or borrowing against home equity - and that answer changes which questions follow.

Step
What the consumer provides

Mortgage Information

Purchase: goal, plus purchase price and down payment

Refinance: property value and current mortgage balance

Home Equity: property value, current mortgage balance, and desired loan amount

Zip Code

The property's ZIP code

Cash Out

Refinance only. Whether the consumer wants cash out, or a rate-and-term refinance

Credit Score

Self-reported credit score range

Identity Verification

Date of birth and phone number

Contact Information

First name, last name, and email

Personal Information

Mailing address

SSN and Consents

Social Security Number, with FCRA and TCPA consent

Not every consumer may see every step. When Engine already has consumer data because identity verification returned i, the marketplace routes past those steps instead of asking again. Identity verification may also insert an SMS one-time-passcode step.

Required Consumer Data Inputs

The Mortgage experience collects every field below itself, inside the Search funnel. Fields appear in the order the consumer meets them, matching the Search Funnel above.

A consumer is only asked for the fields belonging to the mortgage type they picked, and any step Engine can already satisfy - through identity verification - is skipped rather than asked again.

Name
Field Name
Description
Required? Which Mortgage Product(s)?

Mortgage Type

mortgageType

What the consumer wants to do. Values: purchase, refinance, heloc. Home equity submits heloc and leaves the lead's mortgageType unset.

All Mortgage Product Types

Purchase Price

purchasePrice

Purchase price of the home. Stored on the lead as propertyValue.

Purchase only

Down Payment

downPayment

Cash down payment, in dollars. Stored on the lead as downPaymentAmount.

Purchase only

Down Payment Percentage

downPaymentPercent

The same down payment expressed as a percentage of purchase price. Used by the form only; not stored on the lead.

Purchase only

Property Value

propertyValue

Current estimated value of the home.

Refinance and Home Equity

Current Mortgage Balance

loanBalance (refinance) mortgageBalance (home equity)

Outstanding balance on the existing mortgage. Stored on the lead as mortgageBalance in both cases.

Refinance and Home Equity

Desired Loan Amount

desiredLoanAmount

Amount the consumer wants to borrow against their equity. Stored on the lead as mortgageAmount.

Home Equity only

Property ZIP Code

zipcode

ZIP code of the property being financed, collected on the Zip Code step. Distinct from the consumer's mailing ZIP. Stored on the lead as propertyZipcode, and Engine derives propertyState from it.

All Mortgage Product Types

Cash Out

cashOut

Whether the consumer wants cash out or a rate-and-term refinance. Values: yes, no. Stored on the lead as refinanceType (cash_out or rate_term).

Refinance only

Credit Score

creditScoreRange

Self-reported credit score range. Stored on the lead as mortechCreditRating. Engine always runs a soft pull.

All Mortgage Product Types

Date of Birth

dateOfBirth

Consumer's date of birth. Stored on the lead as YYYY-MM-DD.

All Mortgage Product Types

Phone Number

phoneNumber

Primary phone number. Stored on the lead as primaryPhone.

All Mortgage Product Types

First Name

firstName

Legal first name.

All mortgage types

Last Name

lastName

Legal last name.

All mortgage types

Email Address

email

Email address.

All mortgage types

Street Address

address1

Mailing street address.

All mortgage types

Address Line 2

address2

Apartment, unit, or suite.

Optional

City

city

Mailing city.

All Mortgage Product Types

State

state

Mailing state.

All Mortgage Product Types

Mailing ZIP Code

zipcode

The consumer's mailing ZIP code, collected on the Personal Information step. May differ from the property ZIP.

All Mortgage Product Types

Social Security Number

ssn

Collected and stored in the form NNN-NN-NNNN.

All Mortgage Product Types

Client Tags for Reporting & Attribution

Engine Partner Pages support the ability to add client tags for Channel Partner Reporting, which is outlined in this section.

How to Implement Client Tags

To add client tags to a Partner Page integration for the purpose of enhanced reporting, add query string parameters to the respective URL in the following format*:

*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 &.

Client tags are carried through the marketplace and attached to the offer search Engine creates for that consumer, which is what makes them available in your reporting.

Sample Tag Implementation

In the above example, clientId and source are available as tags for reporting purposes.

Supported Client Tag Keys

Below are the client tag keys that are currently supported:

  • agentId

  • campaignId

  • clickId

  • clientId

  • deviceId

  • medium

  • sourceId

  • subId

  • subId1

  • subId2

  • subId3

  • target

  • trafficsource

  • userId

If a different key is needed, please reach out to your Partner Manager - we may be able to accommodate, but adding nonstandard keys will increase the time it takes Engine to report Client Tag values back to you and is therefore not recommended.

Last updated

Was this helpful?