# Managed Stores

Manage your stores as a partner

You'll be able to manage your store from the Managed Stores page. You can add new store, view all your existing stores and request management for other Fera user's store(s).

### Add Your Account (Store)

After you add your account (store), it will appear in your stores table just like this:

<figure><img src="https://1246828530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVWFhwTurA1YksUJWXq9%2Fuploads%2FdSwoTXslKs29Bb53VIzf%2Fpartner%20portal%2001.png?alt=media&amp;token=3b221304-9429-498f-bfe2-06575c23422d" alt=""><figcaption></figcaption></figure>

### Request Store Management

You can request management for a store owned by an existing Fera user. If this user authorizes your request, the store will appear with your existing stores list for your use:

<figure><img src="https://1246828530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVWFhwTurA1YksUJWXq9%2Fuploads%2Fuj0EjCB1hkcpJ0H19uYL%2Fpartner%20portal%2002.png?alt=media&amp;token=b1db831e-9495-4bba-bea3-53bc0fd9d397" alt=""><figcaption></figcaption></figure>


# Apps

Manage all that is needed for your app

In this page, you can manage all your apps. It includes mainly the below:

1. Create your app(s)
2. Test installing your app(s) on your stores in Fera
3. Publish your app(s)


# Creating an App

You can create one or more apps in the partner portal. You need to configure mainly the below for your app(s):

* General info
* Setup
* Listing

### General

Under the General tab, you mainly need to fill in the app name, code and description along with other configurations like Testing Instructions:

<figure><img src="https://1246828530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVWFhwTurA1YksUJWXq9%2Fuploads%2FKEmlrwbEN5uX82go7Urj%2Fpartner%20portal%2003.png?alt=media&amp;token=b2a257db-eb63-43a2-8ec3-c24b5a6a1124" alt=""><figcaption></figcaption></figure>

### Setup

In this section you'll setup OAuth connection info, if applicable.

<figure><img src="https://1246828530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVWFhwTurA1YksUJWXq9%2Fuploads%2FlCy953NTfW3URkMikhn5%2Fpartner%20portal%2005.png?alt=media&amp;token=22748196-9837-4b55-9709-a63c36709fe3" alt=""><figcaption></figcaption></figure>

### Listing

You can set the app's website and its other supporting resources:

<figure><img src="https://1246828530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVWFhwTurA1YksUJWXq9%2Fuploads%2FTaKTIDVGty2gH7vGLoYV%2Fpartner%20portal%2006.png?alt=media&amp;token=2037106d-ddfe-48e8-be97-6d9ef4daa548" alt=""><figcaption></figcaption></figure>


# Testing App

You can skip having to authenticate an app through the standard OAuth2 flow and skip to generating an `auth_token` for any of your authorized or partner-managed stores by using the "Install" option in the app details screen.&#x20;

Generating an auth token will give you access to the store's [private API](https://developers.fera.ai/reference/authentication-2).

This is how you install your app on your store using its URL:

<figure><img src="https://1246828530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVWFhwTurA1YksUJWXq9%2Fuploads%2FXFLscRHZm96ZhPrOOzo6%2Fpartner%20portal07.png?alt=media&amp;token=0cbcebcb-0bca-49bf-b104-bf76c90676e4" alt=""><figcaption></figcaption></figure>


# Publishing App

Once you've tested your app, submitted it and got approval from Fera, now you can publish your app.

<figure><img src="https://1246828530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVWFhwTurA1YksUJWXq9%2Fuploads%2FEPtnXeCP8etiLnuKJlmQ%2Fpartner%20portal%2008.png?alt=media&amp;token=a54b85a9-ff37-46df-9323-807c82f36d91" alt=""><figcaption></figcaption></figure>


# Managing App

Once you create your app, you can manage it with multiple options like submitting it for approval or installing it on your test store etc..

<figure><img src="https://1246828530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVWFhwTurA1YksUJWXq9%2Fuploads%2FaQwhyHDQyMnlahBJuxp6%2Fpartner%20portal%2009.png?alt=media&amp;token=514f2ba0-45a5-4fba-a3f5-cc876c6fcdfa" alt=""><figcaption></figcaption></figure>


# Referrals

{% hint style="danger" %}
Our partner docs are under construction.&#x20;

