# Credit Cards Marketplace

## Standard Partner Page Integration

### Basic Partner Page URL Syntax

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.

{% hint style="info" %}
**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.
{% endhint %}

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

### Partner Page 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 \<a> 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>
```

## Credit Cards Specific Partner Pages & Demos

### Static Offers (ITA) Explore Partner Pages

{% embed url="<https://marketplace.cardcritics.com/network/swetatest/sweta-test/explore/ca46f3bd-5d43-497c-b48c-4964dc7af140?noAnnualFee=false&page=1&pageSize=10>" %}

### Prequal Search Partner Pages

{% embed url="<https://www.moneylion.com/network/test/credit-cards/search>" %}

### Co-mingled ITA Explore & Prequal Search Partner Page

{% embed url="<https://www.moneylion.com/network/atm/credit-cards/explore/09f95c7f-97fc-45df-a437-6293fd4d5f96>" %}

## Partner Page Brand Customization

{% hint style="info" %}
Note that the screenshots in this section reflect a Personal Loans Partner Page, not a New Marketplaces Partner Page.
{% endhint %}

### Customizing Logo & Colors

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

#### Cobrand Example

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

<figure><img src="https://3849802388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MeMvVDbjd8vJWZ9Hwf0%2Fuploads%2FyBiYeUnN06scqjm20tXg%2Fimage.png?alt=media&#x26;token=9ad5f6f8-154d-4a13-a7d6-dce5d1924db8" alt=""><figcaption></figcaption></figure>

## Partner Page User Experience Customization

{% hint style="info" %}
Note that the screenshots in this section reflect a Personal Loans Partner Page, not a New Marketplaces Partner Page.
{% endhint %}

### Selecting the Initial Step

There are two different experiences for users to start the initial step:

* **Preview Step** displays static offers from Engine by MoneyLion’s network of financial institution partners as the first step of the user experience. Offers can be sorted by credit rating, ZIP code, loan purpose, and amount. Users can click into a static offer to begin filling out the form. Preview Step is recommended for partners who want to utilize offer values and financial institution brand equity to encourage users to enter the flow.\\
* **Form Step** displays the first question of the form (i.e., “Why do you need a loan?”). Using the Form Step, users can begin filling out the form immediately. Form Step is recommended for partners who want to maximize funnel efficiency and minimize the number of clicks in the user flow.

<figure><img src="https://3849802388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MeMvVDbjd8vJWZ9Hwf0%2Fuploads%2FRi4TmuYpQHASrFbJqYLK%2Fimage.png?alt=media&#x26;token=6f36124f-458f-429c-91b5-f0fb05bdaced" alt=""><figcaption><p>Preview Step</p></figcaption></figure>

<figure><img src="https://3849802388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MeMvVDbjd8vJWZ9Hwf0%2Fuploads%2Fl9HYaUriBJanXy7ibRv5%2Fimage.png?alt=media&#x26;token=72e84133-7f07-4d3e-bc8d-c5a959c8686f" alt=""><figcaption><p>Form Step</p></figcaption></figure>

### The Results Page

After completing and submitting the form, users are shown offers for which they are pre-approved or pre-qualified. Users can sort offers in a variety of ways, including by APR, term length, and “recommended,” the latter of which relies on Engine by MoneyLion’s Rec Score to rank offers by likelihood of conversion.

<figure><img src="https://3849802388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MeMvVDbjd8vJWZ9Hwf0%2Fuploads%2FW62yHm9OtS5blyaWkKBe%2Fimage.png?alt=media&#x26;token=d048c813-1a20-480b-a385-7a874f84f89e" alt=""><figcaption></figcaption></figure>

## Selecting the Auto-Redirect Option

Auto-Redirect is an option that allows users who receive pre-approved or pre-qualified offers to be automatically redirected to the top offer (powered by Engine by MoneyLion’s Rec Score) displayed on their Results Page after 10 seconds. Auto-Redirect is recommended for partners who prefer to streamline the user experience.

## Client Tags & Prefilling Customer Data

Engine Partner Pages support the ability to add certain tags with varying use cases, which are outlined in this section.

### Client Tag Use Cases

* Prefilling Customer Data
  * Decreases friction in the user experience and increases application submission rates
  * Useful when you already have that info on hand for that user, or want the front-end to default to particular values
* [channel-partner-reporting](https://even-financial.gitbook.io/developer-center/channel-partner-reporting "mention")

### How to Implement Client Tags for Reporting & Customer Data Prefill

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\*:

```
?tag.key_1=value_1&tag.key_2=value_2
```

To **prefill customer data fields** in a Partner Page for the purpose of decreased friction in user experience, add query string parameters to the respective URL in the following format\*:

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

{% hint style="info" %}
\*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 `&`.
{% endhint %}

#### Sample Partner Page URL

```html
https://moneylion.com/network/{channel}/{zone}/search?app.loanAmount=10000&tag.clientId=1234
```

<mark style="color:$primary;">In the above example,</mark> <mark style="color:$primary;"></mark><mark style="color:$primary;">`clientId`</mark> <mark style="color:$primary;"></mark><mark style="color:$primary;">is available as a tag for reporting purposes and the partner page "loan amount" field will be prepopulated with the value of "$</mark>10,000" for the consumer <mark style="color:$primary;">when the page is rendered.</mark>

### Supported Client Tag Keys (for any integration type)

These are the keys that are currently fully supported across all Engine partner page types. Please note that the keys below are case-sensitive:

* agentId
* campaignId
* 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.

### **Credit Cards Supported Client Tag Keys**&#x20;

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

| Key              | Purpose                                                                            |
| ---------------- | ---------------------------------------------------------------------------------- |
| app.annualIncome | Annual income (number)                                                             |
| app.firstName    | First name                                                                         |
| app.lastName     | Last name                                                                          |
| app.email        | Email (valid formatting"                                                           |
| app.primaryPhone | <p>Phone number </p><p>(XXX-XXX-XXXX; must be 10 digits or 11 starting with 1)</p> |
| app..dateOfBirth | Date of birth (mm/dd/yyyy)                                                         |
| app.address1     | Address line 1                                                                     |
| app.address2     | Address line 2                                                                     |
| app.city         | City                                                                               |
| app.state        | State (valid state code, e.g. "CA")                                                |
| app.zipcode      | Zipcode                                                                            |