---
title: Shopping Portal Onboarding Guide
slug: shopping-portal-onboarding-guide
docTags: 
createdAt: 2025-03-13T20:48:13.385Z
---

# Getting Started 

Wildfire’s shopping portal is turn-key, fully hosted "discovery hub" that allows end-users to browse offers, earn cashback, available coupons, and redeem rewards. It functions as a standalone website (subdomain) or an embedded experience within a mobile app. User’s Cash back rewards can be tracked and redeemed either directly through the partners reward platform or via Wildfire’s Hosted earnings dashboards.

# Shopping Portal Authentication

When a user visits the shopping portal, we need a way to identify the user to affiliate when they activate cash back through the portal, in order to attribute them properly when the sale completes its lifecycle. 

Wildfire supports several variations of implementation:

:::Heading{depth="3" indent="1"}
**Wildfire-Managed Authentication (Turn-Key): **
:::

:::Paragraph{listStyleType="disc" indent="2"}
Wildfire Authentication (Google/Apple)
:::

:::Paragraph{listStyleType="disc" listStart="2" indent="2"}
Wildfire Hosts Earning Dashboard 
:::

:::Paragraph{listStyleType="disc" listStart="3" indent="2"}
Wildfire Pays Users 
:::

:::Heading{depth="3" indent="1"}
**Lightweight Authentication: **
:::

:::Paragraph{listStyleType="disc" indent="2"}
Partner manages Authentication (Tracking ID (UUID) Pass-Through)
:::

:::Paragraph{listStyleType="disc" listStart="2" indent="2"}
Wildfire Sends JSON Webhook with Tracking ID
:::

:::Paragraph{listStyleType="disc" listStart="3" indent="2"}
Partner Hosts Earnings Dashboard & Partner Pays User
:::

:::Heading{depth="3" indent="1"}
**Partner Managed Authentication (SSO/OAuth): **
:::

:::Paragraph{listStyleType="disc" indent="2"}
Partner-Managed Auth
:::

:::Paragraph{listStyleType="disc" listStart="2" indent="2"}
Partner or Wildfire Hosts Earnings Dashboard
:::

:::Paragraph{listStyleType="disc" listStart="3" indent="2"}
Partner or Wildfire Manages Payout
:::

Detailed Authentication details can be found here:

[https://kb.wildfire-corp.com/shopping-portal-authentication-guide](https://kb.wildfire-corp.com/shopping-portal-authentication-guide)

# Web Domain Hosting 

The shopping portal can be hosted on a domain or subdomain owned by the partner, or Wildfire can provide a domain for you. Ex: `rewards.partnername.com`

For a partner provided sub domain, please see the CNAME implementation guide below:

[https://kb.wildfire-corp.com/cname-implementation-guide](https://kb.wildfire-corp.com/cname-implementation-guide) 

# Partner Managed Dashboard & Payouts: 

## Syncing Commission Data 

Once your users start generating sales, you'll want your system to sync the associated data so that you can show these sales to your users, send push notifications, etc.  

There are two ways to get this commission data: pull them from our API or receive callbacks from our system.  In most cases, you'll want to receive callbacks to keep your system in sync as closely as possible, but you'll also want to hit the API to pull batches of commission in case a callback wasn't successful.  At this time, we do not re-attempt failed callbacks.

[https://kb.wildfire-corp.com/article/kfgi-syncing-commission-data-via-api-and-callbacks](https://kb.wildfire-corp.com/article/kfgi-syncing-commission-data-via-api-and-callbacks)

## Hosting the Earnings Dashboard

In the commission data we provide back to our partners, they will find the **user uuid attached to each commission record**. 

If the partner chooses to host the earnings dashboard themselves, they can use the commission data feed to populate earnings data into their own earnings dashboards using the user uuids provided in the feeds to map earnings to each user’s earnings dashboard.

More Details: [Hosting Earnings Dashboard & Paying Your Users](docId\:bQLi4IZ_NvdhJLbctCTFH) 

### Sample Commission Data

[https://kb.wildfire-corp.com/public-commission-sample-data](https://kb.wildfire-corp.com/public-commission-sample-data)

![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXeK-DTE7fXsK7WBQVkuqW-7V3FWAuhym3B-DczlPqwWfA9L64xU7eRw2shczX-zHTCl5tQzBAQETiwkDdnztZtpKhpCbxhnPnISoxO0heozfsBsX30GOSQPGMv8QC8v5Ws1TrjpOg?key=QwgDter62pUkOXN9ZqjxSOvh)

**If you need a set of sample commission data to test against, there are a few options available:**

If you already have a Wildfire Application ID and Secret, you can request sample commissions be created for your application.  These sample commissions include a very small set of data with a single record in each possible status.

Alternatively, if you need a larger, more diverse set of data, or if you don't have an application created yet, you can use a sample set of commission data.