In the meantime please check out our [developer/API docs](https://developers.fera.ai) or [help center](https://help.fera.ai) instead.
{% endhint %}


# Referral Link

In Referrals page, it shows your referral link that you can use to refer for Fera signups.&#x20;

<figure><img src="https://1246828530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVWFhwTurA1YksUJWXq9%2Fuploads%2FGO7PLbjVHOcKXtHGHnOI%2Fpartner%20portal%2010.png?alt=media&amp;token=71e5755e-453b-4a8f-baf3-1eb928583891" alt=""><figcaption></figcaption></figure>


# Tracking Referrals

In Referrals page, you can track all the stores that installed Fera app referred by you (if you have any).

<figure><img src="https://1246828530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVWFhwTurA1YksUJWXq9%2Fuploads%2FScwn33yJvpXMlLVO7Y2k%2Fpartner%20portal%2011.png?alt=media&amp;token=bc77eac8-4823-4137-a529-029858220dae" alt=""><figcaption></figcaption></figure>


# Getting Paid

In some cases, we offer affiliate commissions on referred signups.&#x20;

If you are **based in Canada**, we will send you an e-transfer. There is a **minimum payout of $100 USD to receive an e-transfer**.&#x20;

If you are an affiliate **outside of Canada**, we will send you a wire transfer. There is a **minimum payout of $1000 USD to receive a wire transfer.** \
\
Please contact our Marketing Manager, Jameela (<jameela@fera.ai>),  to discuss affiliate programs, commissions, and to send your payment details.


# Team

In the Team page, you can add and manage your users.

<figure><img src="https://1246828530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVWFhwTurA1YksUJWXq9%2Fuploads%2F6FFlPQnCves5V2M7xJP2%2Fpartner%20portal%2012.png?alt=media&amp;token=68931103-3472-4b68-aa94-7ba0ec3695b1" alt=""><figcaption></figcaption></figure>


# Partner Badges

Fera badges you can use improve authority and trust for your business

## Works With Fera Badge

{% hint style="success" %}
**Best for:** Apps and Themes
{% endhint %}

<figure><img src="https://uploads.fera.ai/brand/partners/works_with_badges@2x.png" alt=""><figcaption><p>"Works With" Badges</p></figcaption></figure>

Get the HTML code snippets for this badge from here:

{% content-ref url="/pages/gIF18ribu3sE4jdVu5Z3" %}
[Works With Fera](/partner-badges/works-with-fera)
{% endcontent-ref %}

## Trusted Partner Badge

{% hint style="success" %}
**Best for:** Agencies and Service Businesses
{% endhint %}

<figure><img src="https://uploads.fera.ai/brand/partners/trusted_partner_badges@2x.png" alt=""><figcaption><p>"Trusted Partner" Badges</p></figcaption></figure>

Get the HTML code snippets for this badge from here:

{% content-ref url="/pages/WWdOTixnYWpjShsYcVSd" %}
[Trusted Partner Badges](/partner-badges/trusted-partner-badges)
{% endcontent-ref %}


# Works With Fera

Show off that your app or theme works with Fera.

Use these badges when your app or theme works well with Fera.or is compatible with Fera out of the box.

<figure><img src="https://uploads.fera.ai/brand/partners/works_with_badges@2x.png" alt=""><figcaption><p>We have 4 variations of the Works With Fera badge.</p></figcaption></figure>

## HTML Code for Badges

These HTML snippets will display the badge using on our CDNs and link.

Please update the partner profile links in the HTML to link to your partner profile (by replacing the "code" with your partner code).

{% tabs %}
{% tab title="Light (Default)" %}
{% embed url="<https://codepen.io/jayelkaake/pen/JjZEbYG>" %}
HTML code for the default Works With Fera badge.
{% endembed %}
{% endtab %}

{% tab title="Dark" %}
{% embed url="<https://codepen.io/jayelkaake/pen/poKRNjG>" %}
HTML for Works With Fera dark badge.
{% endembed %}
{% endtab %}

{% tab title="Other Variations" %}
Rainbow

```html
<a href="https://www.fera.ai/partners/shopify" target="fera" style="display: inline-block; border: none;" title="This app/theme is compatible with Fera for your reviews."><img src="https://uploads.fera.ai/brand/partners/works_with_fera/rainbow.svg"></a>
```

Pure White (for Black Background):

```html
<a href="https://www.fera.ai/partners/shopify" target="fera" style="display: inline-block; border: none;" title="This app/theme is compatible with Fera for your reviews."><img src="https://uploads.fera.ai/brand/partners/works_with_fera/black.svg"></a>
```

Pure Black (on White Background):

```html
<a href="https://www.fera.ai/partners/shopify" target="fera" style="display: inline-block; border: none;" title="This app/theme is compatible with Fera for your reviews."><img src="https://uploads.fera.ai/brand/partners/works_with_fera/white.svg"></a>
```

{% endtab %}
{% endtabs %}


# Trusted Partner Badges

Increase your authority by displaying a Fera Trusted Partner badge on your site.

These trusted partner badges are more general. The are best for Agency Partners and other service company partners.

<figure><img src="https://uploads.fera.ai/brand/partners/trusted_partner_badges@2x.png" alt=""><figcaption><p>4 variations of our trusted partner badges.</p></figcaption></figure>

## HTML Code for Badges

These HTML snippets will display the badge using on our CDNs and link.

Please update the partner profile links in the HTML to link to your partner profile (by replacing the "code" with your partner code).

{% tabs %}
{% tab title="Light (Default)" %}
{% embed url="<https://codepen.io/jayelkaake/pen/XWYpNNJ>" %}
HTML code for light trusted partner badge.
{% endembed %}
{% endtab %}

{% tab title="Dark" %}
{% embed url="<https://codepen.io/jayelkaake/pen/abKpBWN>" %}
HTML code for dark trusted partner badge.
{% endembed %}
{% endtab %}

{% tab title="Other Variations" %}
Rainbow

```html
<a href="https://www.fera.ai/partners/shopify" target="fera" style="display: inline-block; border: none;" title="This app/theme is compatible with Fera for your reviews."><img src="https://uploads.fera.ai/brand/partners/works_with_fera/rainbow.svg"></a>
```

Pure White (on Black Background):

```html
<a href="https://www.fera.ai/partners/shopify" target="fera" style="display: inline-block; border: none;" title="This app/theme is compatible with Fera for your reviews."><img src="https://uploads.fera.ai/brand/partners/trusted/black.svg"></a>
```

Pure Black (on White Background):

```html
<a href="https://www.fera.ai/partners/shopify" target="fera" style="display: inline-block; border: none;" title="This app/theme is compatible with Fera for your reviews."><img src="https://uploads.fera.ai/brand/partners/trusted/white.svg"></a>
```

{% endtab %}
{% endtabs %}


# Setting up a new store

{% hint style="danger" %}
Our partner docs are under construction.&#x20;

In the meantime please check out our [developer/API docs](https://developers.fera.ai) or [help center](https://help.fera.ai) instead.
{% endhint %}


# Creating custom storefronts


# SEO Apps

How to integrate your SEO App with Fera

<figure><img src="https://1246828530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVWFhwTurA1YksUJWXq9%2Fuploads%2FTCCuM7g7agitWprc36GZ%2Fshow_reviews_in_search_results.png?alt=media&amp;token=3ba5123a-54ff-43a7-9f6e-64db0a9b89bc" alt=""><figcaption><p>Fera makes it easy for merchants to show ratings in search results, but your app can make it even easier an give them more control.</p></figcaption></figure>

Fera automatically generates SEO markup schema if it is not already present on the site. However, Fera also plays nicely with apps that manage the SEO markup.

{% hint style="success" %}
Fera is most likely already compatible since it automatically "completes" existing SEO schema with rating/review data.
{% endhint %}

At run-time (via JS) Fera detects any existing SEO schema on the site and automatically appends missing review/rating information.

## Shopify SEO Apps

Fera automatically generates SEO markup schema if it is not already present on the site.

{% hint style="info" %}
We recommend you use the [official Shopify Standard Metafields](https://shopify.dev/apps/metafields/definitions/standard) which Fera will automatically sync ratings to.
{% endhint %}

#### How to get product ratings and review counts

There are two methods store product rating counts and average product ratings for Shopify stores using Fera:

1. Read from the [official Shopify Standard Metafields](https://help.fera.ai/en/articles/6342895-shopify-review-metafields) (recommended)
2. Use the [Partners API Product Ratings](/developers/partner-api/retrieve-product-ratings) endpoint

#### How to get product reviews

If you need to grab public review data for any product, use the [Partners API List Reviews](/developers/partner-api/list-reviews) endpoint.

Also see this article in our help center about [using Fera Shopify review metafields](https://help.fera.ai/en/articles/6342895-shopify-review-metafields).

## Non-Shopify SEO Apps

If your app is not on Shopify you can use our [Partners API](/developers/partner-api) to grab product ratings and reviews from any store using only the store's domain.

However, this may not be necessary. Fera will not tamper with existing review/rating schema, however it will automatically append rating/review data to existing product schema if it is missing and available by Fera.

{% hint style="success" %}
Fera will only automatically add rating/review SEO schema if a product/rating widget has been added to the page from Fera.
{% endhint %}


# Shipping Apps

{% hint style="danger" %}
Our partner docs are under construction.&#x20;

In the meantime please check out our [developer/API docs](https://developers.fera.ai) or [help center](https://help.fera.ai) instead.
{% endhint %}


# Support Apps


# Messaging Apps


# Requesting Reviews


# Page Builder Apps

Dive into the specifics of each API endpoint by checking out our complete documentation.

## Widgets

### Rating Widgets

The [HTML Widgets API](https://developers.fera.ai/docs/widgets) allows you to show this widget on your page. If you need to do basic customization from HTML, please contact us.&#x20;

### Review Widgets

The [HTML Widgets API](https://developers.fera.ai/docs/widgets) allows you to show this widget on your page. If you need to do basic customization from HTML, please contact us.&#x20;

### Photo & Video Widgets

The [HTML Widgets API](https://developers.fera.ai/docs/widgets) allows you to show this widget on your page. If you need to do basic customization from HTML, please contact us.&#x20;

## Review Links

TODO


# Partner Resources

Find everything you need with our brand here <https://www.fera.ai/brand>.


# Shopify Themes

{% hint style="danger" %}
Our partner docs are under construction.&#x20;

In the meantime please check out our [developer/API docs](https://developers.fera.ai) or [help center](https://help.fera.ai) instead.
{% endhint %}


# Display Ratings


# Display Reviews


# By Customer


# SEO Schema Support

What to know about SEO Schema for


# Referral Program

{% hint style="danger" %}
Our partner docs are under construction.&#x20;

In the meantime please check out our [developer/API docs](https://developers.fera.ai) or [help center](https://help.fera.ai) instead.
{% endhint %}


# Brand Assets

Find everything you need with our brand here <https://www.fera.ai/brand>.

Also check out our branded badges:

[Works With Fera](/partner-badges/works-with-fera)

[Partner Badges](/partner-badges)


# Partner API

The Partner API allows you to quickly access public store ratings/reviews of Fera accounts.

## Authentication

Use your partner API key which can be found in your [Partner Dashboard](https://partners.fera.ai/dashboard?ref=open_api\&api_type=partners).

This can be included as the `Api-Key` header or `api_key` parameter.

## Specifying The Store

For any parameters that are specific to a store, you must include the `domain` parameter which is the domain of the store.

If you know the store's public API key or fera store ID then those can also be used via the `store_public_key` and `store_id` parameters respectively instead of the `domain` parameters.

## Product, Customer and Order IDs

Whenever the API requests a product, customer or order ID then Fera accepts either:

* The Fera ID (always begins with 'f' like `fpro_123ABC`)
* The external ID (can be anything)
  * This is usually the store's object ID.
  * For example, if it's a Shopify product then this is the Shopify.

{% hint style="success" %}
Fera IDs always start with 'f' and are globally unique. That's why they're interchangeable with external (store) IDs.
{% endhint %}

## Rate Limits

The rate limit for partners is 60 requests per minute (approximately 1 request per second).&#x20;

If you need to make requests more often please let our team know.

## Response and Request Formats

[Please see the Developer API Reference for the private API.](https://developers.fera.ai/reference/api-request-format?ref=partner-docs) This API follows the same structure for responses and requests.

{% hint style="info" %}
The Partner API is different than our store private API. [View our developer docs here](https://developers.fera.ai/docs?ref=partner-docs) for the full API reference.
{% endhint %}


# List Reviews

List reviews of any store by store domain/url.

As a partner you have access to list any reviews that a Fera store is using.&#x20;

Normally this information is available via our public api (Fera.js) but that requires you to know the store's public key.&#x20;

This API returns data in the same format as the public API (Fera.js) but only requires the store domain/url.

## List all Reviews

This list of reviews includes all reviews for all products, plus store (business) reviews that aren't specific to a product.

{% openapi src="/files/ygM7CvHEG9iCED8GuzYQ" path="/stores/products/reviews" method="get" %}
[openapi-3.1.0.json](https://1246828530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVWFhwTurA1YksUJWXq9%2Fuploads%2Ff1bEq2mvfT2UQuhs3rGx%2Fopenapi-3.1.0.json?alt=media\&token=7a659129-af32-4f56-af5c-2e79deaa479d)
{% endopenapi %}

### Code Examples

{% tabs %}
{% tab title="CURL" %}

```shell
curl --request GET \
     --url https://api.fera.ai/v3/partners/stores/products/reviews?domain=example.com \
     --header 'Api-Key: YOUR_PARTNER_API_KEY'
# See JSON response examples above
```

{% endtab %}
{% endtabs %}

## List a Specific Product's Reviews

{% openapi src="/files/ygM7CvHEG9iCED8GuzYQ" path="/stores/products/{id}/reviews" method="get" %}
[openapi-3.1.0.json](https://1246828530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVWFhwTurA1YksUJWXq9%2Fuploads%2Ff1bEq2mvfT2UQuhs3rGx%2Fopenapi-3.1.0.json?alt=media\&token=7a659129-af32-4f56-af5c-2e79deaa479d)
{% endopenapi %}

### Code Examples

{% tabs %}
{% tab title="CURL" %}

```shell
curl --request GET \
     --url https://api.fera.ai/v3/partners/stores/products/123456789/reviews?domain=example.com \
     --header 'Api-Key: YOUR_PARTNER_API_KEY'
# See JSON response examples above
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
If the store does not exist in Fera then you will receive a Bad Request response (400 status code).
{% endhint %}


# Retrieve Product Ratings

Retrieve product ratings from the site

Use this endpoint to grab a product's rating from a store if you only have the store's domain/url:

{% openapi src="/files/ygM7CvHEG9iCED8GuzYQ" path="/stores/products/{id}/rating" method="get" %}
[openapi-3.1.0.json](https://1246828530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVWFhwTurA1YksUJWXq9%2Fuploads%2Ff1bEq2mvfT2UQuhs3rGx%2Fopenapi-3.1.0.json?alt=media\&token=7a659129-af32-4f56-af5c-2e79deaa479d)
{% endopenapi %}

### Code Examples

{% tabs %}
{% tab title="CURL" %}

```shell
curl --request GET \
     --url https://api.fera.ai/v3/partners/stores/products/123456789/rating?domain=example.com \
     --header 'Api-Key: YOUR_PARTNER_API_KEY'
# See JSON response examples above
```

{% endtab %}
{% endtabs %}


# Check if Site is Using Fera

How to check if a site/store is using Fera or not.

To check if a site/store is using Fera you can perform a store search operation like this:

## Search Fera Stores

{% openapi src="/files/ygM7CvHEG9iCED8GuzYQ" path="/stores/search" method="get" %}
[openapi-3.1.0.json](https://1246828530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVWFhwTurA1YksUJWXq9%2Fuploads%2Ff1bEq2mvfT2UQuhs3rGx%2Fopenapi-3.1.0.json?alt=media\&token=7a659129-af32-4f56-af5c-2e79deaa479d)
{% endopenapi %}

### Code Examples

{% tabs %}
{% tab title="CURL" %}

```shell
curl --request GET \
     --url https://api.fera.ai/v3/partners/stores/search?domain=example.com \
     --header 'Api-Key: YOUR_PARTNER_API_KEY'
# See JSON response examples above
```

{% endtab %}

{% tab title="Ruby" %}

```ruby
require 'httparty'
HTTParty.get(
  'https://api.fera.ai/v3/partners/stores/search?domain=example.com', 
  headers: { 'Api-Key' => 'YOUR_PARTNER_API_KEY' }
);
# See JSON response examples above
```

{% endtab %}
{% endtabs %}


# Other API Endpoints

There are many more API methods that can be accessed by creating a Fera app.

The Fera Partners API has a limited set of endpoints available to you because it does not require prior authorization from each Fera merchant to use.

The Fera Partners API gives you easy access to public data, but much more can be accessed via the [store Private API](https://developers.fera.ai/reference/authentication).

To access all API endpoints available then you need to create a [Fera app](/partner-portal/apps) and [authenticate via OAuth](https://developers.fera.ai/docs/partners-app-authentication?ref=partner-docs).&#x20;