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.
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.
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.
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*:
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
Client tag keys are matched exactly, including case. For example - subid and subId are stored as separate tags and will appear as separate keys in your reporting.
Please send each key with consistent casing across all requests, and use the exact spelling shown above.
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?

