Adding a new app

Good to know: While you control multiple affiliate programs from the same dashboard, you set up each individually. That allows you to set different affiliate terms (ex., Commission Rate) for each app.

The New App Form

Go to the 'My Apps' page and click on the 'Add a new app' button. You will be redirected to the new app page.

App Settings

Set your app's setting per your prefeence. The settings can be changed anytime later from your dashboard.

Affiliate Terms

The contract details between an app and an affiliate. You can find a detailed explanation of the affiliate terms here.

App Details

• App name: The exact name is shown on the App Store.

• App Logo:

  A .png file of your logo. A 125x125 is recommended.

• Shopify App Store Listing Link:

  eg. https://apps.shopify.com/YourApp

• App Support Email:

  Your affiliates will use this email if they want to contact you

• App Category:

  Your App category, as it is on the Shopify app store. If you can't find the right one, choose 'other'.

Authentication

• Partner ID:

  Find it under Settings > Account information

• Partners API Client Access Token:

Important! Shoffi requires API permissions for your app so we can tell if an install was made using a referral link and calculate the earning and commission rates correctly.

Those permissions grant us a 'Read only' access, which we use only to read the information relevant to the Shoffi platform.

We don't read any data that was before your integration with Shoffi. You can find more information about the Partner API permissions here.

When creating a new API client, please approve permissions to:

• View financials

• Manage apps

If it's your first time making a Partner API key, follow Shopify's guide here.

App ID:

• Go to your app page on the partner admin and copy it from the URL.

  For example:

  https://partners.shopify.com/1111111/apps/1234567#/

  1234567 is your app ID.

App Resources (Optional)

Add links to a public Google Drive, YouTube channel, or any other platform where your affiliate partners can find resources and tutorials to help them learn and promote the app.

The app integration process

Partners API connection

To submit the 'new app' form, you must validate the connection to your Shopify Partners API to ensure the details you've entered are correct. If one of the fields is wrong or you need to add the correct permissions, you will get an error explaining precisely what went wrong.

Google Analytics Integration

To complete the integration, you will need to connect your Google Analytics property. Later on, this request will allow us match which affiliate is associated with each install, if any.

Shoffi requires a "read-only" access to your GA property that is connected to your Shopify App Store listing. Find here the complete inegration guide.

The POST request (Deprecated)

If you signed up to Shoffi in the past, and still using the old matching method using a POST request, we highly recommend start using the new Google Analytics method. You can do that by navigating to your app under "My apps" page, clicking "Edit app" and adding the Google Analytics details.

Shoffi will still support the POST request method for apps that were approved in the past until October 1st, 2025.

Intigration status

You can find the status of your app integration on the "My Apps" page. There are three different integration statuses:

1. Initiated

   The connection with the Partner API was successful. Waiting for Google Analytics integration.

2. Under review If you deleted and reactivated your Shoffi account, your apps will be under review for up to 48 hours.

3. Completed

   Your app was approved and is now live on Shoffi.

4. Deactivated If you closed your account or, for some reason, your app is not activated anymore.