Adding a new 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:
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.
The POST request
When you have those values, you need to send the POST request with the following data:
api_key, shopName, appId, XFF
Variables explanations:
"api_key": Your Shoffi key is generated once you add a new app. You can find it when clicking "edit app" on the "My apps" page.
"shopName": The shop name of the shop that is currently logged in to the app.(full, ex.
newshop.myshopify.com
)"appId": The ID of your Shopify app. To find it, 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."XFF": '
X-Forwarded-For
' header value
Here is how the post request will look like:
await fetch"https://platform.shoffi.app/v1/newMerchant", {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
api_key: "pk_xxxxxx",
shopName: "xxxxxxx.myshopify.com",
appId: "1111111",
XFF:"11.1111.111.111"
})
})
Different languages
The code above is an example of a Shoffi POST request. You can use any other language(Ruby, PHP, etc.) to initiate it.
If you are having trouble finding the value of the 'X-Forwarded-For' header, try searching for it under the request headers. Here are a few examples in different languages:
node:
ctx.request.header['x-forwarded-for
']ruby:
request.env["HTTP_X_FORWARDED_FOR"]
PHP:
$_SERVER["HTTP_X_FORWARDED_FOR"]
Testing the request
You can use your app's test key to test it on your test app or staging environment. Once you push your code to production, change the test key to the real one.
Initiating the request
Once the POST request was added, you will need to open a new Development store from your Partner admin and install and open your app. Once our system receives the request for the first time, the integration status will change to 'Completed, and your app will be ready for affiliates to use.
Integration status
You can find the status of your app integration on the "My Apps" page. There are three different integration statuses:
Incomplete
The connection with the Partner API was successful. Waiting for the POST request.
Under review POST request detected. We are now reviewing your app. That can take up to 48 hrs. If it's been more than 48 hours and your app is still under review, please check the email address you used to sign up for Shoffi, and we sent instructions on what needs to be fixed.
Completed
Your app was approved and is now listed on the Shoffi marketplace.
Last updated