Shopgate FAQs

This article is for you if you are a sole proprietorship or a single person company.If your company is a Corporation (Corp., Inc.), Limited Liability Company (LLC, LC, Ltd. Co.), or a legal entity (GmbH, AG, KG, oHg, etc.), please refer to this article instead.

Follow the entire process outlined below very closely. An incomplete setup could result in the removal of your app from the App Store.If you want to print this article as a hard copy you can make notes on, feel free to download the PDF version here.

A membership in the Apple Developer Program is mandatory to distribute an iOS app on the App Store. This means that all merchants who wish to publish an iOS app are required to enroll in the Apple Developer program. In addition, your iOS app must be published under your name (that is, your own Apple Developer account).

In this article, we will walk you through the process to enroll in the Apple Developer Program as a single-person business and transfer your existing iOS app to your Apple Developer account.

[email protected]

Set up at Shopgate

Enroll in the Program

Create an Apple ID

Create an Apple ID

Use an existing email addressassociated with your company to create an Apple ID.We recommend using an email address that multiple people in the company can access, such as your support or info email. If you don't have a company email address, please create one first.

Go to Create Your Apple ID, following the instructions below when this page opens.

Enter your company email in the form and fill out the rest.

This email will be your new Apple ID. Apple will send important actions or decisions regarding your app to this email. Please make sure to check the emails regularly.

A 6-digit verification code is sent to you via email. Enter the code in the popup that opens.

This code will expire three hours after the email was sent.

Your Apple ID is created.

Please be aware that creating an Apple ID is NOT the same as creating an Apple Developer account.

Turn off two-factor authentication by signing in to your Apple ID account, clicking Edit in the Security section, then clicking Turn Off Two-Factor Authentication. After you create new security questions and verify your date of birth, two-factor authentication will be turned off. Is it necessary to turn off two-factor authentication?

Enroll in the Program

Once your Apple ID is created, open the Apple Developer Program Enrollment page.

Click Start Your Enrollmentand sign in with your new Apple ID.

Read and agree to the Apple Developer Agreement. Click Submit.

Now your Apple Developer Program will open. Select Join the Apple Developer Programon the Welcome page and click Enroll on the next page.

In the field "I develop apps as," select Individual/ Sole Proprietor / Single Person Businessas yourEntity Type. Click Continue.

Enter your legal name, phone number, and address on the next screenand click Continue.Your legal name will be displayed as your app's seller in the App Store.

The legal owner of the company must register for the Apple Developer account.

Accept the Apple Developer Program License Agreement by checking the box on the bottom of the page and clicking Continue.

On the next screen, review your purchase details and selectAutomatic Renewal.

If Automatic Renewal is not used, please set a reminder on your calendar (repeat yearly) to renew your membership every year. Your app will be removed from the App Store within 24 hours upon the expiration of your membership.

You will now be forwardedto the App Store. Login again with the same Apple ID and password.

On the next screen, pay $99 with your credit card and click Continue.

Accept the Terms & Conditions and click Continue. Follow the onscreen instructions until you see the "Thank you" page.

Now you have enrolled successfully in the Apple Developer Program.You will receive two welcome emails and a payment confirmation from Apple at your Apple ID email address within anhour or so.

Set up at Shopgate

Your Shopgate App team works hard to create and update your app. In order for our team members to do their jobs, please enter the information for your Apple Developer account at Shopgate.

Log into your Shopgate Admin.

Navigate to Settings Native Apps Apple Developer Account.

SelectIndividual/ Sole Proprietor / Single Person Businessand click Continue.

Enter your Apple ID and Password,thenConfirm Setup.

That's it! Now you have finished setting up your Apple Developer account! Wewill transferyour iOS app within the next few days. You will get an email confirmation from Apple once this process is complete.

For more information on Apple Developer account, please visit Apple Developer Support.For questions about the enrollment process that we haven't covered in the FAQ section below, please contact us at [email protected].

Frequently Asked Questions

Should I enroll as an individual or organization?

If your company is a corporation (Corp., Inc.), limited liability company (LLC, LC, Ltd. Co.), or a legal entity (GmbH, AG, KG, oHg, etc.), you must enroll as an organization or your app will be rejected.

If you are a sole proprietorship or a single person company, you must enroll asan individual.

Is it necessary to turn off two-factor authentication?

We strongly recommend turning off "two-factor authentication" (and its older version called "two-step verification") for this Apple ID.When "two-factor authentication" is on, Shopgate will have to call you immediately every time we try to upload your app, create the necessary certificates, make changes, and update your app.

If you are not available within the short period of time your 6-digit verification code is valid, we will not be able to do anything.

For some accounts created in iOS 10.3 or macOS Sierra 10.12.4 and later, you might not see the option to turn off two-factor authentication on your Apple ID account page. If this is the case, contact us at [email protected].

Can I enroll as an individual and have my company appear as the seller on the App Store?

No. To have your company name appear as the seller, you must enroll as an organization and your company must be recognized as a legal entity. If you are a sole proprietor/single person business, you must join as an individual and your legal name will appear as the seller.

If you have enrolled as an individual by mistake and need to convert your individual membershipto an organizational membership, please contact us at

How does the enrollment work?

Individuals and sole proprietors/single person businesses can review the license agreement and purchase a membership at the time of enrollment.

When enrolling as an organization, you can review the license agreement and purchase a membership afterApple Developer Support has verified yourenrollment and sent you an email with the next steps. You can check your enrollment status in your Apple Developer Program. Be sure to sign in with the Apple ID you used to enroll.

How much does a membership cost?

The Apple Developer Program membership is $99 per membership year in the United States and 99 in Europe. This cost is the same for an individual membership and an organizational membership.

To provide a long-standing app, you must renew and pay for your membership every year.

Your customers can log into your mobile apps and website, place orders securely and conveniently--all while speeding up the process simply by using Facebook Login.

Shopgate Admin

In this article, you will find everything you need to set up the Facebook Login function.

Preparing your Facebook App

In order to use Facebook Login in your app and mobile website, you must create and connect aFacebook App first.

Enabling Facebook Login

To enable Facebook Login in your mobile shop, follow the steps here to set up the authentication information.

On the left side of your Facebook developer account, find + Add Product. Click Get Started on Facebook Login.

Now a new section called "Facebook Login" will appear under "Products"on the left side of the page. Click Settings.

In the middle of the next screen, enableClient OAuth Login, Web OAuth Login, and Embedded Browser OAuth Login. Enter your OAuth redirect URIs by pasting them one by one then hitting Enter on your keyboard after each paste.

Save your changes.

That's it! You have successfully enabled Facebook Login on your Shopgate mobile shop.

Frequently Asked Questions

Where can I find my Facebook OAuth redirect URIs?

You can find your Client OAuth settings on your Shopgate Admin site.

Log in to your page and navigate to Settings,then Registration & Login.

Find "Configuration" and click Show App Info. There you will find all the OAuth redirect URIsthat areneeded for the validation.

clear the cache

In this article, you will find out how to set upAmazon Pay as a payment method for your Shopgate app and mobile website.

Amazon Pay is supported by Shopgate in the US, UK, and Germany.

To update your payment method, please contact Shopgate support.

Register an Amazon Pay Merchant account

To integrate Amazon Pay at Shopgate, please register for an Amazon Pay Merchant account.

Collect Information

Please collect the following information before you start. Everything listed here is required to register for an Amazon Pay Merchant account.

A unique email address not associated with any other Amazon account

Your business name, type of goods or services, sales volume, company registration and ownership information

Place of establishment (your business address)

VAT registration details, if your business is VAT-registered

Credit card number

Phone number

Sign Up for an Account

To register for an Amazon Pay Merchant account, follow the instructions below:

US UK Germany

Click here to sign up.

Follow the on-screen instructions until your registration is complete.

Click here to sign up.

For more information, visit the merchant help or go to the Overview (UK) page.

Click here to sign up.

For more information, visit the merchant help or go to the Overview (Germany) page.

Generate MWS Access Key

MWS access keys need to be generated before Amazon Pay can be configured with the Shopgate plugin.

Log in to theAmazon Seller Centralof your country: USA | UK | Germany

Go to INTEGRATION MWS Access Key.

Under Create MWS Account, click the link. Then log in again to your Amazon Pay account.

Select the first option"I want to access my own Amazon seller account with MWS." to make sure that you register the MWS Access Key for your own account. Click Next, read and accept the license agreement, and click Next again.

Now the AWS Access Key ID,Secret Key, and the Merchant ID are presented to you on the congratulations page. You can always review the key information atAmazonSeller CentralunderIntegration MWS Access Key.

Configure your Amazon Seller Central

Please prepare your Amazon Seller Central for integration byentering an Integrator URL and uploading a banner image. To do so,

Log in to theAmazon Seller Centralof your country: USA | UK | Germany

Go to Integrations Integration Centralon the top right.

Complete the 2 tasks below.

Enter Integrator URL

Under the sectionInstant Notification Settings,click Edit to the right.

Enter this URL as theIntegrator URL: https://api.shopgate.com/payment/mws_ipns

If your Integrator URL is pre-filled with a different URL, copy and paste it into the text field Merchant URL. Then enter https://api.shopgate.com/payment/mws_ipns as your new Integrator URL.

Click Update to save the changes.

Upload a Banner Image

Having a banner image will increase conversion rate and add more trust to your shop!

To upload a banner image, look for Pop-up Window Banner on the Integration Settings page. Click Choose Fileand then Upload.

That's it! You have finished both tasks on your Amazon backend. Continue to the next chapter to finish setting up Amazon Pay at Shopgate.

Find credentials

Please prepare the following information in order to set up Amazon Pay in your mobile website.

NOTE: The credentials only show on an Amazon Pay account. If you are currently using "Login with Amazon" account, please switch to your "Amazon Pay" account. Click here for instructions to do so.

Merchant/Seller ID

In your Amazon Seller Central, navigate toSettings Integration Settingson the top right.

Access Key ID

Secret Access Key

Click on INTEGRATION MWS Access Key, and look under the table "Access Key ID and Secret Access Key".

Transaction Type

Choose a transaction type to accept customer payments.

Set up Amazon Pay in Shopgate

IMPORTANT: Please make sure you have an Amazon Pay Merchantaccount. "Checkout by Amazon" or any other Amazon accounts do NOT have the API option to integrate.

Log in to your Shopgate Admin and navigate toSettings Payment.

In the section "Add payment method", search for Amazon Payand select it. A pop-up will open. Leave this open until you finish the setup in this chapter.

Add Amazon Pay to your app and mobile website by following the instructions here:

iOS app Android app Mobile Website

Log into your Amazon Seller Central and select "Login with Amazon" on the top.

Scroll down to your dashboard to find "iOS Application Details". If you don't see this section, click the button "Add API Key" at the bottom ofiOS Settings.

On the Shopgate page opened above, copy youriOS Bundle IDby clicking the copy icon on the right end of the row.

Paste your Bundle ID. Click Save.

Now the API Key Value is generated. Click Get API Key Value button to reveal it (not shown in the screenshot). Copy and paste it back into the iOSAPI Key Value field at Shopgate.

Log into your Amazon Seller Central and select "Login with Amazon" on the top.

Scroll down to your dashboard to find "Android Application Details". If you don't see this section, click the button "Add API Key" at the bottom ofAndroid Settings.

Select "No" on "Is this application distributed through the Amazon Appstore?"

On the Shopgate page opened above, copy yourAndroid Package Name andSignatureby clicking the copy icon on the right end of each row.

Paste your Package Name and Signature into therespective fields. Click Save.

Now the API Key Value is generated. Click Get API Key Value button to reveal it (not shown in the screenshot). Copy and paste it back into the Android API Key Value field at Shopgate.

Enter the Merchant ID, MWS Access Key ID, and Secret Access Key

Select the Market Region (country) of your shop

Tell us where you want to display the Amazon button

Choose your Transaction Type

Finish the setup by configuring any additional fees and discounts for Amazon Pay (optional)

Click Save.

Clear cache in your Shopgate Admin. This will refresh the changes to your Amazon Pay setup.

Congratulations! Amazon Pay is now completely set up and ready to accept payments from your mobile users.

Frequently Asked Questions

Can I use my "Checkout by Amazon" account?

Unfortunately, "Checkout by Amazon" accounts don't have the proper API settings for integration purposes. Please register an "Amazon Pay" account in order to set up Amazon Pay in your Shopgate mobile shop.

Why can't I see Integration settings?

Integration settings are only available for "Amazon Pay" accounts. If you're currently working in another account view, please switch to the "Amazon Pay" account view to see integration entries in Settings and on the menu bar.

How do I switch to my "Amazon Pay" account in Seller Central?

Go to your Amazon Seller Central, and look for a drop-down on the top right. If it shows "Checkout by Amazon" or another account name, click on it, and select Amazon Pay from the drop-down.

"Authorize Only" or "Authorize and Capture"?

"Authorize Only" should apply to most shops. It allows regular "Amazon Pay" accounts to accept bank transfers and other payments. You only need to confirm shipping of an order to get paid.

"Authorize and Capture"should only be used in the case you are shipping goods on the same day they are ordered. When Authorize and Capture is selected, you will get paid automatically.

What is my Merchant URL?

Many "Amazon Pay" account should already have a merchant URL entered in the settings. However, if this isn't the case, choose one of the following:

If you have an Integrator URL pre-filled, please copy this URL and paste it into your Merchant URL field. Then enter https://api.shopgate.com/payment/mws_ipns as your new Integrator URL.

If both of your Merchant URL or Integrator URL are empty, simply leave the Merchant URL empty.

An order is marked "on hold". What does that mean?

If one or more of your customer's orders show a status of "on hold", you will not be able to confirm shipping on these orders. This indicates that there has been a problem with the order(s). Please contact Shopgate support at [email protected]

My customers can't select Amazon Pay. What should I do?

If your customers are seeing an error while selecting Amazon Pay in your shop, make sure your Amazon Pay credentials are up-to-date at Shopgate.

If the issue persists, at Shopgate.

Why have my orders been canceled automatically?

If orders paid by Amazon Pay have been canceled automatically, it is highly likely that you have entered your VAT number incorrectly. Please update your VAT number in your Amazon seller accountunderSettings Seller Account Information Business and Contact Information VAT Agreement.

App security is crucial for app developers and owners, particularly in an industry such as retail where financial information is constantly exchanged. Android apps ensure that third parties cannot access your secure app by using "keys."

Each Android app is signed with a key to ensure that updates always have the same signature--that is, they're always changed by the same party. So far, the security of this app signature key has been in the app merchant's own hands. However, Google is now offering help.

Google Play App Signing is responsible for storing and managing your app signature key in Google's trusted security infrastructure. Read on for information on registering your app for this service.

How do I register my App?

First, log in to your Google Play Console account and click the name of your app under "All applications."

On the left side, navigate to App releases.

Once the page opens, click the blue button labeledEdit Release.

You will now be taken to Google Play App Signing. To register your app, clickContinue.

A pop-up window with the "Google Play App Signing Terms of Services" will open. Please accept these.

That's it! After it is successfully set up, Google Play App Signing will appear as "enabled."

If you have any questions or problems when enabling Google Play App Signing, you can always contact Shopgate Support for assistance.

Download and link official app badges to drive more app downloads. this article

IMPORTANT: Please add app badges on your mobile websites only. Do NOT add them to your apps. The iOS App Store will not approve an app with a Google Play Store badge and vice versa.

Finding your app's URLs

Log in to your Shopgate Admin and navigate to Settings > Native Apps.

On the Native Apps page, clickGo to appunder the app store you would like to add an app badge for.

On the pages, copy the URLs in the address bar. These are the links to your App Store and Play Store badges.

Getting badge artworks

The App Store badge

Go to App Store Marketing Guidelines and read the section titled "Download the App Store Badge."

Click Download .zip file.

Unzip the package to reveal the "Download on the App Store" badge in the Print EPS folder.

The Google Play badge

Go to Google Play Badge Generator.

Enter your Play Store URL you copied in the previous section and clickDownload.

Embedding app badges on your mobilewebsite

Now that you have the app badges and your app's URLs, you are ready to go! Simply follow the steps below:

On your Shopgate Admin page, navigate to Design > Pages.

On the Pages page, selectany page on which you wish to display your app badges. Then go to the tabs for your mobile website--Smartphone Website and Tablet Website. If you don't see these tabs, review.

On the Smartphone Websiteand/or Tablet Websitetab, select Imagefrom the drop-down.

A pop-up window will open. Choose 600 x 200 Pixel in the "size" drop-down. Click Upload image to add a badge image.

Position your image in the preview window. Zoom in or out with the +and -signs. When you're happy with the image, click the check mark on the top right.

Now click theLink field. Click External linkand enter your app's URL in the field. ClickAdd to save the URL. Then click Add to save the embedded info.

Now you're back at the Pages page. Repeat the steps to add the Google Play Store badge. At the end, make sure to click Publish Smartphone Websiteto save and publish the App Store badge.

That's it! You've just added the app badges on your mobile website!

The Key Hash for your Android app with Shopgate is generated in your Shopgate Admin.If you haven't configured your Facebook Login, click here to get started.

Find your Android Key Hash

Follow the steps here to find it:

Log in to your Shopgate Admin page and navigate to Settings,then Facebook Login.

In the Configuration section,clickShow App Info to reveal your Android Key Hash.

Facebook Developer Account

Enter your Key Hash at Facebook

Log intoyour and select the Facebook App.

Navigate to Settingsand scroll down to find the section labeledAndroid. Delete the old Key Hash by clicking the X.

Enter your new AndroidKey Hash into the field.

Click Save Changes.

That's it! You have updated the Key Hash for your Android Facebook App. Your Android app users should be able to login via Facebook to the updated Android app immediately.

If you're based in the US and need to update your payment method, please contact Shopgate support.

Shopgate supports Skrill as a payment service provider.

A summary of the international and local payment options with Skrill can be found here.

Getting started

To set up Skrill in your Shopgate mobile shop, you need to have a businessaccount at Skrill. If you don't already have one, follow the steps below:

1.1 Creating a Skrill business account

1. Go here and click Sign upon the top right corner.

log in to Skrill

2. On the registration page, select Business as your account type.

3. Another page will open. Please enter your email address so Skrill can send you a link to continue the registration process immediately.

4. Please fill out the most important information about your company and click Continue.

5. Now you can start creating your business account. Please follow the steps described on the following pages.

6. You will be asked to specify the shopping cart you use. Choose Shopgate from the drop down list.

7. Please upload important documents. These are essential for the verification required by the Financial Conduct Authority (FCA).

8. During the 5-step verification process, you can always jump between the steps. Step 6 shows a summary about details you still need to complete.

9. Click Submit after all information and documents are completed. Skrill will verify these details.

1.2 Activating the verified account

After Skrill has verified and approved your business account, you will receive a Verification of Activation. Now follow the steps here to activate youraccount:

1. Login to your account here.

2. Goto theSettings page. A new section named "Developer Settings" is now unlocked.

3. In this section,create a secret word for the purpose ofencrypting your payments. Please note that your secret word must meet the following requirements:

Max. 10 characters

Lower case letters only

No special characters

Cannot be identical to your password

Now you have successfully created and activated your business account at Skrill. Please continue to set up your Skrill account at Shopgate.

How do I set up Skrill at Shopgate?

To set up Skrill as a payment provider, please complete the following steps:

Log in to your Shopgate Admin page.

Click Settings from the menu bar, then select Payment.

In the "Add payment method" section, start typing "Skrill", and select a type of payment (credit card,Sofort banking, Direct debit, or iDeal)from the drop-down list. If multiple types are used, repeat the steps until all accepted payment types are added.

Note: "Pay by Skrill" payment will automatically appear in checkout when you set up aSkrill payment. You do NOT need to configure "Pay by Skrill" payment.

In the pop-up window, enter your Skrill Merchant ID, Pay to Email, Secret Word, and Password for MQI/API. Click Save.For more assistance, please read Where can I find the required information?

That's it! Skrill is now successfully set up as your payment provider.

What information is needed?

Merchant ID: From your Skrill account

Pay to Email: From your Skrill account

Secret Word: Important parameter used to verify payment responses from Skrill.

Password for MQI/API: Important parameter used to refund an order automatically from your Shopgate Merchant Admin site.

IMPORTANT: Please make sure to enter your "Secret Word" and "Password for MQI/API" correctly. Skrill will lock your account if the Shopgate system tries to communicate with false credentials.

Where can I find the required information?

To find the required information, please first.

"Merchant ID" and "Pay to Email" can be found on the top right corner of your Skrill homepage.

"Secret Word" and "Password for MQI/API" can be found underSettings > Developer Settings. If you don't already have a secret word or password, create them here.

IMPORTANT: The secret word or password should NOT be the password you use to log in to your Skrill account.

Two sets of URLs are supported on your Shopgate mobile website:one within the Shopgate domain, andone within your shop's domain.In this article, we will help you set up both URLs for your mobile website. clear your shop's cache.

Getting started

Your Shopgate mobile website can be accessed via two different URLs. Both of them point to your Shopgate mobile website.

Your Shopgate URLis a Shopgate subdomain named after your shop alias

https://your-shop-alias.shopgate.com

Your domain's URLis a mobile subdomain of your shop's domain

https://m.your-shop-domain.com

Auto-created with the alias you registered with*.

Does NOT require a domain.

URL is always available to you.

"your-shop-alias"is customizable.

Customizable in your Shopgate Admin.

* Where can I find my shop alias?

Requires setup in your domain host.

Requires a domain host and backend access.

URL is available as long as your shop domain is valid.

Completely customizable.

Set up in your domain host and Shopgate Admin.

Better SEO and conversion rate.

To customize or set up the URLs for your mobile website, continue reading.

Customizing the URLs of your mobile website

Customizing your Shopgate mobile URL

Follow the steps here to customize your Shopgate mobile URL:

https://your-shop-alias.shopgate.com

Log in to your Shopgate Admin.

Navigate to SettingsMobile Website.

Edit your Shopgate Alias.

That's it! Your Shopgate Domain (URL for your mobile website) will reflect the change immediately.

Setting up a mobile subdomain in your shop's domain

Follow the steps here to set up your own mobile subdomain for your mobile website:

https://m.your-shop-domain.com

Step 1. Pick a mobile URL within a domain of your shop

A normal practice is to use the subdomain "m" or "mobile":

m.your-shop-domain.commobile.your-shop-domain.com

Step 2. Add a CNAME record in your domain host

To map your mobile website to your shop's domain, a CNAME (Canonical Name) record needs to be added. This requires admin access to your domain (NOT your Shopgate Admin).

To explain this, we are showing you an example below.Depending on your hosting/registrar company, configuring your mobile URL could vary from the steps here:

In this example, we will add a CNAME to create the customized mobile URL m.myawesomeshop.com.

First, go to your hosting/registrar company website and select the correct domain.

Locate the page for updating your domain's DNS records. The page could beDNS Management, Name Server Management,Advanced Settingsor similar, depending on your domain service provider.

Add a new CNAME record.

Enter m (stands for mobile) as the "Host name" of your mobile URL.

Select typeCNAMEto specify this is a CNAME record.

Enter your-shop-alias.shopgate.com as the Destination. Where can I find my shop alias?

Click Add New Entry to save.

Step 3. Verify the configuration

Log into your Shopgate Admin.

Navigate to SettingsMobile Website.

Slide Custom Domain to ON.

Enter your own mobile URL in "Your Mobile Domain."

Click Verify & Saveand wait for a success message to show.NOTE: Your custom domain changes may take up to 30 minutes to go into effect.

That's it! You have successfully set up yourown mobile subdomain for your mobile website.

Entering your mobile URLs in the shopping cart backend

Many shopping cart systems require that you enter your mobile URLs into the backend.This varies in each system; however, the general steps are as follows:

Log into your shopping cart systembackend and find the Shopgate plugin/module/extension.

ClickSettingsof the Shopgate plugin.

Find the section named "Mobile Website," "Mobile Redirect," or something similar.

To enter your Shopgate mobile URL:

Look for a field named "Shopgate Alias," "Shop Alias," or something similar. This should normally be on the top.

Enter your Shopgate alias.

To enter the mobile URL of your shop's domain:

Look for a field named "Custom URL to mobile webpage," "CNAME," or something similar.

Enter your mobile URL here in the form of https://m.your-shop-domain.com. Use your shop's domain instead of the "your-shop-domain.com" here.

Frequently Asked Questions

My mobile website is showing a "404 page"after I set up the URL. What should I do?

If you have recently created a CNAME entry, and your mobile URL has been verified, but you still see a 404 page on your mobile website, don't panic - simply

I don't have a shop domain. What should I do?

If you don't have a shop domain, you don't need to set up your own mobile URL. When you registered with Shopgate, a mobile website within the Shopgate domain has already been reserved for you.

For example, if your shop is called My Awesome Shop, the URL https://myawesomeshop.shopgate.com is likely to be reserved for your mobile website at Shopgate. Your customers will be able to browse products and place orders here as soon as your mobile website is set to live.

Should I use my own mobile URL under my shop's domain?

We highly recommend using your own mobile URL for your Shopgate mobile shop because of the many benefits it reaps. These include but are not limited to:

Better Search Engine OptimizationThe biggest benefit of using your own mobile URL is that this practice optimizes the visibility of your mobile website in search results. When your own mobile URL is used, your mobile website is more likely to appear with a higher rank on the search results page. This means that when your customers and potential customers search for your shop in Google or other search engines on their smartphone, your mobile website will be more likely to be found.

Better Conversion RateAnother big benefit is that your customers will be more likely to remember the URL for your mobile website. This will, in turn, generate more purchases and revenues for you.

Better CredibilityUsing your own mobile URL will also make your shop look more trustworthy.

The Shopgate plugin installed in your shopping cart system imports your products and categories. All product information is transferred to the database using XML or CSV files.

Below you can find out more information about how Shopgate imports products and categories for your mobile shop.

General workflow

The general workflow of a product and category import looks like this:

When an import request is triggered, an XML or a CSV file that contains lists of your products and categories will be generated.

Your XML or CSV files will then be downloaded to the Shopgate backend.

The files will first reach the work queue where import requests from all Shopgate mobile shops will be processed. When it is your turn, your product/category information will be written in our database.

Your shop will then be updated with the latest products and categories.

How do I troubleshoot missing or outdated products?

Automatic import

When a connection is created between your plugin and Shopgate, all products and categories will be automatically imported for the first time.

After this occurs, your shop is automatically queued in our smart pipeline system. Our system then schedules an import for your shop periodically. This service runs 24/7, 365 days a year to make sure your products and categories are updated in a timely manner.

Manual import

We understand that sometimes one product may move faster than the others, or maybe you wish to make a major change in products and/or categories immediately. Don't sweat it: we have provided a manual import option to you.

To learn how, please read How do I start a product import manually?

For more troubleshooting guidance on product import, please read

Facebook Developer Products are available* on Shopgate.

*Please make sure that your apps are published in the app stores as most Facebook products work with apps.

In this article, you will learn how to create and connectyourFacebook Developer Account to your mobile shop. Follow the steps below to get your account ready to use with Facebook Analytics.

Getting started

Registering as a Facebook Developer

To get started, register your Facebook account as a Facebook Developer.If you already have a Facebook developer's account, skip this section.

First, click here and then click Register on the top right.

Accept the Facebook Policies and click Register. On the next screen, click Done to finish the registration.

Facebook developer's account

Now you have registered a Facebook Developer account. Please continue to create a Facebook App ID.

Creating a Facebook App ID

To create a Facebook App ID, follow the steps below:

On your Facebook Developer's account, click Add a New App on the top right.If you have just registered a Developer's account, you will be taken to create an App ID directly.

The "Add a New App" screen will appear. Clickbasic setup. We will set up the platforms later

3. Enter a Display Name for your app and a Contact Email.Click Create App ID.

Now you have created a Facebook App ID. Please continue to make it public.

Publishing your App

To make your app available to the public, publish it by following the steps here:

Navigate to App Review on the left.In case you have multiple apps under the same account, switch between them on the top left corner. Make sure the correct app is selected.

On top of the screen, find the section "Make My Awesome Shop public?" and slide the button to YES. Click Confirm on the "Are you sure..." pop-up.

After your app is published, these options will be approved automatically:

email

public_profile

user_friends

This permits your mobile shopping app to access a user's email address, public profile, and friend list.

Now you have successfully created and published a Facebook App.

Enabling Facebook Analytics for your App

To set up Facebook Analytics for Apps, follow the steps below:

Log in to your Shopgate Admin page.

ClickSettingson the menu bar, then select Tracking Tools.

Locate the"Facebook Analytics for Apps" section and turn it to ON.

A pop-up will open. Enter your Facebook App ID and click Save.

That's it! You have successfully set up your Facebook Analytics for Apps.

Enabling the Facebook Login

Connecting Facebook to your Shopgate admin

To connect yourFacebook Developer account to Shopgate, enter the App ID and App Secret in the merchant admin following the steps below.

Log into your Shopgate Admin and navigate to Settings, then Facebook.

In the section Configuration,enable Facebook Login and enter the App ID and App Secret. Click Save. Where can I find my App ID and App Secret?

Now clickShow App Info to reveal your Facebook app information. You will need the information to add platforms and set up Facebook Login.

Enabling mobile platforms

Now go to your Facebook App to enable 3 platforms: iOS, Android, and Mobile Website.

Navigate to Settings on the top left.

In case you have multiple apps under the same account, switch between them on the top left corner. Make sure the correct app is selected.

2. Click + Add Platformat the bottom of the page.

3. Select your platform Website, iOS, and Android one by one here. Fill out the forms (shown below) with the information from the previous chapter and click Save Changes.

3a.SelectWebsite. Enter yourSite URL.

3b.Select iOS. Enter your Bundle ID and iPhone Store ID

3c. Select Android. Enter Google Play Package Name, Class Name, and Key Hashes.

Now you have successfully added all the platforms you need for your mobile shop.

Requesting an app update

After connectedyour Facebook Developer App to your Shopgate mobile shop, please request an update for your Shopgate apps.

We will compile the Facebook SDK into yourapps and submit them to the app stores.

Frequently Asked Questions

Where can I find my Facebook App ID and Secret?

On your, you will be able to find your App ID and the App Secret.

Navigate to Dashboard on the top left.

Your App ID and App Secret will show here. Click Show to reveal and copy the App Secret.

When can I use the Facebook features?

After you have configured your Facebook Developer App by following this documentation, your Shopgate mobile app will be re-complied and submitted to the app stores.This process could takeup to two weeks.

Your Facebook features will be available once the process is finished.

If you're based in the US and need to update your payment method, please contact Shopgate support.

Available payment types and countries

If you have a German PayPal Business Account, you are eligible to use PayPal PLUS.

First, please note that if you set up PayPal Plus for your mobile website, PayPal will only show as a payment method on your app.

Here are the PayPal options available to you based on your country:

PayPal

Direct Debit

Credit Card

Invoice

USA

Yes

No

Yes

No

UK

Yes

No

Yes

No

Germany

Yes

Yes

Yes

Yes

Austria

Yes

No

Yes

No

Switzerland

Yes

No

Yes

No

Poland

Yes

No

Yes

No

France

Yes

No

Yes

No

Collect information

Prepare the following information before you set up PayPal PLUS as a payment at Shopgate.

If you don't have a PayPal Business account,select Geschftlich and fill out the form here.

Account Info

Description

Client ID

Secret

These are live API credentials from your PayPal PLUS account. You can find them under My Apps & Credentials in your PayPal Developer account. If these credentials are not displayed, you need to generate them first.

PayPal Express button

You can choose whether or not to show the PayPal Express button in your app. You can show it in the cart only, or in the cart and on the product detail page.

Is invoice payment activated in your PayPal account?

Select Yes if you have activated the invoice payment method in your PayPal account. After that is selected, we will add the payment badge labeled "Invoice" to the footer of your mobile website.

Should Shopgate process refunds on PayPal PLUS?

You can choose whether or not to process refunds on PayPal PLUS.

Additional Settings

Use the additional settings to apply free shipping for this payment method, additional charges or discounts,or to restrict the usage of this payment by setting a minimum/maximum order amount.

For more assistance, read Setting up additional fees and discounts of a payment.

Set up PayPal PLUS

Add PayPal PLUS as a payment method

Log in to your Shopgate Admin and navigate to Settings Payment.

Find the "Add payment method" section, start typing "Paypal, Lastschrift, Kreditkarte, Rechnung" and select it from the list when it appears.

Enter your PayPal PLUS account information in the pop-up window and click Save. Your account information will be validated automatically.

Set up a Webhook in PayPal Apps

Status updates from a PayPal PLUS payment are done via a webhook. This ensures that you see the correct payment status in your mobile shop. To set up this webhook, follow the steps here:

In your PayPal Developer account, go to My Apps and Credentials.

In the section labeled "REST API apps," select the app you want to use for your Shopgate mobile shop.

In your app details page, find the section labeled"LIVE WEBHOOKS" and add a new Webhook by clicking Add Webhook.

Copy the URL below and paste it into the field Webhook URL. Select all event types and click Save.https://api.shopgate.com/payment/ppplus_notify

That's it! PayPal PLUS is now successfully set up as apayment method for your mobile shop.

Frequently Asked Questions

How do I generate the Client ID and secret?

To generate the Client ID and Secret for the first time, you need to create a REST API app.

In your PayPal Developer account, go to My Apps and Credentials.

In the section labeled "REST API apps", create an app by clicking Create App.

Enter an app name, connect your facilitatoraccount (DE), and click Create App.

Your Client ID and Secret are now generated. Please select Live, copy the live API credentials, and enter them into your Shopgate admin in the next step.

Why aren't the Shopgate payment statuses updated?

If your Shopgate payments show incorrect payment status, make sure that:

The webhook is set up and configured correctly in your PayPal account.

The Client ID and secret are live API credentials.

https is used in the webhook URL--a secure connection is required from PayPal and Shopgate.

For more information, please read Set up a Webhook in PayPal Apps.

Can I use the same Client ID in all my Shopgate shops?

If you manage several shops via your account at Shopgate, only one Client ID is needed.You can enter the same Client ID in all your Shopgate shops.

Do I need to refund my customers manually after I cancel an order?

No. You don't need to refund the money manually via your PayPal PLUS account. The refund is handled automaticallywhen you cancel an order.

If your company is, or recently changed its legal status to, a Corporation (Corp., Inc.), Limited Liability Company (LLC, LC, Ltd. Co.), or a legal entity (GmbH, AG, KG, oHg, etc.),you must enroll as an organization or your app will be rejected inthe next update. Apple cannot see that the app and the company belong together if you don't do this.

Submit an account update request

Navigate to Apple's contact form

To convert your account type, submit a request to Apple Developer Program Support.

Open the Contact Us form from the Apple Developer Program.

Log in with theApple ID and Password associated with your existing Apple Developer Program, if necessary.

[email protected]

Fill out the form

Select your Region.

Choose Account Updates and Renewalsas your Subject.

Fill out the Message following this model:

"I would like to convert my account type from Individual to Organization. My company currently does not hold an active Organization membership.

Please refer to the information provided below. Should you have any questions, please feel free to contact the phone number listed. Thank you!"

Name: CEO's First and Last Name.

Organization Name: Your Company Name, including the entity type Inc., Corp., LLC, LC, Ltd. Co., etc. This name will show up in the App Store as your app's seller/developer name.

Account Type: Company / Organization.

D-U-N-S Number: What is a D-U-N-S number and where can I find it?

Address: Your Company Address.

Phone Number: A phone number that Apple can reach you for additional questions or account verification.

ClickSend.

Within the next two weeks, Apple will call the phone number listed to verify your enrollment. Please make sure to notify the person who is going to answer the call.

Complete the process and notify Shopgate

After Apple calls and verifies your enrollment, you will receive an email from Apple asking you to fill out additional information about your organization. Please follow the instructions in the email accordingly.

Please send a short email to [email protected] indicating that you have completed the whole process.

That's it! Now you have converted your Apple Developer Program from an individual account to an organization account.

For more information on Apple Developer account, please visit Apple Developer Support.For more questions about the enrollment process, please contact us at [email protected].

Frequently Asked Questions

Should I enroll as an individual ororganization?

If your company is a Corporation (Corp., Inc.), Limited Liability Company (LLC, LC, Ltd. Co.), or a legal entity (GmbH, AG, KG, oHg, etc.), you must enroll as an organization or your app will be rejected.

Having an organizational membership with the Apple Developer Program gives you several advantages. For example, your company brand name will appear below the app name in theApp Store, and you can invite additional developers to your team within your account.

However, if you are a sole proprietorship or a single person company, you must enroll asan individual.

What is a D-U-N-S number and where can I find it?

The D-U-N-S Number is a unique nine-digit number that identifies business entities on a location-specific basis. Assigned and maintained by Dun & Bradstreet (D&B), the D-U-N-S Number is widely used as a standard business identifier.

While many types of businesses can receive a D-U-N-S Number, your business must be recognized as a legal entity (e.g., a corporation, limited partnership, limited liability company) to enter into the legal terms and obligations of Apple Developer Program agreements. DBAs, fictitious businesses, trade names, and branches are not accepted.

D&B may have already assigned your organization a free D-U-N-S Number. Before enrolling, check if you already received one using the D-U-N-S Number lookup tool.

What should I do if I can't find my D-U-N-S number?

If your company is not listed here, youcan submit your information to Dun & Bradstreet for a free D-U-N-S Number. You will be asked for the following information when requesting a D-U-N-S Number using the D-U-N-S Number lookup tool:

Legal entity name

Headquarters address

Mailing address

Your work contact information

As part of their verification process, a D&B representative may contact you for more information (e.g., type of business, the number of employees). Please have your business registration documents ready.

Can I enroll as an individual and have my company appear as the seller on the App Store?

No. To have your company name appear as the seller, you must enroll as an organization and your company must be recognized as a legal entity. If you are a sole proprietor/single person business, you must join as an individual and your legal name will appear as the seller.

If you have enrolled as an individual and need to convert your individual membershipto an organization membership, please contact us at

How much does a membership cost?

The Apple Developer Program membership is $99 per membership year in the United States and 99 in Europe. This cost is the same for an individual membership and an organizational membership.

To provide a long-standing app, you must renew and pay for your membership every year.

This article is for you if your company is a Corporation (Corp., Inc.), Limited Liability Company (LLC, LC, Ltd. Co.), or a legal entity(GmbH, AG, KG, oHg, etc.). If you are a sole proprietorship or a single person company, refer to this article instead.

Follow the entire process outlined below very closely. An incomplete setup could result in the removal of your app from the App Store. If you would like a hard copy of this article to take notes on, you can download the PDF version here.

A membership in the Apple Developer Program is mandatory to distribute an iOS app on the App Store. All merchants who wish to publish an iOS app are required to enroll in the Apple Developer program. In addition, your iOS app must be published under your company name (your own Apple Developer account).

In this article, we will walk youthrough the process to enroll in the Apple Developer Program as an organization and transfer your existing iOS app to your Apple Developer account.

[email protected]

Set up at Shopgate

Enroll in the Program

Create an Apple ID

Create an Apple ID

Use an existing email addressassociated with your company to create an Apple ID.We recommend using an email address that multiple people in the company can access, such as your support or info email. If you don't have a company email address, please create one first.

Go to Create Your Apple ID.

Enter your company email in the form and fill out the rest.

This email will be your new Apple ID. Apple will send important actions or decisions regarding your app to this email. Please make sure to check the emails regularly.

A 6-digit verification code will be sent to you via email. Enter the code in the pop-up that opens. Please note that this code will expire three hours after the email was sent.

Your Apple ID is created.

Please be aware that creating an Apple ID is not the same as creating an Apple Developer account.

Enroll in the Program

Once your Apple ID is created, open the Apple Developer Program Enrollment page.

1. Start Your Enrollment

Click Start Your Enrollmentand sign in with your new Apple ID.

Read and agree to the Apple Developer Agreement. Click Submit.

Now your Apple Developer Program will open. On the Welcome page, select the block "Join the Apple Developer Program." On the next page, click Enroll.

In the field "I develop apps as," select Company/Organizationas yourEntity Type. Click Continue.

Enter your Organization Information on the next screenand click Continue.

Select My organization has given me the authority... to have Apple contact a senior employee at your organization (instead of the owner/founder) to verify your enrollment. Enter that employee's contact info in "Verification Contact."Make sure to enter a phone number that Apple can reach you.

Legal Entity Name Your company nameincluding the entity type, such as Inc., Corp., LLC, LC, Ltd. Co., etc.

D-U-N-S Number You might be able to find your D-U-N-S numberin Shopgate Admin under Native AppsApple Developer account or your profile picture (top right)My Account. If this number is not available, you can look it up using the D-U-N-S Number lookup tool.

Website Your company website.

Headquarters Phone Number - Entera number whereApple can reachyou. Apple WILL call to verify your enrollment. If you are the owner/founder, make sure to enter anumber where Apple can reach you.

Your Work Email

Review your enrollment details on the next screen. If everything is correct, click Submit.

Within the next two weeks, Apple will call the "Verification Contact" or your "Headquarters Phone Number" to verify your enrollment. Please make sure to notify the person who is going to answer the call.

2. Confirm&Pay

If the verification is successful, a confirmation will be sent to your Apple ID email address. In this confirmation email, a link will be provided to confirm and pay for your Apple Developer membership.

In the email, click Review Now. This will open the "Review and Accept" screen of your Apple Developer Program Enrollment.

Log in with your Apple ID and password.

Accept the Apple Developer Program License Agreement by checking the box on the bottom of the page and clicking Continue.

On the next screen, review your purchase details and select the option Automatic Renewal.

If Automatic Renewal is not used, please set a reminder on your calendar (repeat yearly) to renew your membership every year. Your app will be removed from the App Store within 24 hours upon the expiration of your membership.

You will now be forwarded to the App Store. Login again with the same Apple ID and password.

On the next screen, pay $99 with your credit card and click Continue.

Accept the Terms & Conditions and click Continue. Follow the onscreen instructions until you see the "Thank you" page.

Now you have enrolled successfully in the Apple Developer Program. You will receive two welcome emails and a payment confirmation from Apple at your Apple ID email address within anhour or so.You'll be notified at the email address associated with your Apple ID.

Set up at Shopgate

As soon as you finished all the steps above, enter your Apple Developer account information at Shopgate.

Log into your Shopgate Admin.

Navigate to Settings Native Apps Apple Developer Account.

SelectCompany/Organizationand click Continue.

Enter the following information:

Your Apple ID

Team Name, Team ID displayed atDeveloper Account Membership

The team name is normally the legal entity name but can also be a registered DBA (doing business as) name.

InviteShopgate

Your Shopgate App team works hard to create and update your app. In order for our team members to do their job, please invite Shopgate as an admin on your App Store Connect.

Log into your App Store Connect, clickUsers and Access.

Under People, click the Add button .

The "New User" page will open. Enter the user information for Shopgate and click Next.

First name: Shopgate

Last Name: Inc.

Email:Use the email address you just copied (Shopgate AdminSettings Native Apps Apple Developer Account "Invite as Admins" email address)

Then Confirm Setup.

Select Adminas the User Role.

Click Invite.

The Shopgate App team will receive an email and accept the invitation shortly.

That's it! Now you have finished setting up your Apple Developer account! Wewill transferyour iOS app within the next few days. You will get an email confirmation from Apple once this process is complete.

For more information on Apple Developer account, please visit Apple Developer Support.For questions on the enrollment process, please contact us at [email protected].

Frequently Asked Questions

Should I enroll as an individual ororganization?

If your company is a corporation (Corp., Inc.), limited liability company (LLC, LC, Ltd. Co.), or a legal entity (GmbH, AG, KG, oHg, etc.), you must enroll as an organization or your app will be rejected.

Having an organizational membership with the Apple Developer Program gives you several advantages. For example, your company brand name will appear below the app name in theApp Store, and you can invite additional developers to your team within your account.

However, if you are a sole proprietorship or a single person company, you must enroll asan individual.

What is a D-U-N-S number and where can I find it?

The D-U-N-S Number is a unique nine-digit number that identifies business entities on a location-specific basis. Assigned and maintained by Dun & Bradstreet (D&B), the D-U-N-S Number is widely used as a standard business identifier.

While many types of businesses can receive a D-U-N-S Number, your business must be recognized as a legal entity (e.g., a corporation, limited partnership, limited liability company) to enter into the legal terms and obligations of Apple Developer Program agreements. DBAs, fictitious businesses, trade names, and branches are not accepted.

D&B may have already assigned your organization a free D-U-N-S Number. Before enrolling, check if you already received one using the D-U-N-S Number lookup tool.

What should I do if I can't find my D-U-N-S number?

If your company is not listed here, youcan submit your information to Dun & Bradstreet for a free D-U-N-S Number. You will be asked for the following information when requesting a D-U-N-S Number using the D-U-N-S Number lookup tool:

Legal entity name

Headquarters address

Mailing address

Your work contact information

As part of their verification process, a D&B representative may contact you for more information (e.g., type of business, the number of employees). Please have your business registration documents ready.

Can I enroll as an individual and have my company appear as the seller on the App Store?

No. To have your company name appear as the seller, you must enroll as an organization and your company must be recognized as a legal entity. If you are a sole proprietor/single person business, you must join as an individual and your legal name will appear as the seller.

If you have enrolled as an individual and need to convert your individual membershipto an organization membership, please contact us at

How does the enrollment work?

When enrolling as an organization, you can review the license agreement and purchase a membership afterApple Developer Support has verified yourenrollment and sent you an email with the next steps. You can check your enrollment status in your Apple Developer Program. Be sure to sign in with the Apple ID you used to enroll.

Individuals and sole proprietors/single person businesses can review the license agreement and purchase a membership at the time of enrollment.

How much does a membership cost?

The Apple Developer Program membership is $99 per membership year in the United States and 99 in Europe. This cost is the same for an individual membership and an organizational membership.

To provide a long-standing app, you must renew and pay for your membership every year.

All merchants who wish to publish an Android app are required to register for a Google PlayDeveloper account.

We strongly recommend that you follow the entire process outlined below very closely. An incomplete setup could result in the removal of your app from the Google Play Store. To get a hard copy of this article to take notes on, download and print a PDF copy here.

In this article, we will walk you through the process to register and set up a Google Play Developer account.

Why do I need a Google Play Developer account?

Register and Setup Google Play Developer account

Frequently Asked Questions (FAQ)

3.1 Should I use my existingGoogle Play Developer account?

3.2 Should I create a separate Google account for my Android app with Shopgate?

1. Why do I need a Google Play Developer account?

In compliance with Google's distribution agreement, all merchants who wish to publish an Android app are required to register for a Google Play Developer account under their own company name.

If your Android app is currently not published under your name or your company name, it must be transferred to your own Google Play Developer account by following the steps below.

2. Register and Setup Google Play Developer account

[email protected]

Step 1: Create a Google accountusingan existing email address associated with your company.

We recommend using an email address that multiple people in the company can access, such as your support or info email.

If your existing company email is already a Gmail account, skip ahead to step 2.

If your existing company email is non-Gmail, or if you don't have a company email address, go to this page to Create your Google Account.

Enter your company email in the field "Your email address" and fill out the form.Google will send important actions or decisions regarding your appto this email. Please make sure to check this inbox regularly.

Go through the verification process. You will get a code via email or phone to verify your account. Additional help can be found on Google Account Help.

Step 2: Apply for a Google Play Developer account.

Once your new Google account is verified, open the Google Play Developer Console tofinish the registration.

Sign in with your Google account.

Read and agree to the Developer distribution agreement. Click Continue to Payment.

Pay the $25 USD non-recurring registration fee for your account with your credit card.

Complete your account details.

Your developer name, email address, and website will be displayed on the Google Play Store page of your app.

Developer namePlease enter your company name.This is displayed as the name of the publisher.

Email addressPlease enter your support email so your app users can reach you.

WebsiteYour company website.

Phone numberGoogle should be able to contact you at this number if any problems come up with your app. This is not displayed publicly.

When your registration is verified, you'll be notified at the email address associated with your Google Play Developer Console. It normally happens within half an hour, but may take up to 48 hours.

Once you have an account at Google Play Developer Console, make sure to enter aphysical address.

In your Google Play Console, go to Settings.

On the page that opens (Developer account Account details), enter a valid current address where Google can contact you.

Click SAVE on the top right.

Step 3: InviteShopgate as a"Release manager."

Your Shopgate App team works hard on releasing your Android app to the Google Play Store. In order for our team members to do their job, please invite Shopgate as your "Release manager."

In your Google Play Console, go to Settings Users & Permissions Invite new user.

On the "Invite a new user" screen, enter the following information, then click Send Invitation.

Email: [email protected]

Access expiry date: Never

Role: SelectRelease managerWe need this for creating and updating your app.

Permissions: Global

After the invitation is sent, the Shopgate App team will receive an email and accept the invitation shortly.

Step 4: Grant API access (Service Account).

Shopgate uses an Automated App Service to update your app regularly. In order to do so, the Shopgate technology needs access to your Google Play Developer API.

In your Google Play Console, go to Settings API access, and click the buttonCreate new project.If you don't see the button on the API access page, skip ahead to point 3.

The "API Access" page will open.Please be aware that this page could take a few minutes to load.

Click Create Service Account. This will open a pop-up.

Click Google API Consolein the pop-up. This will open a newtab in your browser.

Click Create service accountand enter the following in the pop-up that opens:

Service account name: Entersg-service-accountThis will automatically populate the "Service account ID" field.

Role: Select Project Owner

Checkbox: Check Furnish a new private key

Key type: SelectJSON

Click Create. A file named "Google Play Android Developer-XXXXXXXXXX.json"will start to download. Save this JSON file and upload it to Shopgate in the next step.Depending on your browser settings, the file may start to download automatically or ask you for permission to start the download.

Close the pop-up. You'll see the new service account created. You can close this tab now.

Switch back to the pop-up you left open at step 4. Now click Done.

Under the section "Service Accounts Permissions," make sure to allow all the permission options except "View financial data" or "Manage orders." Click Add user.

You'll be redirected to theUsers & permissions page. The new service account should now be listed here.

Step 5: Enter Information at Shopgate

As soon as you have finished steps 1 to 4, please enter your Google Play Developer account information and upload the JSON file (downloaded inthe previous step) to Shopgate.

Log into your Shopgate Admin.

Navigate to Settings Native Apps Google Play Developer Account.

Enter the following information:

Developer Name The company name entered in your Developer Profile in step 2.

Email Address Google Account created in step 1.

Transaction ID Your Transaction ID is available on your Google account at payments.google.com. Also referred to as theGoogle Order number, this Transaction ID is emailed to you from Google Payments right after the $25 registration fee is paid. A Transaction ID is typically in one of the following formats:

01234567890123456789.token.0123456789012345

0.G.123456789012345

registration-1234ab56-7c89-12d3-4567-8e91234567f8

01234567890123456789.registration-1234ab56-7c89-12d3-4567-8e91234567f8

Upload the JSON file "Google Play Android Developer-XXXXXXXXXX.json"which was downloaded in the previous step.

Click Confirm Setup to confirm that you have finished everything outlined above.

That's it! Now you have finished setting up your Google Play Developer account! Wewill transferyour Android app within a few days. You will get an email confirmation from Google once this process is complete.

For more information on Google Play Developer account, please visit Google's Developer Console Help.For more questions about the overall enrollment process, please contact us at .

3. Frequently Asked Questions (FAQ)

3.1 Should I use my existingGoogle Play Developer account?

In order to publish your app,Shopgate will need to be invited as a Release Manager with "Global" permissionin your Google Play Developer account.If you're concerned about Shopgate having access to your other appson this account, please register a new Google Play Developer account.

Keep in mind that a"developer name" (the company name in this case) can only be used once in the Developer Profile. When applying for a second Google account, you could try to add a dash or spacein your company name.

3.2 Should I create a separate Google account for my Android app with Shopgate?

In general, it is not recommendedto use apersonalGoogle account to connect to your Google Play Console.If your existing Google account is associated with your Google Play Console, andyou're concerned about Shopgate having access to the other appsin this console, you should create a separate Google account.

All merchants who wish to publish an iOS app are required to enroll in the Apple Developer program.

In this article, we will walk you through the process to enroll in the Apple Developer Program as a company or organization.

[email protected]

Set up at Shopgate

Enroll in the Program

Create an Apple ID

Create an Apple ID

Use an existing email addressassociated with your company to create an Apple ID.We recommend using an email address that multiple people in the company can access, such as your support or info email. If you don't have a company email address, please create one first.

Go tothis pageto Create Your Apple ID.

Enter your company email in the form and fill out the rest. This email will be your new Apple ID. Apple will send important actions or decisions regarding your app to this email. Please make sure to check the emails regularly.

A 6-digit verification code is sent to you via email. Enter the code in the pop-up that opens. This code will expire three hours after the email was sent.

Your Apple ID has been created. Please be aware that creating an Apple ID is not the same as creating an Apple Developer account.

Enroll in the Program

Once your Apple ID is created, open the Apple Developer Program Enrollment page.

1. Start Your Enrollment

Click Start Your Enrollmentand sign in with your new Apple ID.

Read and agree to the Apple Developer Agreement. Click Submit.

Now your Apple Developer Program will open. Select the block Join the Apple Developer Programon the Welcome page and click Enroll on the next page.

In the field "I develop apps as," select Company/Organizationas yourEntity Type. Click Continue.

Enter your Organization Information on the next screenand click Continue.

Select My organization has given me the authority... to have Apple contact a senior employee at your organization (instead of the owner/founder) to verify your enrollment. Enter that employee's contact info in "Verification Contact." Make sure to enter a phone number where Apple can reach you.

Legal Entity Name Your company nameincluding the entity type, such as Inc., Corp., LLC, LC, Ltd. Co., etc.

D-U-N-S Number You might be able to find your D-U-N-S numberin Shopgate Admin underNative AppsApple Developer accountoryour profile picture (top right)My Account. If this number is not available, you can look it up using the D-U-N-S Number lookup tool.

Website Your company website.

Headquarters Phone Number - Entera number whereApple can reachyou. Apple WILL call to verify your enrollment. If you are the owner/founder, make sure to enter anumber where Apple can reach you.

Your Work Email

Review your enrollment details on the next screen. If everything is correct, click Submit.

Within the next two weeks, Apple will call the "Verification Contact" or your "Headquarters Phone Number" to verify your enrollment. Please make sure to notify the person who is going to answer the call.

2. Confirm&Pay

If the verification is successful, a confirmation will be sent to your Apple ID email address. In this confirmation email, a link will be provided to confirm and pay for your Apple Developer membership.

In the email, click Review Now. This will open the "Review and Accept" screen of your Apple Developer Program Enrollment.

Log in with your Apple ID and password.

Accept the Apple Developer Program License Agreement by checking the box on the bottom of the page and clicking Continue.

On the next screen, review your purchase details and selectAutomatic Renewal.

If Automatic Renewal is not used, please set a reminder on your calendar (repeat yearly) to renew your membership every year. Your app will be removed from the App Store within 24 hours upon the expiration of your membership.

You will now be forwarded to the App Store. Login again with the same Apple ID and password.

On the next screen, pay $99 with your credit card and click Continue.

Accept the Terms & Conditions and click Continue. Follow the onscreen instructions until you see the "Thank you" page.

Now you have enrolled successfully in the Apple Developer Program. You will receive two welcome emails and a payment confirmation from Apple at your Apple ID email address within anhour or so.

You'll be notified at the email address associated with your Apple ID.

InviteShopgate

Your Shopgate App team works hard to create and update your app. In order for our team members to do their job, please invite Shopgate as an admin on your App Store Connect.

Log into your App Store Connect, clickUsers and Roleson top of the Users list.

The "Add App Store Connect user" page will open. Enter the User Information for Shopgate and clickNext.

First name:Shopgate

Last Name:Inc.

Email: The email address to invite to your developer account can be found by logging in to your Shopgate Admin and going to Settings Native Apps Apple Developer Account To be used for "Invite as Admins"

Select Adminas the "User Role".

Place a check in the box forAccess to Certificates, Identifiers & Profilesin the Developer Resources section and clickInvite.

The Shopgate App team will receive an email and accept the invitation shortly.

Set up at Shopgate

As soon as you finished all the steps above, enter your Apple Developer account information at Shopgate.

Log into your Shopgate Admin.

Navigate to Settings Native Apps Apple Developer Account.

SelectCompany/Organizationand click Continue.

Enter the following information then Confirm Setup.

Your Apple ID

Team Name, Team ID displayed atDeveloper Account Membership.

The team name is normally the legal entity name but can also be a registered DBA (doing business as) name.

That's it! Now you have finished setting up your Apple Developer account! Wewill create and upload your iOS app within a few days. You will get an email confirmation from Apple once this process is complete.

For more information on Apple Developer accounts, please visit Apple Developer Support.For questions about the enrollment process, please contact us at [email protected].

Frequently Asked Questions

Should I enroll as an individual ororganization?

If your company is a corporation (Corp., Inc.), limited liability company (LLC, LC, Ltd. Co.), or a legal entity (GmbH, AG, KG, oHg, etc.), you must enroll as an organization or your app will be rejected.

Having an organizational membership with the Apple Developer Program gives you several advantages. For example, your company brand name will appear below the app name in theApp Store, and you can invite additional developers to your team within your account.

However, if you are a sole proprietorship or a single person company, you must enroll asan individual.

What is a D-U-N-S number and where can I find it?

The D-U-N-S Number is a unique nine-digit number that identifies business entities on a location-specific basis. Assigned and maintained by Dun & Bradstreet (D&B), the D-U-N-S Number is widely used as a standard business identifier.

While many types of businesses can receive a D-U-N-S Number, your business must be recognized as a legal entity (e.g., a corporation, limited partnership, limited liability company) to enter into the legal terms and obligations of Apple Developer Program agreements. DBAs, fictitious businesses, trade names, and branches are not accepted.

D&B may have already assigned your organization a free D-U-N-S Number. Before enrolling, check if you already received one using the D-U-N-S Number lookup tool.

What should I do if I can't find my D-U-N-S number?

If your company is not listed here, youcan submit your information to Dun & Bradstreet for a free D-U-N-S Number. You will be asked for the following information when requesting a D-U-N-S Number using the D-U-N-S Number lookup tool:

Legal entity name

Headquarters address

Mailing address

Your work contact information

As part of their verification process, a D&B representative may contact you for more information (e.g., type of business, the number of employees). Please have your business registration documents ready.

Can I enroll as an individual and have my company appear as the seller on the App Store?

No. To have your company name appear as the seller, you must enroll as an organization and your company must be recognized as a legal entity. If you are a sole proprietor/single person business, you must join as an individual and your legal name will appear as the seller.

If you have enrolled as an individual and need to convert your individual membershipto an organization membership, please contact us at

How does the enrollment work?

When enrolling as an organization, you can review the license agreement and purchase a membership afterApple Developer Support has verified yourenrollment and sent you an email with the next steps. You can check your enrollment status in your Apple Developer Program. Be sure to sign in with the Apple ID you used to enroll.

Individuals and sole proprietors/single person businesses can review the license agreement and purchase a membership at the time of enrollment.

How much does a membership cost?

The Apple Developer Program membership is $99 per membership year in the United States and 99 in Europe. This cost is the same for an individual membership and an organizational membership.

To provide a long-standing app, you must renew and pay for your membership every year.

If you're based in the US and need to update your payment method, please contact Shopgate support.

Accept invoice payments in Germany and Austria with Klarna.

How do I set up Klarna at Shopgate?

Log in to your Shopgate Admin page.

Click Settings from the menu bar, then selectPayment. Klarna account

Find the "Add payment method" section, search for "Klarna", and select it under payment provider from the list.

Enter your Klarna account information in the pop-up window and click Save.

That's it! Klarna is now successfully set up as your invoice payment provider.

What information is needed?

To connect your Klarna account, you need the following information:

EID: This is also known as the Merchant ID or Store-ID, and is provided to you by Klarna.

Secret: This is the Shared secret provided to you by Klarna.

Where can I find the required information?

To find the required information mentioned above, please follow the steps below:

Log in to your .

Click Display store on the left side.

Your EID is theStore-IDon top. The Secret is the Shared secretat the bottom of this screenshot.

Shopgate supports Google Analytics for Firebase in mobile Apps.

Important: Firebase Tracking will only work after a successful app update. For us to update your app, you will need dedicated Developer Accounts at Google and Apple. You can find instructions for that here: App Developer Accounts

Please contact us via mail after the setup is done, so that we can submit updates for the apps. Once Google Analytics for Firebase has been configured for your App, Shopgate will use this Firebase project for sending Push messages on Android via Firebase Cloud Messaging. This change only affects the Push infrastructure - you will not notice the change in the Shopgate Merchant Admin.

Step 1: Set up your Firebase project in the Firebase Console

Recommended: Firebase for Mobile Apps is perfectly complemented with Google Tag Manager.

Create a Firebase Project: Firebase

After choosing the project name, the additional setup of Google Analitycs is preset. To analyze your mobile app, we recommend setting up Google Analytics for Firebase. You can do that in this step, or do it later at any time. Deactivate the setting (bottom left) for later setup and click on "Create project."

Firebase for Mobile Apps: Event Reference for Shopgate Apps

3. After you have set up your Firebase project, you will be redirected to the homepage of your Firebase console andyou can now create your iOS and Android apps in succession.

In this process, Firebase asks for your Android package name and the iOS Bundle Identifier (you do not need to specify your app nickname and App Store ID). These can be found in your Shopgate merchant admin: "Settings" => "Tracking Tools" => "Show App Information."

4. Copy and paste in the information and click on "Register app." Download the current configuration file (one click on the blue button). Shopgate has already done the next steps for you (setup SDK, etc.) and you can always click "Next" until the process is finished. It is expected behavior that at this point Firebase will report not being able to connect to your App. This error will go away once we have recompiled and uploaded the App to the App Stores.This process must be done for iOS and Android separately. Click "Continue to console" to get back to the homepage - go to "Add app" and start the process again with the second app.

5.You should now have two files saved: googleService-Info.plist from your iOS project and google-services.json from your Android project.

6.Navigate to "Project Settings" => "Cloud Messaging."Copy the top server key. You'll need it to configure the Shopgate setup, so your Android users can continue to receive push messages.

Step 1 done! You successfully created your Firebase Project!

Step 2: Connect your Firebase project to your Apps in the Shopgate Merchant Admin

Go to "Settings" => "Tracking Tools."

Insert the server key that you copied from Firebase into the field "FCM server key."

Upload the "google-services.json" file in the Android configuration

Upload the "GoogleService-Info.plist" filein the iOS configuration

Choose how you wish to track your revenue with Firebase. This setting should be identical to your shop settings. If you display gross prices but select "net" then net prices are tracked to Firebase (if available in the Shopgate system).

Step 3: We recompile your app and submit an update for you

Please send us a short mail to [email protected]. The support will take care of everything else.

As soon as the next app update is available in the app stores, you will see the tracking data in Firebase and the connected Google Analytics account.

More information:

Firebase Projects

FAQ - Frequently Asked Questions

Question

Answer

Why don't I see any screen_view events, or only cryptic names instead of screen_views?

The Shopgate App is a hybrid app. In order to be able to always publish latest content quickly and without a lengthy App Store Update process, the presentation layer of your App is served via WebViews. Firebase SDK, unfortunately, doesn't allow WebViews to trigger the reserved event "screen_view" and therefore we can't use this event to track the presentation layer of your app.

So that you can track your shopper's journey and create funnels, we have implemented a custom solution to replace screen_views. Simply use the custom event sg_view_page, which is sent with each screen change of the user.

In this article, we will walk you through the process to register and set up a Google Play Developer account.

Why do I need a Google Play Console account?

Register and Setup Google Play Consoler account

Frequently Asked Questions (FAQ)

3.1 Should I use my existingGoogle Play Console account?

3.2 Should I create a separate Google account for my Android app with Shopgate?

1. Why do I need a Google Play Console account?

In compliance with Google's distribution agreement, all merchants who wish to publish an Android app are required to register for a Google Play Console account under their own company name.

2. Register and Setup Google Play Console account

[email protected]

Step 1: Create a Google accountusing an existing email address* associated with your company.

*We recommend using an email address that multiple people in the company can access, such as your support or info email. If you don't have a company email address, create a Gmail account here. Please note that a Google account is not necessarily an "@gmail.com" account. For example, a user can sign up for a Google account that is associated with their Hotmail or Yahoo email address.A Google account is a user account that can be used to login to allGoogle applications such asGmail, Drive, and Maps.

Step 2: Apply for a Google Play Console account.

Once your new Google account is verified, open the Google Play Console Console tofinish the registration.

Sign in with your Google account.

Read and agree to the Developer distribution agreement. Click Continue to Payment.

Pay the $25 USD nonrecurring registration fee for your account with your credit card.

Complete your account details.Yourdeveloper name, email address, and website will be displayed on the Google Play Store page of your app.

Developer namePlease enter your company name.This is displayed as the name of the publisher.

Email addressPlease enter your support email so your app users can reach you.

WebsiteYour company website.

Phone numberGoogle should be able to contact you at this number if any problems come up with your app. This is not displayed publicly.

When your registration is verified, you'll be notified at the email address associated with your Google Play Console. It normally happens within half an hour, but maytake up to 48 hours.

Once you have a Google Play Console account, make sure to enter aphysical address.

In your Google Play Console, go to Settings.

On the page that opens (Developer account Account details), enter a valid current address where Google can contact you.

Click SAVE on the top right.

Step 3: InviteShopgate as a"Release manager."

Your Shopgate App team works hard on releasing your Android app to the Google Play Store. In order for our team members to do their job, please invite Shopgate as your "Release manager."

In your Google Play Console, go to Settings Users & Permissions Invite new user.

On the "Invite a new user" screen, enter the following information, then click Send Invitation.

Email: [email protected]

Access expiry date: Never

Role: SelectRelease managerWe need this for creating and updating your app

Permissions: Global

After the invitation is sent, the Shopgate App team will receive an email and accept the invitation shortly.

Step 4: Grant API access (Service Account).

Shopgate uses an Automated App Service to update your app regularly. In order to do so, the Shopgate technology needs access to your Google Play Developer API.

In your Google Play Console, go to Settings API access, and clickCreate new project.If you don't see the button on the API access page, skip ahead to point 3.

The "API Access" page will open.Please be aware that this page could take a few minutes to load.

Click Create Service Account.This will open a pop-up.

Click Google API Consolein the pop-up. This will open a newtab in your browser.

Click Create service accountand enter the following in the pop-up that opens:

Service account name: Entersg-service-accountThis will automatically populate the "Service account ID" field.

Role: Select Project Owner.

Checkbox: Check Furnish a new private key.

Key type: SelectJSON.

Click Create. A file named "Google Play Android Developer-XXXXXXXXXX.json"will start to download. Save this JSON file and upload it to Shopgatein a later step.Depending on your browser settings, the file may start to download automatically or ask you for permission to start the download.

Close the pop-up. You'll see the new service account created. You can close this tab now.

Switch back to the pop-up you left open at step 4. Now click Done.

Under the section Service Accounts Permissions, clickGrant access. Make sure to allow all the permission options except "View financial data" or "Manage orders."Click Add user.

You'll be redirected to theUsers & Permissions page. The new service account should now be listed here.

Step 5: Enter Information at Shopgate.

As soon as you have finished steps 1 to 5, please enter your Google Play Console account information and upload the JSON file (downloaded inthe previous step) to Shopgate.

Log into your Shopgate Admin.

Navigate to Settings Native Apps Google Play Developer Account.

Enter your Google Account Email Address that was created in Step 1.

Upload the JSON file "Google Play Android Developer-XXXXXXXXXX.json"which was downloaded in Step 4.

Click Confirm Setup to confirm that you have finished everything outlined above.

That's it! Now you have finished setting up your Google Play Console account! Once your shop is live, wewill submit your Android app for review within a few days.

For more information on Google Play Console account, please visit Google's Developer Console Help.For more questions about the overall enrollment process, please contact us at .

3. Frequently Asked Questions (FAQ)

3.1 Should I use my existingGoogle Play Console account?

In order to publish your app,Shopgate will need to be invited as a Release Manager with "Global" permissionin your Google Play Console account.If you're concerned about Shopgate having access to your other appson this account, please register a new Google Play Developer account.

Keep in mind that a"developer name" (the company name in this case) can only be used once in the Developer Profile. When applying for a second Google account, you could try to add a dash or spacein your company name.

3.2 Should I create a separate Google account for my Android app with Shopgate?

In general, it is not recommendedto use apersonalGoogle account to connect to your Google Play Console.If your existing Google account is associated with your Google Play Console, andyou're concerned about Shopgate having access to the other appsin this console, you should create a separate Google account.

Google Tag Manager for mobile apps allows you to send your app data to multiple tracking tools. This allows for increased user experience and enhanced data gathering all while avoiding having any complicated development effort. To implement this enhanced reporting yourself, Google Tag Manager for mobile apps does require Firebase Analytics.

Step 1: Set up Google Tag Manager for mobile apps

Create a Google Tag Manager account.

Note: If you already have a Google Tag Manager account, you can continue to use it and proceed directly to the next step.

Set up an iOS and an Android container.

Publish your container. You can already create tags, but it is recommended to first complete the configuration at Shopgate.

Step 2: How to connect your Google Tag Manager containers with your Shopgate apps

Next in your Shopgate Admin, go to "Settings" => "Tracking Tools".

Upload the Android and iOS containers in the "Google Tag Manager Configuration" item.

IMPORTANT: Please do not change the filename - if the filename has been adjusted automatically during download (for example with the suffix "(1)"), then remove it before uploading.

Shopgate recompiles your app and uploads it to the app stores.

Step 3: Setting up tags, variables, and triggers on Shopgate

Once your Google Tag Manager container is published to your Shopgate app, you can create and customize tags at any time without having to recompile or publish your app.

Depending on to which tracker you want to connect through Google Tag Manager, the setup of Google Tag Manager differs. Here's a list of events, variables, and triggers that Shopgate automatically submits to your Google Tag Manager integration via Firebase for Mobile Apps:

Firebase for Mobile Apps: Event reference for Shopgate Apps

Step 4: Test Your Google Tag Manager Tags:

You cannot test your tags until your container is first compiled into the app and published to AppStore or PlayStore. After publishing for the first time, you can test and publish your tags without the need for another update.

In Google Tag Manager, locate the submit button in the top right corner of the page. This button allows you to save your changes.

Select "Create Version".

Recommended: Describe the changes you want to test in "Version Name" and "Version Description" and be as thorough as you can for future reference.

After saving, select the three dots behind "Download"

Select "Preview"

Create a preview QR code that you scan on your smartphone with a QR code reader or your iPhone camera to put your app in preview mode. The smartphone you scan the code with needs to have your app installed with the Google Tag Manager container compiled.1: Enter your Application ID. You can find this in your Shopgate merchant admin under "Settings" => "Tracking Tools" => App Info Button2: Press "Generate begin preview link"3: Select a device on which you have installed your app that already contains Google Tag Manager. Scan the QR code you generated in step 2 with this device. The app will open and a success message will be displayed. All events that you now generate from this app now trigger the tags for which you have created the preview link.

If you're based in the US and need to update your payment method, please contact Shopgate support.

Shopgate supports PAYONE as a payment service provider.

By setting up your PAYONEaccount at Shopgate, you will be able to accept the following types of payment from the available marketplace:

Credit Card, PayPal, Invoice,Direct Debit, Prepayments

SOFORT BankingNEW

Klarna InvoiceNEW, GiroPayNEW

iDEALNEW

USA

No

No

No

No

UK

No

No

No

No

Germany

Yes

Yes

Yes

No

Austria

No

Yes

No

No

Switzerland

No

Yes

No

No

Poland

No

No

No

No

France

No

No

No

No

Netherlands

No

Yes

No

Yes

In this article, you will find everything you need to set up PAYONE for your mobile website and apps.

Adding PAYONE as a payment provider

Collecting the necessary information

Please prepare the following information before you set up PAYONE as a payment providerat Shopgate.

Options Provided by PAYONE:

Merchant ID

These credentials can be found in your PAYONE account credentials.

Where can I find these credentials?

Portal ID / Portal Key

Account ID

Options Defined by You:

Request Method

How do you want to request your payments? Choose between "Pre-authorization" and "Authorization." This option is not available for Prepayment.

Additional Settings

To set up additional charges or discounts, read Setting up additional fees and discounts of a payment.

How do I select a transaction type?

Setting up PAYONE at Shopgate

To set up PAYONE as a payment provider, please complete the following steps:

Log in to your Shopgate Admin page.Click Settings from the menu bar, then selectPayment. adding PAYONE at Shopgate

In the section labeled "Add payment method," start typing "PAYONE", and select the type of payment you accept from the list. If you accept more than one type of payment, repeat the steps until all have been added.

In the pop-up window, enter your PAYONE information.Click Save. Your account information will be verified.

Now you have successfully set up PAYONE as a payment provider for your shop. Please continue to enter shipping destinations.

Finding the required information

Your PAYONE account credentials can be found by following the steps here:

Log on to your account at PAYONE and navigate to Configuration > Payment Portals.

Click Editon the portal you want to use.If a portal has been created for Shopgate API, please select this portal.

This will open your portal details. Click the tab labeled "API-Parameter." Your PAYONE Merchant ID, Portal ID, Portal Key, and Account ID will be displayed here.

Entering shipping destinations

PAYONE needs to know which countries your shop ships to. In order to provide this information, follow the steps here:

On your Shopgate Admin homepage, click Settings from the menu bar, then selectShipping.

On the Shipping page, click + Add a rateand select all countries that you deliver to in the section labeled "Delivery countries." If you have already configured your shipping methods, click Edit to add delivery countries. Click Save.

Now you have successfully set up your shipping destinations. Please continue to enter the Shopgate API link in your PAYONE account.

Entering Transaction URL (direct debit, invoice, prepayment)

This step is only necessary if you accept any of these payment types:

direct debit

invoice payments

prepayment

To enter theShopgate Transaction URL in your PAYONE account, follow the steps here:

Log on to PAYONE and navigate to Configuration > Payment Portals. Locate the portal you want to use, and click Edit.

On the portal admin page, navigate to the tab labeled "Extended" and enter this Shopgate API link in the text field titled "TransactionStatus URL": https://api.shopgate.com/payment/payoneIf this field is already in use, read Where should I enter the Shopgate URL?

Adding extra fields (iDEAL, SOFORT, Giropay, Klarna Invoice)

This step is only necessary if you accept any of these payment types:

iDEAL

SOFORT

Giropay

Klarna Invoice

Your PAYONE system requires additional information foriDEAL, SOFORT, Giropay, andKlarna Invoice payments. Please contact Shopgate support at [email protected] to add the respective fields described below.

iDEAL

Your customer's iDEAL Bank information is required for all iDEAL orders. Please ask your Shopgate support expert to add an extra field for entering bank informationat checkout with these settings:

Field For Customer's Ideal Bank

Label

iDEAL Bank

Internal Field Name

ideal_bank

Form Element Type

Dropdown

Options(JSON)

{ "ABN_AMRO_BANK" : "ABN Amro", "RABOBANK" : "Rabobank", "FRIESLAND_BANK" : "Friesland Bank", "ASN_BANK" : "ASN Bank", "SNS_BANK" : "SNS Bank", "TRIODOS_BANK" : "Triodos", "SNS_REGIO_BANK" : "SNS Regio Bank", "ING_BANK" : "ING", "KNAB_BANK" : "Knab Bank", "VAN_LANSCHOT_BANKIERS" : "van Lanschot Bank" }

Validationrules(JSON)

{"required":{"rule":"notEmpty","allowEmpty":true}}

Belongs to

Order / Checkout

SOFORT and Giropay

Your customer's IBAN and BIC are required for all SOFORT and Giropay orders. Please ask your Shopgate support expert to add 2 extra fields for entering customer's IBAN and BICat checkout, respectively, with these settings:

Field For IBAN

Label

IBAN

Internal Field Name

iban

Form Element Type

Input

Validationrules(JSON)

{"minLength":{"rule":["userDefined","CustomValidation","minLength","16"],"allowEmpty":true}}

Belongs to

Order / Checkout

Field For BIC

Label

BIC

Internal Field Name

bic

Form Element Type

Input

Validationrules(JSON)

{"minLength":{"rule":["userDefined","CustomValidation","minLength","8"],"allowEmpty":true}}

Belongs to

Order / Checkout

Klarna Invoice

Your customer's birthday and phone number are required for all Klarna Invoice orders. Please ask your Shopgate support expert to add 2 extra fields for entering customer's birthday and phone numberat checkout, respectively, with these settings:

Field For customer's phone number

Label

Phone

Internal Field Name

phone

Form Element Type

Input

Validationrules(JSON)

{"minLength":{"rule":["userDefined","CustomValidation","minLength","7"],"allowEmpty":true}}

Belongs to

User

Field For customer's birthday

Option 1

Label

Birthday

Internal Field Name

birthday

Form Element Type

Date

Validationrules(JSON)

{"formattedDate":{"rule":["userDefined","CustomValidation","formattedDate"],"allowEmpty":true}}

Belongs to

User

Option 2

Add a mandatory birthday field to the registration form

This will require ALL of your customers to enter a birthday at registration.

Please askyour support personnel to check the option "Show mandatory birthday field," but no extra field needs to be added.

Note that you only need to add the field(s) you need. Ifall fields mentioned in this chapter have been added, this section will appearat checkout:

Frequently Asked Questions

Why couldn't I get payments from my mobile orders?

This is likely because the Transaction URL is not set up correctly. To make sure to get payments in the future, please go to Entering Shopgate Transaction URL.

I already have a TransactionStatus URL. Where should I enter the Shopgate URL?

If a TransactionStatus URL for your desktop shop is already entered here, and you are accepting direct debit, invoice payments, and/or prepayment via PAYONE, please create a new payment portal for theShopgate TransactionStatus URL:

1. Navigate to Configuration > Payment Portalsand click Add portal.2. In the new portal,navigate to the tab labeled "Extended."

In thefield TransactionStatus URL, enter the Shopgate API URL: https://api.shopgate.com/payment/payone

In all other fields, enter the exact same infoas your other (main) portal.

3. After the new portal for Shopgate is created, make sure to enter theMerchant ID, PortalID, Portal Key, and Account ID from this portal (inAPI-Parametertab) when.

Do I need to refund my customers manually after I cancel an order?

No, you don't need to refund the money manually via your PAYONE account. The refund is done automaticallywhen you cancel an order.

If you're based in the US and need to update your payment method, please contact Shopgate support.

When configuring Shopgate for your Wirecard account, you can accept the following payment methods:

Credit Card

PayPal

SOFORT Banking

iDEAL

SEPADirect Debit

USA

No

No

No

No

No

UK

Yes

Yes

Yes

No

Yes

Germany

Yes

Yes

Yes

Yes

Yes

Austria

Yes

Yes

Yes

Yes

Yes

Switzerland

Yes

Yes

Yes

No

Yes

Poland

Yes

Yes

Yes

No

No

France

Yes

No

No

No

No

Netherland

Yes

Yes

Yes

Yes

No

Collecting necessary information

Please prepare the following information before you set up Wirecard payment methods at Shopgate.

Account Info

Description

Customer ID

Customer number you received from Wirecard.

Secret

String which you received from Wirecard for signing and validating data to prove their authenticity.

Shop ID (Wirecard) - optional

Shop identifier if you have more than one shop. Please note that this field is optional.

Service URL

URL on the payment page which leads to the imprint page of the online shop.

Wirecard Checkoutsolution

During setup, choose the solution you are using: Wirecard Checkout Page or Wirecard Checkout Seamless.

For more details, please read Finding the required information.

Setting up Wirecard at Shopgate

To set up the payment methods you want to offer at Shopgate, please complete the following steps:

Log in to your Shopgate Admin page.

ClickSettings from the menu bar, then select Payment.

For your apps and mobile websites both Wirecard solutions are available. Depending on your Wirecard solution, enter "Checkout Page" or "Checkout Seamless" in the section labeled "Add payment method." This will allow you to find and select the respective payment methods.

this article

Enter your Wirecard information in the pop-up window. Your account information will be validated automatically.

For more assistance, please read where can I find the required information?

That's it! Wirecard is now successfully set up. If you want to offer more than one payment method repeat the steps above.

Finding the required information

Account Info

Description

Customer ID

Please contact Wirecard if you need any assistance.

Secret

Shop ID (Wirecard)

Service URL

If you use the standard shop imprint page described in, your service URL should be (use your shop name instead of "my-shop"):

US shop: http://"my-shop".shopgate.com/imprint

DACH shop:http://"my-shop".shopgate.com/imprint

If you usea special page for your shop info, please enter the page URL in the field.

Track activities so you can get an idea of how your users behave in your mobile shop. This is an invaluable tool, as studying user behaviors help you improve your sales methods to increase sales.

How do you do this? The answer is the tracking pixel. Also known as a 1x1 pixel, this is a graphical element that loads when a user visits an app and website.You can embed a tracking pixel in Javascript on your Shopgate mobile apps and website by following these instructions.

Embedding a custom tracking code

If using such a tracking pixel, you should be able to find an HTML snippetin your tracking code similar to this:

To use this tracking pixel on your Shopgate mobile apps and website, just convert the code into Javascript following the steps below.

Converting the pixel into Javascript

The simple steps and rules to convert your tracking pixel can be found below:

Remove the <div> tags

The first step is to remove the <div> tags. In this example, the tags are:

<div style="display:inline;"> and </div>

Rewrite the <img> contents

The contents inside the <img ..../> need to be converted into the Javascript style.

In this example, the <img .../> tag and its contents can be broken down into five different elements:

HTML code

Convert to Javascript with this code:

1.

<img ..../>

var imgtag = document.createElement('img');

2.

height="1"

imgtag.height = '1';

3.

width="1"

imgtag.width = '1';

4.

style="border-style:none;"

imgtag.style = 'border-style:none;';

5.

alt=""

imgtag.alt = '';

6.

src="//googleads.g.doubleclick.net/pagead/viewthroughconversion/928691177/?value=0"

imgtag.src = '//googleads.g.doubleclick.net/pagead/viewthroughconversion/928691177/?value=0';

The resulting Javascript should look like this:

Now your tracking pixel has been converted from HTML to Javascript.

Entering your tracking code

After your tracking pixel has been converted, enter it at your Shopgate Admin :

ClickSettings from the menu bar, then selectTracking Tools.

Locate the Tracking codes section, select a platform and a page to display the code, and click +Add.

Enter a title and your tracking code in the script editor. Turn Autovalidation to ONso your shop will have extra security and coding accuracy. Your code will be validated before it can be saved.

Click Save.

That's it! You have successfully set up a tracking pixel. Repeat the steps here to enter another code if needed.

To learn more about the tracking codes function and all its options, please read .

If you're based in the US and need to update your payment method, please contact Shopgate support.

PayU is a payment method used for mobile websites in Poland.

How do i set up PayU at Shopgate?

Log in to your Shopgate Admin page.

Click onSettings from the menu bar, then selectPayment. PayU account

Find the "Add payment method" section, search for PayU, and select it from the drop-down list.

Enter your PayU account information (POS ID, Key, Second Key, Payment authorisation key) in the pop-up window. Copy the three URLs below (Error return address, Successful return address, and Address for reports) - you will need to enter them in your PayU admin page. For more assistance, please read Where can I find the required information?

That's it! PayU is now successfully set up as your payment method.

What information is needed?

POS ID

Key

Second Key

Payment authorisation key

Where can I find the required information?

Log in to your .

Navigate to Registration > Basic information > Configuration, and look for your shop's URL. Underneath, click on Show configuration.

Under the POStab, look for the blue box labeled "Configuration Keys." Here you can find everything you need to configure your PayU account at Shopgate.

If you want to add delivery information to an order, follow these steps:

Log in to your Shopgate Admin page.

On theOrders page, click Detailson the order you need to add delivery info to.

On the Order Details page, click Add delivery.

A pop-up will appear. Choose the delivery service from the drop-down, add a tracking number, and select an estimated delivery date.You can choose to send an email to the customers by checking the box.Click Add delivery to save.You have successfully added a tracking number and other delivery info to the order!

Advanced Javascript coderswho intend to create or customize a tracking code for a Shopgate mobile shop should refer to this article. For basic information on how to convert and embed an existing tracking code, read Embedding a custom tracking code.

Get started

The Shopgate custom tracking code system is aJavascript-basedsystem with150+ pre-defined variables for tracking various customer behaviors of aShopgate mobile app and website.

Here is a tracking code example customized with Shopgate Variables (highlighted in yellow):

// Facebook Tracking Code for Conversion Ratevar cart_items_amount_net = sgData.order.amount.net - sgData.order.shipping.amount.net - sgData.order.payment.amount.net;(function() { var _fbq = window._fbq || (window._fbq = []); if (!_fbq.loaded) { var fbds = document.createElement('script'); fbds.async = true; fbds.src = '//connect.facebook.net/en_US/fbds.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(fbds, s); _fbq.loaded = true; }})();window._fbq = window._fbq || [];window._fbq.push(['track', 'xxxx_your_id_xxxx', {'value':cart_items_amount_net,'currency': sgData.order.amount.currency}]);

In this example, the Shopgate variables used are:

Shopgate Variable

Description

sgData.order.amount.net

The valueamountof an order beforetaxes.

sgData.order.shipping.amount.net

The shipping costs of an order before taxes.

sgData.order.payment.amount.net

The payment amount of an order before taxes.

sgData.order.amount.currency

Thecurrency used in this order.

Click here for a complete list of availablevariables with details.

Available platforms and pages

Some of the Shopgate variables are made available on all pages, while more of our variables are designed for a specificpage only. All variables can be used on both the mobile website and native apps.

For example:

sgData.device: available on every page of your apps and mobile site.

sgData.cart.products[].uid: available only on the Shopping cart page of your apps and mobile site.

In the table below, you can see all theavailable platforms and pages. Refer to this table for a list of variables that are available for a page.

Available Platform

Available Page

All platforms Mobile Website Smartphone Mobile Website Tablets Mobile Website Smartphone + Tablets Native Apps Smartphone Native Apps Tablets Native Apps Smartphone + Tablets

All pages Start Page / Homepage (sgData.page.startpage*) Search (sgData.page.search) Product List (sgData.page.productList) Product Detail Page (sgData.page.productDetails) Shopping Cart (sgData.page.cart) Login / Registration (sgData.page.loginAndRegister) Checkout Summary (sgData.page.checkoutConfirm) Checkout Success (sgData.page.checkoutSuccess)

*This is the Javascript name of this page.

IMPORTANT: Duplicate tracking code for a page can hurt your mobile SEO. How do I avoid using duplicate tracking code?

How to embed a custom tracking code at Shopgate

Log in to your Shopgate Admin and navigate to Settings Tracking Tools.

Locate the Tracking codes section, select a platform and a page to display the code, and click +Add.

An empty script editor will open. Simply type or paste your tracking code here and click Save.

Use keyboard shortcutCTRL+Space to show a list of variables available on this page.

That's it! Now you know how to embed a customtracking code. Repeat the steps to enteranother code.

The Tracking Variables

In this chapter, you will find all the details about the pre-defined tracking variables.

All Pages

The following variables are available on all platforms and pages.

Variable

Availability

Description

Example

sgData.device

Always

Information about the mobile device

Object

sgData.device.codebase

Apps only

Codebase version of our apps

"7.1.0"

sgData.device.userAgent

Always

User agent

"Mozilla/3.0 (iPhone; CPU iPhone OS 5_0 likeMac OS X) AppleWebKit/532.46 (KHTML, likeGecko) Version/3.1 Mobile/9A334 Safari/7532.48.3""Mozilla/3.0 (iPad; CPU OS 8_0 like Mac OS X) AppleWebKit/538.32.9 (KHTML, like Gecko) Mobile/12A4265u"

sgData.device.os

Always

Operating system

"iOS""Android""Other"

sgData.device.type

Always

Type of mobile website

"Phone""Tablet"

sgData.device.access

Always

Type of app

"web""Native"

sgData.page

Always

Object with page info

sgData.page.title

Always

Page title

sgData.page.name

Always

Name of the current page

"startpage" for Start Page / Homepage"search" for Search"productList" for Product List"productDetails" for Product Detail Page"cart" for Shopping Cart"loginAndRegister" for Login / Registration"checkoutConfirm" for Checkout Summary Page"checkoutSuccess" for Checkout Success Page

sgData.page.link

Current URL

"http://m.myshop.com/product/435230303631""http://myshop.shopgate.com/product/435230303631"

sgData.page.referrer

Always

Referrer

http://www.myshop.com

sgData.user

Always

Object with user info

sgData.user.email

Only when logged in

Email address of the logged-in user

[email protected]

sgData.user.gender

Only when logged in

Sex of the logged-in user

"m" / "f"

sgData.user.phone

Only when logged in

Phone number of the logged-in user

sgData.user.birthday

Only when logged in

Birthday of the logged-in user

"1972-07-22"

sgData.user.sessionId

Always

md5('tr1014'.session_id().'ack13')

"7e716d0e702df0505fc72e2b89467910"

sgData.user.loggedIn

Always

Is the user logged in?

"true""false"

sgData.user.customerGroups

Always

Customer group of the current user.

[{id: "123abc", name: "gold"}]

sgData.tracking.get.$key

Optional

Get the parameters that GET Parameter has white-listed as cookies, or is written in this session.

Object

sgData.tracking.get.$key.value

Optional

Value of the GET Parameter

Start Page / Homepage

Please see variables from the All Pages table.

Search

Variable

Availability

Description

Example

sgData.search

Always

Search information

Object

sgData.search.query

Always

Keywords that were searched for

"Nike Air Max""Winter socks"

sgData.search.resultCount

Always

Number of results found

"152""0"

Product List

Variable

Availability

Description

Example

sgData.category

Always

Category information

Object

sgData.category.uid

Always

Category number

"104256""52-21-74""ja8z2ha92712jd8917wh1923-47443d""5%542$SALE$"

sgData.category.name

Always

Category name

"Shoes""13 Inches""Women"

sgData.category.path

Always

Category path

"Clothes=>Men=>Jeans""Technic=>Laptops=>13 Inches""Socks=>Women"

sgData.products[]

Always

List of products displayed (use the same product info as the product detail page)

Array

Product Detail Page

Variable

Availability

Description

Example

sgData.product

Always

Product Information

Object

sgData.product.tags[]

Always

List of tags for products

Array

sgData.product.uid

Always

"Shopproduct.product_number" from our database

12313413131121

sgData.product.productNumber

Optional

"Shopproduct.product_number_public" from our database

foo1218219aouhiu

sgData.product.name

Always

product_name

Cotton jacket with hood"Fisticup" Coffee Mug by Inked (Black)

sgData.product.amount

Always

sgData.product.amount.currency

Always

Currency ID, based on ISO_4217 standard

"USD""EUR"

sgData.product.amount.net

Always

Net amount

"12.11""1.00""9889.00"

sgData.product.amount.gross

Always

Gross amount

"12.99""3.99"

sgData.product.amount.tax

Always

Tax amount

"0.11"

sgData.product.amount.taxRate

Always

Tax (VAT) rate

"19.00"

sgData.product.stockQuantity

Always

Number of products in stock

"5"

Shopping Cart

Variable

Availability

Description

Example

sgData.cart

Always

Object with information about the shopping cart

Object

sgData.cart.orderable

Always

Is the cart in this form ordered

truefalse

sgData.cart.amount.currency

Always

Currency ID, based on ISO_4217 standard

"USD""EUR"

sgData.cart.amount.net

Always

Total net amount from cart, including shipping and other costs

sgData.cart.amount.gross

Always

Total gross amount from cart, including shipping and other costs

sgData.cart.amount.tax

Always

Total tax amount from cart

sgData.cart.amount.taxes[].tax

Optional

sgData.cart.amount.taxes[].taxRate

Optional

sgData.cart.amount.products

Always

Information about products in cart

Object

sgData.cart.productsCount

Always

Number of products in cart

sgData.cart.products[].tags[]

Always

List of tags for products

Array

sgData.cart.products[].uid

Always

Product number from Shopgate

sgData.cart.products[].productNumber

Always

Product number public from your shop system

sgData.cart.products[].name

Always

Product name

sgData.cart.products[].quantity

Always

Number of a product in cart

sgData.cart.products[].stockQuantity

Always

Number of a product in stock

"5"

sgData.cart.products[].amount.currency

Always

Currency ID, based on ISO_4217 standard

"USD""EUR"

sgData.cart.products[].amount.net

Always

Net price from the product

sgData.cart.products[].amount.gross

Always

Gross price from the product

sgData.cart.products[].amount.tax

Always

VAT amount of the product

sgData.cart.products[].amount.taxRate

Always

VAT rate of the product

sgData.cart.products[].additionalShippingCosts

Optional

Object

sgData.cart.products[].additionalShippingCosts.perOrder

Optional

Additional shipping cost per order

sgData.cart.products[].additionalShippingCosts.perUnit

Optional

Additional shipping costs per unit

sgData.cart.coupons[].code

Optional

Coupon code

sgData.cart.coupons[].discountAmount

Optional

Coupon value

sgData.cart.coupons[].discountPercent

Optional

Coupon discount in percentage

Checkout Summary Page

Variable

Availability

Description

Example

sgData.cart

Always

Object with information about the shopping cart

Object

sgData.checkout

Always

Information on selected addresses, payment method, and shipping

Object

sgData.checkout.payment.name

Always

Name of the payment method

'Authorize.net'

'PayPal'

sgData.checkout.shipping.name

Always

Name of the shipping method

'DHL Express'

sgData.checkout.shippingAddress

Always

Shipping address information

Object

sgData.checkout.shippingAddress.firstName

Always

First name of the customer in the shipping address

sgData.checkout.shippingAddress.surname

Always

Last name of the customer in the shipping address

sgData.checkout.shippingAddress.company

Optional

Company of the customer in the shipping address

sgData.checkout.shippingAddress.street

Always

Street in the shipping address

sgData.checkout.shippingAddress.street2

Optional

Street line 2 in the shipping address

sgData.checkout.shippingAddress.zipcode

Always

Post code of the shipping address

sgData.checkout.shippingAddress.stateId

Optional

State ID of the shipping address

'CA', 'FL', 'NY'

(ISO_3166)

sgData.checkout.shippingAddress.city

Always

City of the shipping address

sgData.checkout.shippingAddress.countryId

Always

Country ID of the shipping address

ISO_3166-1_alpha-2

sgData.checkout.invoiceAddress

Billing address information

sgData.checkout.invoiceAddress.firstName

Always

First name of the customer in the billing address

sgData.checkout.invoiceAddress.surname

Always

Last name of the customer in the billing address

sgData.checkout.invoiceAddress.company

Optional

Company of the customer in the billing address

sgData.checkout.invoiceAddress.street

Always

Street in the billing address

sgData.checkout.invoiceAddress.street2

Optional

Street line 2 in the billing address

sgData.checkout.invoiceAddress.zipcode

Always

Post code of the billing address

sgData.checkout.invoiceAddress.stateId

Optional

State ID of the billing address

ISO_3166

sgData.checkout.invoiceAddress.city

Always

City of the billing address

sgData.checkout.invoiceAddress.countryId

Always

Country of the billing address

ISO_3166-1_alpha-2

Checkout Success Page

Variable

Availability

Description

Example

sgData.order

Always

Order information

Object

sgData.order.number

Always

Shopgate Order number

144055402858

sgData.order.amount

Always

Object

sgData.order.amount.currency

Always

Currency ID, based on ISO_4217 standard

"USD""EUR"

sgData.order.amount.net

Always

20.74

sgData.order.amount.gross

Always

23.22

sgData.order.amount.tax

Always

Tax payable on the entire cart

2.48

sgData.order.amount.taxRateCurrently not available

Always

Tax rate of the entire cart (grouped)

sgData.order.shipping

Always

Shipping info

Object

sgData.order.shipping.name

Always

Name of shipping

DHL-Express

sgData.order.shipping.amount.currency

Always

Currency ID, based on ISO_4217 standard

"USD""EUR"

sgData.order.shipping.amount.net

Always

Shipping cost net

3.00

sgData.order.shipping.amount.gross

Always

Shipping cost gross

sgData.order.shipping.amount.tax

Optional

Tax amount on shipping costs

sgData.order.shipping.amount.taxRateCurrently not available

Optional

Tax rate on shipping costs

sgData.order.payment

Payment info

Object

sgData.order.payment.name

Always

Payment name

DHL-Express

sgData.order.payment.amount.currency

Optional

Currency ID, based on ISO_4217 standard

"USD""EUR"

sgData.order.payment.amount.net

Optional

Additional cost for payment method net

3.00

sgData.order.payment.amount.gross

Optional

Additional cost for payment method gross

sgData.order.payment.amount.tax

Optional

Tax amount on additional cost for payment method net

sgData.order.payment.amount.taxRateCurrently not available

Optional

Tax rate on additional cost for payment method net

sgData.order.products[]

Always

List of products

Array

sgData.order.products[].uid

Always

Unique product ID ("Shopproduct.product_number")

sgData.order.products[].productNumber

Always

Public product number ("Shopproduct.product_number_public")

sgData.order.products[].name

Always

Product name

sgData.order.products[].quantity

Always

Product quantity

sgData.order.products[].stockQuantity

Always

Number of product in stock

sgData.order.products[].amount.currency

Always

Currency ID, based on ISO_4217 standard

"USD""EUR"

sgData.order.products[].amount.net

Always

Net price of the products

sgData.order.products[].amount.gross

Always

Gross price of the products

sgData.order.products[].amount.tax

Always

Tax amount of one product

sgData.order.products[].stockQuantity

Always

Stock quantity of one product

sgData.order.products[].tags[]

Always

List of tags for products

Array

sgData.order.coupons[]

Optional

Coupon-array

Array

sgData.order.coupons[].code

Optional

Coupon code

sgData.order.coupons[].amount.currency

Optional

Currency ID, based on ISO_4217 standard

"USD""EUR"

sgData.order.coupons[].amount.net

Optional

Coupon value net

sgData.order.coupons[].amount.gross

Optional

Coupon value gross

sgData.order.coupons[].amount.tax

Optional

Tax amount of the redeemed coupon

sgData.order.coupons[].amount.taxRateCurrently not available

Optional

Tax rate of the redeemed coupon

sgData.order.amount.coupons.currency

Always

Currency ID, based on ISO_4217 standard

"USD""EUR"

sgData.order.amount.coupons.net

Always

Coupon value net

sgData.order.amount.coupons.gross

Always

Coupon value gross

sgData.order.shippingAddress

Always

Shipping address information

Object

sgData.order.shippingAddress.firstName

Always

First name of the customer in the shipping address

sgData.order.shippingAddress.surname

Always

Last name of the customer in the shipping address

sgData.order.shippingAddress.company

Optional

Company of the customer in the shipping address

sgData.order.shippingAddress.street

Always

Street in the shipping address

sgData.order.shippingAddress.street2

Optional

Street line 2 in the shipping address

sgData.order.shippingAddress.zipcode

Always

Post code of the shipping address

sgData.order.shippingAddress.stateId

Optional

ISO_3166

sgData.order.shippingAddress.city

Always

City of the shipping address

sgData.order.shippingAddress.countryId

Always

Country of the shipping address

ISO_3166-1_alpha-2

sgData.order.invoiceAddress

Billing address information

sgData.order.invoiceAddress.firstName

Always

First name of the customer in the billing address

sgData.order.invoiceAddress.surname

Always

Last name of the customer in the billing address

sgData.order.invoiceAddress.company

Optional

Company of the customer in the billing address

sgData.order.invoiceAddress.street

Always

Street in the billing address

sgData.order.invoiceAddress.street2

Optional

Street line 2 in the billing address

sgData.order.invoiceAddress.zipcode

Always

Post code of the billing address

sgData.order.invoiceAddress.stateId

Optional

ISO_3166

sgData.order.invoiceAddress.city

Always

City of the billing address

sgData.order.invoiceAddress.countryId

Always

Country of the billing address

ISO_3166-1_alpha-2

sgData.order.user

Customer information

sgData.order.user.customerNumber

Always

Customer number

sgData.order.user.externalCustomerId

Always

sgData.order.user.externalCustomerNumber

Always

sgData.order.user.email

Always

Customer email address

[email protected]

sgData.order.user.gender

Optional

Customer gender

"m" or "f"

sgData.order.user.phone

Optional

Customer phone number

sgData.order.user.birthday

Optional

Customer birthday

1971-07-22

sgData.order.field.$key

Optional

Custom Field ("ExtraField")

Object

sgData.order.field.$key.label

Optional

Field label

sgData.order.field.$key.value

Optional

Field value

Tracking Events

Apart from the tracking variables mentioned above, we have also pre-defined four tracking events for you.

An example written in jQuery

$(document).on('sgAddToCart', function(e) {console.log(e.originalEvent.detail);});

An example writtenin Vanilla JS

document.addEventListener('sgAddToCart', function(e) {console.log(e.detail);});

In the examples, event "sgAddToCart" is used to monitor useful information after the Add To Cart button from a specific product has been clicked.

To see the details of all the available events, refer to the table below:

Event

Description

sgViewAppear

This event is no longer necessary because it is now incorporated in the tracking codes.

Triggered when the page is called and can be tracked. On the mobile site, this happens after the page has loaded in the app every time the view is displayed. The event is necessary because views can be preloaded in the background, but the background views will not be tracked.

sgProductUpdate

Triggered when a change has been made on the product detail page, e.g. another child product is selected.

sgAddToCart

Triggered when a product is placed into the cart from the product detail page. This event contains data about this product and the products that are in the same product group.

sgCartUpdate

Triggered when a change has been made in the cart, e.g. quantity of a product is changed, a product is removed, or a coupon is added. Contains the updated cart.

sgDataUpdate

Triggered every time a sgData variable is updated by sgDataHelper.

Frequently Asked Questions

Why isn't code in <noscript> tags necessary?

Your code snippet inside the <noscript>...</noscript> tags is used as a fallback in case Javascript is not available. However, Javascript is required in ALLShopgate systems. Therefore, you do not need to provide any <noscript> fallback code.

How do I avoid using a duplicate tracking code?

Your Shopgate tracking code system is designed to execute all tracking codes, including those that are entered more than once on the same page of a platform. Tracking codes set up for "all pages" will be processed in additionto any page-specific tracking codes. Therefore it is recommended to check your tracking codes carefully by asking yourself the following questions:

Did I enter or pasteacode snippet more than once?

If I have more than one entry for a page on the sameplatform, did I enter or paste the same tracking function in more than one entry?

If I have a tracking code set up for "All pages," did I remove this tracking code from all other entries?

How do I create a tracking pixel?

To create or modify a tracking pixel, refer to the example below. To append parameterssuch as user email, phone number, etc. to your pixel, use "?" and the available variables (highlighted in yellow):

var image = document.createElement('img');

image.height = '1';

image.width = '1';

image.style = 'border-style:none;';

imgtag.alt = '';

image.src = 'http://yourdomain.com/pixel.png?email='+sgData.user.email+'&phone='+sgData.user.phone;

document.getElementsByTagName('body')[0].appendChild(image);

Click here for a complete list of availablevariables.

Your shop needs a recognizable name and effective description that attests to the quality of your products and the unique character of your business.

Before you get started on uploading and branding your apps, please read the Google Play Developer Program Policies and the iOS App Store Review Guidelines. Note that any violations of the Google Play or App Store policies will result in a rejection of your apps. Apps with explicit or erotic content, icons, titles, descriptions, or displays of sexual organs or activities will not be accepted by Shopgate.

Getting started

Once you've verified that your content meets the standards of the app stores and of Shopgate, follow these steps to enter names, descriptions, keywords, categories, and a shop URL for your apps.

Log in to your Shopgate Admin and navigate to Settings Native Apps. Content ratings for apps & games.

On the Native Apps page, you can enter information for your iOS and Android apps.Information entered here will be displayed in the iOS App Store and Google Play Store. Please note thatDescription, Keywords, andShort descriptionare required fields.

App information on the Native Appspagecan be edited by clicking on each field. Content will be saved automatically. Point your mouse to a text field to see where and how the entered info will look like in the app stores.

Creating a brand for your iOS app

App name

This is the "full name" of your app that will appear in the App Store and searches within the App Store.

Choose a simple and descriptivename to look more professional.

Remember that a maximum of 30 characters is allowed. Please note that if you have already entered an app name that is longer than that, the name istruncated.

Keep in mind that only the first 19 to 30 characters (including spaces) of an app name are displayed in the App Store, depending on the page.

Display name

This name appears under your app icon on the home screen of an iOS device.

Remember that a maximum of 13 characters is allowed, and the last 35 characters may be clipped on your home screen. To fit the most characters, spell your app name withouta space.

Keep in mind that this is purely for branding purposes and not for App Store Optimization purposes, so don't think about App Store search results when you choose it.

Subtitle

You can add an app subtitle to be shown withthe app name inthe App Store.

Be short, but thorough. A maximum of 30 characters is allowed, so try to briefly summarize the purpose of your app and what makes it special.

Promotional text

This text, limited to 170 characters,is shown above the app description on the App Store for customers usingiOS 11 or later.

Promote immediate downloads by using this space to share urgent, time-sensitive information about your shop. Use it to notify App Store shoppers of new products, features, and limited-time sales so they feel like they can't miss what you're offering.

Changes to the promotional text field does not require an app update.

Description

This does exactly what it sounds like: it describes your shop, your products, and the features that make your shop memorable and irreplaceable.

Describe the most important information in the first 3 lines. This is for two reasons: first, you can use up to 4000 characters, so you don't want to bury the most vital info in the wall of text. Second, the rest of the text is hiddenunder the "Read More" buttons. Many users won't be compelled to "read more," so you should sell them immediately. Explain what you sell and whyshould people buy from you. What makes you different? Why are your products of a higher quality than other shops? Do you have any loyalty programs or other incentives to earn their trust? List the features and benefits your app provides.

Please note: you will need to request an app update to change your description.

Keywords

These are used to match the words searched in the App Store or a search engine like Google. Remember: selecting fitting keywords and categories are crucial to making your apps visible in searches and rankings.

Remember that there is a 100-character limit. Separate your keywordswithcommas; spaces are not necessary. Use single words instead of phrases. Use the singular form of a word instead of the plural form (e.g. use banana instead of bananas). Use numbers instead of words. Don'tuse app name or company name as keywords - they are automatically added.Don'tadd the word "free" - this is automatically added for Shopgate mobile apps. Don't use names or brands from existing apps or third party companies.Don't use offensive words.Don't use irrelevant keywords.

For App Store Optimization (ASO) tips, read Selecting keywords for iOS.

Category

Categories are used to match the words searched in the App Store or a search engine.Selecting fitting keywords and categories are key to get your apps found.

Your main category will be displayed in the App Store - make sure to select the best category as your main category.Your secondary category will be displayed in the iTunesConnect.

Year and your company

Enter the current year in 4 digits, and your shop name or company name. For example, this is what you should enter:

2015 My Awesome Shop

This information is displayed at the bottom of your app detail page. This is what it will look like:

2015 My Awesome Shop

App URL

Copy and paste the URL to your desktop website. For example:

http://www.myawesomeshop.com

Enter info for your Android app

App information on the Native Appspagecan be edited by clicking on each field. Content will be saved automatically. Point your mouse to a text field to see what the entered info will look like in the app stores.

Read the tips below to help you decide what to enter for your Androidapp.

App name

Choose a simple and descriptivename to increase thechance of your app getting discovered. A maximum of 30 characters is allowed.

Keep in mind that, only the first 20 to 25 characters (including spaces) of an app name are displayed in the Play Store. Longer names will make your app look unprofessional.

There are two choices when picking your app name:

If your shop name describes what you sell,use your shop name as your app name. If this is not the case,add 2-3 keywords after your shop name with a - sign. Read ourtips for picking a descriptive app name.

Short description

This is the first descriptive text potential users will see when looking at your apps Store Listing in the Play Store. This field is limited to 80 characters. Tapping the text will reveal your apps full description.

Once users install your app, the short description will be replaced with the most relevant "Whats New" text.

Description

Describe your most important info in the first 3 lines. The rest of the text is hiddenunder"read more." Explain what you sell and whyshould people buy from you. List features and benefits your app provides. Include social proof: collect and display awards, customertestimonials, blog post reviews, recommendations fromsocial networks, etc.

Feature image

Upload an image of 1024 x 500 pixels.Your image should be designed to scale. It needs to look good both in a full-size web browser and on a handset. Create a fun and enticing graphic. Be bold and creative when promoting your brand. Use colors that stand out on a black or white background. Don't use a text-heavy advertising-style graphic. Don't overload the graphic with details.

Content rating

Select the app user maturity. Your options are:

Low maturity

Medium maturity

High maturity

If you choose "High maturity," your app may be rejected by the Google Play Store.

For more information, read

That's it! Now you have entered all the information for youriOS and Android apps.

Shopgate is updating its services to require TLS 1.2 for all HTTPS connections.Please follow this guide to update your system to support TLS 1.2 at your earliest convenience.

Why is TLS 1.2 required for my shop?

Shopgate uses HTTPS to securely connect to your server in exchange for sensitive data such as orders, customer information, credit cards, and other payment methods. To encrypt these communications, we use the Transport Layer Security (TLS) protocol.

TLS 1.2 is one of the most secure versions of SSL/TLS protocolthat is designed to prevent eavesdropping, tampering, or message forgery. Shopgate will require TLS 1.2 in order to ensure thecontinuous security of your shop and adhere to industry best practices.

Many other SAAS providers are also making the change. See PayPal and Stripe's support page for more information.

What do I need to do?

To avoid any critical security risks and loss of orders, you must confirm that your systems are ready as soon as possible.

Please follow the flowchart below to check if you need to have your OpenSSLor NSSLibrary upgraded to supports TLS 1.2. More technical details are provided later in this guide.

downgrade PHP

Details for the Server Admins

Check your OpenSSL or NSS library

Shopgate plugins use cURL totransfer data (such as your order details) over HTTPS. Generally speaking, you need to have at leastcURL version 7.34.0 in order to support TLS 1.2.

However, please check the version of your cURL's underlying security library. The most common libraries that Shopgate merchants use are OpenSSL and NSS.

OpenSSL

If you use OpenSSL libraries, please update them to at least version 1.0.1.j. For more details, see below:

OpenSSL 1.0.2 and the newer versions supportTLS 1.2 by default.

? OpenSSL 1.0.1 supports TLS 1.2.However, depending on the version's patch-level, some older versions might have serious security bugs or problems such as heartbleed.

Released in June 2014, Version 1.0.1gis the oldest version considered sufficient.

+ Version 1.0.1j is needed to also mitigate the POODLE attack.

To check your OpenSSL 1.0.1 patch versions, please refer to the OpenSSL changelog.

OpenSSL 1.0.0 and the earlier versions do NOT support TLS 1.1/1.2.

Network Security Services (NSS)

If you use aNetwork Security Services (NSS) library, please update them to at least version3.15.1. Starting from this NSS version, TLS 1.2 is considered supported.Earlier versions have to be considered insufficient.

The current stable release of NSS is 3.30.2, which was released on April 20, 2017.

Other Library (e.g. GnuTLS)

If you use a different library such as GnuTLS, please check your library's change logs or documentations to ensure that it supports TLS 1.2.

Check your OS Version

Other than your security library, please also check if your Operating System (OS) version supports TLS 1.2.

Debian

If you use Debian as your operating system, we recommend upgrading it to at least Debian 7 (Wheezy)and employ all the security updates.If that is not possible, try installing a recent GnuTLS version or an OpenSSL backport for Debian 6.

Debian 7.0, released in 5/2013, originally comes with PHP 5.4 and OpenSSL 1.0.1e. It is sufficient if the regular security updates are applied.

If PHP 5.3 is needed for your system, you can manually on Wheezy, but please make sure that your SSL library supports TLS 1.2.

Other Operating System

If you use an operating system other than Debian, please check your system's change logs or documentation to ensure that it supports TLS 1.2.

Frequently Asked Questions

What will happen if my systems do not support TLS 1.2?

If you do not upgrade your SSL/TLS library to support TLS 1.2, your shop may face critical security risks in the future and your shop's mobile orders will no longer be transferred from Shopgate to your shopping system.

On top of that, your customers may not be able to use PayPal on your desktop shop anymore.

The following Firebase events are being supported by your Shopgate integration:

If you are unsure whether you currently use Shopgate Engage or Shopgate Go for your mobile app, please contact Shopgate support.

Firebase Event Name

Description

Shopgate Go App

Shopgate Engage App

ADD_PAYMENT_INFO

Add Payment Info event.

Credit card only

Yes

ADD_TO_CART

E-Commerce Add To Cart event.

Yes

Yes

ADD_TO_WISHLIST

E-Commerce Add To Wishlist event.

Yes

No

APP_OPEN

App Open event.

Yes

Yes

BEGIN_CHECKOUT

E-Commerce Begin Checkout event.

Yes

Yes

CAMPAIGN_DETAILS

Log this event to supply the referral details of a re-engagement campaign.

In Shopgate context, this logs opening your App by tapping on a push message and opening your App from a deeplink with utm parameters. Purchases will be attributed to those events in Google Analytics.

Yes

Yes

CHECKOUT_PROGRESS

Checkout progress.

No

No

EARN_VIRTUAL_CURRENCY

Earn Virtual Currency event.

No

No

ECOMMERCE_PURCHASE

E-Commerce Purchase event.

Yes

Yes

GENERATE_LEAD

Generate Lead event.

No

No

JOIN_GROUP

Join Group event.

No

No

LEVEL_END

Level End event.

No

No

LEVEL_START

Level Start event.

No

No

LEVEL_UP

Level Up event.

No

No

LOGIN

Login event.

Yes

Yes

POST_SCORE

Post Score event.

No

No

PRESENT_OFFER

Present Offer event.

No

No

PURCHASE_REFUND

E-Commerce Purchase Refund event.

No

No

REMOVE_FROM_CART

Remove from cart event.

No

No

SEARCH

Search event.

Yes

Yes

SELECT_CONTENT

Select Content event.

No

No

SET_CHECKOUT_OPTION

Set checkout option.

No

No

SHARE

Share event.

Yes

No

SIGN_UP

Sign Up event.

Yes

Yes

SPEND_VIRTUAL_CURRENCY

Spend Virtual Currency event.

No

No

TUTORIAL_BEGIN

Tutorial Begin event.

No

No

TUTORIAL_COMPLETE

Tutorial End event.

No

No

UNLOCK_ACHIEVEMENT

Unlock Achievement event.

No

No

VIEW_ITEM

View Item event.

Yes

Yes

VIEW_ITEM_LIST

View Item List event.

No

No

VIEW_SEARCH_RESULTS

View Search Results event.

No

No

Custom Shopgate Events:

Firebase Event Name

Description

Shopgate Go App

Shopgate Engage App

sg_view_page

Sent on every page view of a user. Replaces the Firebase event "screen_view", which cannot be used in hybrid apps like the Shopgate App.

Yes

Yes

sg_like

Can be used in a social network integration to track likes.

No

No

sg_invite

Can be used in a social network integration to track invites.

No

No

sg_custom_values

This allows integrations to track custom dimensions and metrics in Google Analytics Universal Analytics Properties via Google Tag Manager.

Yes

Yes

Custom Shopgate Parameter:

Firebase Parameter Name

Description

Events

sg_item_type

Type of item. Currently always "Product".

ADD_TO_WISHLIST

ADD_TO_CART

VIEW_ITEM

ECOMMERCE_PURCHASE

sg_item_category_id

The ID of the items category

ADD_TO_WISHLIST

ADD_TO_CART

VIEW_ITEM

sg_page_id

The ID of the current page. For product detail pages, the product ID, for category pages, the category ID.

sg_view_page

sg_page_type

The nature of the current page. Allow grouping for

cms

item

category

cart

checkout

wishlist

login

sg_view_page

sg_page_name

The title of the current page. Product name, category name, CMS title.

sg_view_page

sg_checkout_type

Web or app checkout

ECOMMERCE_PURCHASE

BEGIN_CHECKOUT

sg_purchase_success

Optional parameter to mark successful transactions.

ECOMMERCE_PURCHASE

sg_items_count

Number of items with which a checkout is started.

BEGIN_CHECKOUT

sg_payment_info_available

Indicates whether billing information already existed when the checkout started.

BEGIN_CHECKOUT

sg_add_payment_info_success

Indicates whether adding a payment method was successful.

ADD_PAYMENT_INFO

sg_name

Name of the respective method.

ADD_PAYMENT_INFO

SHARE

sg_like

sg_invite

sg_action

Custom Event Action

sg_label

Custom Event label

sg_type

Custom Event type

sg_like

sg_invite

sg_id

Custom Event ID

sg_like

sg_invite

When configuring a payment at Shopgate, you will likely be asked to select a transaction type for this payment.Yourpayment methods andpayment providers will show up in your mobile website and native apps. In this article, you will find the explanations about each transaction type.

Credit card transaction types

For credit card transactions, you can choose between Authorize and Capture and Authorize Only.

Authorize and CaptureThis is the most common type of credit card transactions. The amount is sent for authorization and is captured directly, so the credit card of the customer gets charged immediately.

Authorize OnlyWith this transaction type, the payment is sent for authorization only. The amount will be reserved on the customers credit card but will not be charged yet. In order to charge the money the transaction needs to be captured in a second step (e.g. after the order is shipped). This method is mostly used by merchants who have a delayed order fulfillment process.

PayPal Transaction Types

For PayPal transaction type, you can choose between Sale, Order, and Authorization.

Sale: We recommend selecting this for immediate payments from your customers.

Order: When selected, this will create an order. You will not get paid automatically.

Authorization: When selected, PayPal will authorize a payment to capture later. This will require your action before you can collect a payment from a customer.

If you're based in the US and need to update your payment method, please contact Shopgate support.

Accept payment from several different countries with PayPal. These countries are:

USA

UK

Germany

Austria

Switzerland

Poland

France

Australia

In this article, you will find out how to set up PayPal as a payment method for your app and mobile website.

To accept credit card payments viaPayPal Payments Pro, please read PayPal Website Payments Pro.

Add PayPal as a payment method

To add PayPal as a payment method, please complete the following steps:

Log in to your Shopgate Admin and navigate toSettings Payment.

Find the section titled "Add payment method"and select PayPal under Payment method from the list.

In the pop-up window shown below, click Approve now. You will be temporarily redirected to PayPal's website.

Click Grant Permission to allow PayPal to accept your customer's payments at Shopgate. You will then be returned to the payment configuration page in step 3.

Now you have added PayPal as a payment provider for your shop. Continue reading to configure the options.

Configure payment options

Before you can accept payments from your customers, a few options need to be configured. Follow the steps below:

Go back to the Payment page. Now you should see PayPal listed as one of your payment methods. Click the Config button.

The configuration page will pop up. Set additional charges, define where you want to display the PayPal Express Button, and select your transaction type. Click Save.

Important: To receive immediate payments from your orders, select Sale as your transaction type.

Free shipping

To offer free shipping on all PayPal orders, select Yes. Otherwise, leave it to No. For more information, read Setting up additional fees and discounts of a payment.

Additional charges

To charge additional fees to PayPal orders, select Yes. Otherwise, leave it to No. For more information, read Setting up additional fees and discounts of a payment.

PayPal Express button

Select where you want to place your PayPal Express button: in the shopping cart, or on the product detail page. Select Disable to hide the button.

Transaction type

Sale: for immediate paymentOrder: for creating an orderAuthorization: for authorizing a payment to capture later

That's it! Now PayPal has been set up successfully to accept payments from your customers.

Frequently Asked Questions

Why are shipping rates incorrect for some PayPal orders?

This may be caused by PayPal Express service on the product page. If this happens, please choose to display your PayPal Express button only in cart, NOT on the product detail page. This will make sure shipping info will be calculated correctly.

Why can't I get payments from PayPal orders?

This is because your PayPal transaction type is not set up correctly.

For immediate payments from PayPal, please select Sale as your PayPal transaction type. If Authorization has been selected, you will need to go to your backend and manually authorize all payments.

What should I do after my PayPal credentials have been updated?

If you have recently updated any login credentials at PayPal, you will need to authorize your PayPal account again at Shopgate.This can be easily done by removing your PayPal from the payment list and adding it again. To remove PayPal, follow Chapter 2 and clickDelete. To add Paypal again, follow Chapter 1.

Which IPN Transaction Type does Shopgate API send?

The Shopgate API sends an IPN Transaction Type of "cart."For more information on PayPal IPN Transaction Types, please read this article.

ISO 639-1

Shopgate supports Oxid as a shopping cart system.

By setting up the Shopgate plugin for your Oxid shop, you will get these featuresstraight into your apps and mobile website:

Supported Version

Import to Oxid

4.2 +

Orders

Sync

Export to Shopgate Mobile Shop

Delivery Status "Shipped"Order Status "Canceled"Stock Quantity on Product Detail Page

ProductsCategoriesReviews

Customer Account

Validate, upon Cart Changes

Login with Desktop ShopAccountLogin to Desktop Shopwith Mobile AccountCustomer Groups / Tier PricingShow Desktop Orders onMobile

/

CouponShipping MethodPayment MethodProduct Availability

Supported Payments

Notes

ShopgatePayPalPayPal PlusCash on DeliveryPrepaymentInvoiceDirect DebitPayolutionPayOne (Credit Card, PayPal, SOFORT Banking)

The payment validation feature allows you to offer specific payment options to targeted carts and customers. The availability of this feature depends on your Oxid settings. To enable this feature, please contact Shopgate Support.

In this article, you will find the instructions to set up the Shopgate plugin for your Oxid shop.

Install the Shopgate Plugin

Download the plugin

Download the latest plugin file "shopgate-oxid-integration.zip" via this link and extract the contents of the zip file. This should give you a folder called oxid with two subfolders:

Ab_eShop_4.7 (this is for Oxid eShop version 4.7.0 and above)

Bis_eShop_4.6 (this is for Oxid eShop versions 4.2.0 to 4.6.x)

Upload the plugin to your server

Use an FTP or a similar program to copy the plugin into your Oxid eShop. Plenty of FTP programs can be found on the internet. If youdon'tknow which one to use, we recommend FileZilla.

Once your FTP program is connected to your server, navigate to your locally extracted Shopgate plugin.

Choose between the subfolders Ab_eShop_4.7 or Bis_eShop_4.6 according to your Oxid version.

Open a subfolder of this folder called copy_this. Copy all contents in "copy_this" directly to the root directory of your Oxid installation on your server. Dont close your FTP program just yet. Youll need it again in a later step.

Set file permissions

Its necessary to set file permissions to the "temp" and "config" folders on your server.

To do this, navigate to the "modules/shopgate/shopgate_library" folder on your server and select both "temp" and "config" folders. Right click on your selection and clickFile permissions....

"Change file attributes" opens. Enter the numeric value 664* into the input field. Make sure the checkbox "Recurse into subdirectories is enabled and Apply to all files and directories is selected as the option. Click OK to finish the upload.

* If you cannot save your changes or configurations, setfile permissions to 777.

Now the plugin is successfully installed and ready to be activated.

Activate the plugin

To activate the Shopgate plugin, log in to your Oxid admin backend and follow the instructions according toyour Oxid version:

Oxid 4.6 and later Oxid 4.5 Oxid 4.4 and earlier

Click Extensions -> Modules on the main menu on the left.

Click Shopgate in the list of extensions.

Click the Overview tab on the lower part of the screen, if itisn'talready open.

Click the Activate button on the right to activate the Shopgate plugin.

In the main menu on the left, click Master Settings -> Core Settings. Click the Systemtab. Click the Modulessection to expand it.

Enter the following in the text area labeled Installed Shop Modules:

order_main => shopgate/shopgate_order_overvieworder_overview => shopgate/shopgate_order_overviewoxarticle => shopgate/marm_shopgate_oxarticleoxbasket => shopgate/shopgate_oxbasketoxdeliverylist => shopgate/shopgate_oxdeliverylistoxorder => shopgate/marm_shopgate_oxorderoxoutput => shopgate/marm_shopgate_oxoutputoxsession => shopgate/shopgate_oxsessionoxvarianthandler => shopgate/shopgate_oxvarianthandler

If some of the entries already exist, add the corresponding value to the end with an ampersand (&). For example: if "oxorder" (line 7)already exists like this:

oxorder => invoicepdf/myorder

add the info from "oxorder" to the end like this:

oxorder => invoicepdf/myorder&shopgate/marm_shopgate_oxorder

Clear the temporary folder in Oxid before you proceed:

Go back to your FTP program and locate a folder called "tmp" in your Oxid installation.

If there is a file named ".htaccess", select all files except ".htaccess" inside the folder "tmp" and clickDelete. Otherwise, delete all files inside the folder "tmp".

Find the code section: Select Master Settings -> Core Settings from the menu on the left. Choose theSystem tab.ClickModules to expand the section.

Enter this code in the text area shown above:

marm_shopgate_article => shopgate/marm_shopgate_oxadminvieworder_main => shopgate/shopgate_order_overvieworder_overview => shopgate/shopgate_order_overviewoxarticle => shopgate/marm_shopgate_oxarticleoxbasket => shopgate/shopgate_oxbasketoxdeliverylist => shopgate/shopgate_oxdeliverylistoxorder => shopgate/marm_shopgate_oxorderoxoutput => shopgate/marm_shopgate_oxoutputoxsession => shopgate/shopgate_oxsessionoxvarianthandler => shopgate/shopgate_oxvarianthandlershopgate_order => shopgate/marm_shopgate_oxadminviewshopgate_payment => shopgate/marm_shopgate_oxadminviewshopgate_shipping => shopgate/marm_shopgate_oxadminview

If some of the entries already exist, add the corresponding value to the end with an ampersand (&). For example: if "oxorder" (line 7)already exists like this:

oxorder => invoicepdf/myorder

add the info from "oxorder" to the end like this:

oxorder => invoicepdf/myorder&shopgate/marm_shopgate_oxorder

Clear the temporary folder in Oxid before you proceed:

Go back to your FTP program and locate a folder called "tmp" in your Oxid installation.

If there is a file named ".htaccess", select all files except ".htaccess" inside the folder "tmp" and hit Delete. Otherwise, delete all files inside the folder "tmp".

Now you have activated your plugin. Continue to the next chapter.

Establish connections

After the Shopgate plugin has been installed successfully, two simple tasks need to be completed to connect your mobile shop at Shopgate to your shop's backend: first, enter API credentials in your shop's backend. Next, enter your shop's URL in your Shopgate's admin page.

Get API credentials

Log into your Shopgate Admin page.

Click Integration from the menu bar, then select Install Interface.

In the dropdown labeled "Select system", search for "OXID eSales", and select a version depending on your shop edition. (CE = Community Edition, PE = Professional Edition, EE = Enterprise Edition)

A pop-up opens. Under 2. Configure, you'll see the API credentials the plugin needs to authenticate with the Shopgate backend. Leave this page open for the next step 2.2 Establishing connection.

Open your Oxid admin backend in another tab or window of your browser (if youdon'talready have it open from installing the plugin). In the main menu on the left, clickMaster Settings -> Core Settings,then click the tab labeled Shopgate. Expand the sections called Basic Configuration and Mobile website by clicking them. Fill in the Shopgate Customer Number, Shop Number, Shopgate API Key, and Alias with the values from your Shopgate merchant backend. There are some other settings on this page, but youdon'tneed to configure them for now. Click Save.

Connect your shop to Shopgate

Go back to the pop-up window at your Shopgate merchant page (step 4).

Under 3. Enter URL, enter the URL of your shop. Click Connect to establish the interface.

If a connection is made successfully, a pop-up shown below will open. Here you will be able to assign jobs for your first connection. Leave all assignments to ON to access all the available services. Click Save.

That's it! Now the Shopgate backend will automatically start to import product data via the newly established interface.

Update an existing plugin

Before updating your Shopgate plugin to a newer version, make sure to check if your shop uses a customized version of the Shopgate plugin. If this is the case, a generic plugin update will NOT work for your shop.

You are using a customized version if:

You have contacted Shopgate about making a third party plugin to work in your mobile shop, or about adding a special feature or function.

Shopgate has sent you an adapted version of the plugin.

The plugin file you installed has "adaption" in the name.

Once you know if you are using a customized Shopgate plugin or not, follow the instructions below to update it:

Generic Plugin Customized Plugin

Deactivate the old plugin. In Oxid version 4.6 and later, you can do so by navigating to Extensions > Module > Shopgate > Overviewand clicking the Deactivate button.

Follow chapter 1 to installthe latest plugin.

Please email Shopgate with the following details each time before updating:

To: [email protected]

Subject: Request an updated Shopgate plugin (custom adaption)

Email body: Include your shop number and any additional info necessary. Where can I find my shop number?

Deactivate the old plugin. In Oxid version 4.6 and later, you can do so by navigating to Extensions > Module > Shopgate > Overviewand clicking the Deactivate button.

Uploadthe customized Shopgate plugin (the one you received in the email) to your server.

Set file permissions and activate theplugin.

That's it! Now you have successfully updated your Shopgate plugin.

Configure the Plugin

To find the setting for your Shopgate plugin, please click Master Settings -> Core Settings in the main menu on the left, then on the tab labeled Shopgate.

Basic settings

Configure your Shopgate credentials used to connect to the Shopgate system.

Shopgate Customer Number

Your customer number at Shopgate.

Shopgate Shop Number

Your shops number at Shopgate.

Shopgate API Key

Your API key assigned by Shopgate.

Mobile Website

Set up your mobile website and redirect.

Alias

The alias is the subdomain of shopgate.com, e.g. myshop.shopgate.com, where your mobile website can be found. This is used as a fallback if no CNAME is configured.

CNAME

A CNAME is a subdomain of your own domain that points to your mobile website. For example, a CNAME could look like "m.myshop.com". To configure a CNAME, please log on to your server hosting website. For more information, please read our help article Adding a CNAME record in your domain host

Language

A comma-separated list of (e.g. en, de, fr) that should be redirected to your mobile website. Leave this blank to redirect all languages.

Type

Redirect users via HTTP-Header if possible - its fastest and best for search engines. If you experience trouble using HTTP-Header redirect, try JavaScript.

Frequently Asked Questions

A "system health check" notice appeared after I installed the Shopgate plugin. What should I do?

As shown in the graphics below, the collations of some fields are incorrect.

To fix this, please navigate to Service > Tools to execute the following SQL commands.

For systems that work with ISO:

ALTER TABLE `oxordershopgate` CHANGE `OXID` `OXID` CHAR( 32 ) CHARACTER SET latin1 COLLATE latin1_general_ci NOT NULL;ALTER TABLE `oxordershopgate` CHANGE `OXORDERID` `OXORDERID` CHAR( 32 ) CHARACTER SET latin1 COLLATE latin1_general_ci NOT NULL;ALTER TABLE `oxordershopgate` CHANGE `order_number` `order_number` VARCHAR( 20 ) CHARACTER SET latin1 COLLATE latin1_general_ci NOT NULL;

For systems that work with UTF-8:

ALTER TABLE `oxordershopgate` CHANGE `OXID` `OXID` CHAR( 32 ) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL;ALTER TABLE `oxordershopgate` CHANGE `OXORDERID` `OXORDERID` CHAR( 32 ) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL;ALTER TABLE `oxordershopgate` CHANGE `order_number` `order_number` VARCHAR( 20 ) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL;

How do I know if my OXID system works with UTF-8 or ISO?

Navigate to Service > Systeminfo. You should find a table that contains iUtfMode.

In the column on the right side of thepage, you can see the number 0 or 1.

If you see the number 1 in this column, your system works with UTF-8.

If you see the number 0 in this column, your system works with ISO.

I have multiple shops under myOxid Enterprise account. Can I create a mobile shop for each shop individually?

Yes, of course! You are able to create separate mobile shops and apps for each shop under your account.

To do so, go to your Oxidbackend, select a shop, then enter your Shopgate credentials as shown below.

Shopgate supports Shopware (versions 4 and 5) as a shopping cart system. this link

By setting up the Shopgate plugin for your Shopware (version 4 and 5) shop, you will get these featuresstraight into your mobile shop and apps:

For instructions on an older version of Shopware, please read Connecting to Shopware 3.5.

Supported Version

Import to PrestaShop

Shopware 4 and 5

Orders

Sync

Export to Shopgate Mobile Shop

Delivery Status "Shipped"Order Status "Canceled"Stock Quantity on Product Detail PageProduct Tax Classes, Rates, & Rules

ProductsCategoriesReviewsRelated Products, Upsell, & Cross-sell

Customer Account

Validate, upon Cart Changes

Login with Desktop ShopAccountLogin to Desktop Shopwith Mobile AccountCustomer Groups/Tier PricingShow Desktop Orders onMobile

/

Coupon*Shipping MethodPayment Method**Product Availability

Supported Payments

Notes

ShopgatePayPalPayPal PlusCash on DeliveryPrepaymentInvoiceDirect DebitBillsafeSofort. (until Shopware 5.2.12)Amazon PaymentsPaymorrow (Invoice)

Up-sell products and DHL module supported.

Product and brand searches done in a search engine on a mobile device are now redirected to the shop's mobile website.

*Shopgate coupons will NOT work when the DHL module is used. Regular shop coupons are not affected and will continue to work on the desktop and the mobile sites.

** The payment validation feature allows you to offer specific payment options to targeted carts and customers. The availability of this feature depends on your PrestaShop settings.

Install the Shopgate Extension

Installing the Shopgate extension for your Shopware shop is fast and easy using these steps. However, if you would rather install using a zip file, please refer to our Frequently Asked Questions section at the bottom of this article.

Simply go here and get the Shopgate extension by clicking Add to shopping cart. This extension is completely free for Shopgate users.

Finish the checkout process. Log in with your Shopware ID and passwordif you are not logged in yet.

Install the extension by following the instructions.

That's it! Now the Shopgate extension has been installed in your Shopware shop.

Establish the connections

After the Shopgate plugin has been installed successfully, two simple tasks need to be completed to connect your Shopgate mobile shop to your Shopware backend:

You must enter API credentials in your shop's backend.

You must enter your shop's URL into your Shopgate's admin page.

Get API credentials

Log in to your Shopgate Admin page.

Click Integration from the menu bar, then select Install Interface.

In the drop-down labeled Select system, search for Shopware 4.x and select it.

A pop-up will open. Look for Customer number, Shop number, API key, and Alias under 2. Configure. These are the API credentials the plugin needs to authenticate at the Shopgate backend. Leave this page open - we will come back to enter the URL (explained in Establish connections ).

Copy Customer number, Shop number, API key, and Alias, and paste them individually into the plugin configuration page in your Shopware Admin (Configuration -> Plugin Manager -> Shopgate Extension Settings). The rest of the options can be configured later. (This is explained in Configuring the Plugin ). Click Save plugin settings.

Connect your shop to Shopgate

Go back to the pop-up window at your Shopgate merchant page.

Under 3. Enter URL, enter the URL of your shop, ideally starting with https://. For example:https://www.MyAwesomeShop.com. Click Connect to establish the interface.

If a connection is made successfully, the pop-up shown below will open. Here you will be able to assign jobs to your first connection. We recommend leaving all assignments to ON at this time. Click Save.

That's it! Now the Shopgate backend will automatically start to import product data via the newly established interface. Welcome to the mobile world!

Update an existing plugin

Before updating your Shopgate plugin to a newer version, make sure to check if your shop uses a customized version of the Shopgate plugin. If this is the case, a generic plugin update will NOT work for your shop.

You are using a customized version if:

You have contacted Shopgate for making a third party plugin to work in your mobile shop, or for adding a special feature/function.

Shopgate has sent you an adapted version of the plugin.

The plugin file you installed has "adaption" in the name.

Once you know if you are using a customized Shopgate plugin or not, follow the instructions below to update it:

Generic Plugin Customized Plugin

Download the latest plugin and upload it to your Shopware Admin.

After a newer version of the plugin is successfully uploaded, a new button will appear in the Action(s)section. Click on it to update the plugin automatically.

If no update buttonappears, save your current Shopgate plugin configurations somewhere else, and click Reinstall plugin. Now you need to configure the plugin again with the data you saved before the reinstall.

Please email Shopgate with the following details each time before updating, then follow the instructions above to install it manually.

To: [email protected]

Subject: Request an updated Shopgate plugin (custom adaption)

Email body: Include your shop number and any additional info necessary. Where can I find my shop number?

Configure the Plugin

In the configuration panel of your Shopware Admin (Configuration -> Plugin Manager -> Shopgate Extension Settings), you are able to configure the plugin further.

Setting Options Explained

Active

Select Yes to activate the Shopgate plugin for your shop.

Customer number

This is your Shopgate Customer number. See Chapter 2.1 for more information.

Shop number

This is your Shopgate Shop number. See Chapter 2.1 for more information.

API key

This is your Shopgate API Key. See Chapter 2.1 for more information.

Shop alias

This is your Shopgate Alias. See Chapter 2.1 for more information.

CNAME

This is a subdomain of your own domain that points to your mobile website. For example, a CNAME could look like "m.myshop.com". To configure a CNAME, please log on to your server hosting website. For more information, please read our help article Adding a CNAME record in your domain host.

Root Category

Choose the root category of your shop.

Redirect Type

HTTP redirect is recommended for better performance and search engine rankings. However, using external cache engines (e.g. Varnish) might cause problems such as a "redirect loop." In that case, use JavaScript redirect instead.

Redirect Homepage is Blog

If checked, it is redirected if your homepage is a blog.

Order state if shipping is not blocked

Set order status to Offen if shipping is not blocked.

Shipping method for incoming orders

Select a fixed shipping method for Shopgate orders. Will be used incase the imported order shipping method cannot be mapped.

Send order confirmation mail to customer

Allow Shopware to send an email notification for each new order imported from Shopgate

Products description layout

Choose the field for the productdescription for the product export.

Products downloads export

Choose here how to export downloads of products.

Einheit fr Produktmae

Choose here which unit you want to use for product measures.

Attribute ids for product export

All attribute ids will be exported in the property section of the product. Example:3 for attr3

Artikel-Eingabefelder an Beschreibung anhngen

Choose a list of attributes which is additionally attached to the description.

Shopgate server

Do not change this setting unless instructed by your Shopgate support personnel.

API URL

Do not change this setting unless instructed by your Shopgate support personnel.

Frequently Asked Questions

Why is "generic payment" displayed instead of SOFORT berweisung/Paypal/Credit card?

Payment methods that could not be automatically assigned from the Shopgate plugin will be listed as "Generic Payment."

Why couldn't my orders transfer from Shopware to plentyMarkets ERP system?

If you use the plentyMarkets ERP (Enterprise Resource Planning) system in your Shopware Shopping Cart System, it is a known issue that Shopgate orders may not be transferred correctly.

To fix it, please make the following changes to the plentyMarket Connector Module in your Shopware settings:

Navigate to Settings ->plentyMarkets.

In plentymarket's configuration page, click theSettings tab.

Look for "Shopgate Zahlungsart(en)" under the section "Export Auftrge."

In the text field, select "Generische Zahlungsart von Shopgate - Greift, wenn keine passende Zahlungsart gefunden wurde" and "Shopgate Zahlungsart - Der Zahlungsfluss luft ber das Shopgate-Konto."

Why did an order fail to transfer?

This may be caused by the DHL module.If you use the DHL module in your Shopware backend, an error might occur when a customer uses mobile coupons (that is, coupons created in your Shopgate Admin ). However, desktop coupons created via your Shopware backend should not cause this issue.

How do I install the Shopgate extension using the zip file?

You can also install the Shopgate extension for Shopware by downloading the zip file called shopgate-shopware-integration.zip via then uploading it to your Shopware shop backend:

Log in to your Shopware Adminand navigate toConfiguration -> Plugin Manager.

On your Plugin Manager page, select + Add plugin manually. A new window will appear. Click Select plugin, select the zip file you just downloaded, and click Upload plugin.

After the Shopgate plugin has been successfully uploaded, the Shopgate plugin should be listed in the Plugin Manager as inactive. To activate the plugin,click the green + button on the right.

A configuration section will open. Check the box "Activate plugin" to activate the Shopgate Plugin.

That's it! Now you have installed the Shopgate plugin for your Shopware shop using the zip file.

If you're based in the US and need to update your payment method, please contact Shopgate support.

Accept credit card and PayPal payments in the US and Australia with Braintree.

Collect information

To connect your Braintree account, log on to your Braintree account to look for the following:

Transaction Type

Use the same transaction type that is configured in your Braintree account. For explanations of the types listed here, refer to this article.

Merchant IDPublic KeyPrivate Key

You can find these under Account My user. Then click API Keys under "Authorization." Your Public Key will be displayed. To view your Private Key, click View. You should be able to see Public Key, Private Key, and Merchant ID listed. Shopgate Admin

Fraud check

Contact Braintree if you would like to have this feature in your account. To use fraud check in your app and mobile website, turn this option to ONin Shopgate. (More info on that later.)

Supported credit cards

Navigate toSettings Processing Processing Options Merchant Accounts. Here you will be able to find the Accepted Payment Methods.

Set up Braintree at Shopgate

To set up Braintree as a credit card payment provider, please complete the following steps:

Log in to your and navigate to Settings Payment.

In the section labeled "Add payment method," search for"Braintree," and select it under "Credit Card" from the drop-down list.

Enter your Braintree account information. Your account information will be validated automatically.

That's it! Braintree is now successfully set up as your credit card payment provider.

If you're based in the US and need to update your payment method, please contact Shopgate support.

Shopgate supports Prepaymentas a payment method. By setting up thisoption at Shopgate, you will be able to accept customer paymentsfrom the available marketplaces:

Your Own Prepayment

USA

No

UK

No

Germany

Yes

Austria

Yes

Switzerland

Yes

Poland

Yes

France

Yes

IMPORTANT: This payment will be processedentirely byyou.

In this article, you will find informationto set up your own prepayment for your mobile website and apps.

To set up prepayment viaPAYONE, please read this article.To set up prepayment via Shopgate Payments, please read this article.

To set up your own prepayment, please complete the following steps:

Log in to your Shopgate Admin page.

Click Settings from the menu bar, then select Payment.

Find the "Add payment method" section, search for "Prepayment", and select Prepayment under"Payment method."

IMPORTANT: If Prepayment via Shopgate is already pre-installed in your shop, please delete this payment by clicking on Config,then Delete. Then you'll be able to add your own prepayment method.

In the pop-up window, enter your bank account information. The required information includes name of the Account holder, name of your bank, Country of the bank account, IBAN, and BIC numbers. Click Save to activate thePrepayment option.

Note: You can set all prepayment orders to free shipping, or to charge additional fees for all prepayment orders. To do so, slide the slider(s) to Yes. You will reveal more options under Free shipping or Additional charges.

That's it! Prepayment is now successfully set up as one of your payment methods.

Want to receive an email notification every time an order has been placed? No problem. Follow the steps below to find out how.

Log in to your Shopgate Admin page.

ClickIntegration from the menu bar, then selectE-Mail Notification.

On the Order Notification page, enable the notification by turning the slider to ON. Enter the email address you want to receive these notifications at. Click Save.That's it! You have successfully allowed order notifications to be sent to your email. To disable it, simply turn the slider to OFF.

If you're based in the US and need to update your payment method, please contact Shopgate support.

SOFORT Banking is available as a payment service provider onShopgate.

Getting started

Supported countries

By setting up your SOFORT Banking account at Shopgate, you will be able to accept payments from these available marketplaces:

SOFORTBanking

USA

No

UK

Yes

Germany

Yes

Austria

Yes

Switzerland

Yes

Poland

Yes

Netherlands

Yes

France

No

Collecting necessary information

Please prepare the following information before you set up SOFORT Banking as a payment at Shopgate.

If you don't already have an account at SOFORT Banking, please register for one here.

Account Info

Description

Configuration Key

A Configuration Key is used to exchange information with your SOFORT Banking account via API.

If you don't already have one, follow the instructions here to generate a configuration key.

Additional Settings

To set up additional charges or discounts, read Setting up additional fees and discounts of a payment.

Generating Configuration Key

To connect your SOFORT Banking account at Shopgate, you will need a Configuration Key. Please follow the steps to generate and locate it.

Creating a project for your mobile shop

To generate a Configuration Key for your mobile payments, you need to create a Gateway project first.

Log into your SOFORT Banking account. Under "Projects," clickNew project, then Create project.

Select Gateway project, then Create project.

You will now enter some information for your new project according to this table. The rest of the fields can be completed to your own likings. Click Save.

General Settings

Project name

We suggest using your shop's name with a "Mobile" added to the end.

Shop system

Select the shop system of your desktop shop.

Website

Enter the URL of your mobile website.

Settings for all payment methods

Success link

Leave the fields as they are. Shopgate will provide the links to SOFORT via the API connection.

Abort link

Now a project for your mobile shop has been created.

Locating your Configuration Key

After you have created a Gateway project, aConfiguration Keyshould be generated for you.Simply look for the section labeled "Services" on the left and click onAPI-Key. Your Configuration Key will be displayed in the middle of the page.

Allowing the Shopgate IP Address

If you have set restrictions to IP Addresses, please allow the Shopgate IP Address in the section labeled "IP restrictions."

Find the menu point Services > API keyon the left,then scroll to the bottom of the page. This section is directly under the Configuration Key section.

If an IP address is entered here, please allow the Shopgate IP address by adding176.34.154.104via the + to your restriction list.

Setting up SOFORT Banking at Shopgate

To set up SOFORT Banking as a payment method, please complete the following steps:

Log in to your Shopgate Admin page.

Click Settings from the menu bar, then select Payment.

In section labeled "Add payment method," search for "SOFORT Banking" and select it when it appears.

Enter your SOFORT Banking account information in the pop-up window and click Save.

That's it! SOFORT Banking is now successfully set up as your payment provider.

To reduce the effort of answering the same questions over and over again, tryto collect these questions and answer them on your FAQ list.

Shopgate Admin

What is an FAQ list?

The abbreviation "FAQ" means Frequently Asked Questions.It is common that shops get questions from customers. Basic questions like "How do I get free shipping?" or "How do I exchange a purchase?" often surface. An FAQ list allows you to list these basic questions with answers so you avoid a flood of questions.

How to set up an FAQ list?

Log in to your.

Navigate toSettings FAQ List.

Click+Add new entryto create a new question and answer.

When the pop-up opens, insert your question in "Question"and the answer in "Answer."

ClickSave.

ClickEditto change an existing question and answer.

You can see the menu point "FAQ List" in your apps and mobile website as soon as you have created one question.

That's it! You've successfully created an FAQ list!

You can create or import a list of coupons via a singleComma-Separated Values (CSV) file for your apps and mobile website.

Shopgate Admin

To create a mobile coupon in your Shopgate Admin manually, read Setting up coupons.

Create a Coupon CSV file

Creating a ".csv" file containing the details of your coupons is easy - just make sure to follow the file structures carefully. There are two ways to do so:

1. Export coupons as a ".csv" file.

Many shopping cart systems provide this option.

Check and modify the file to meet the rules and structures explained below.

2. Create a ".csv" file manually.

Use a spreadsheet program such as LibreOffice. Here is a sample file to help you get started.

Make sure to usesemicolons (;)to separate the columns.

GeneralRules about the Coupon CSV File:

The file must be encoded in UTF-8.

Each row can only contain data on one coupon.

Rows should be separated with a line feed (\n) (UNIX text format).

Use double quotes (") to indicate column boundaries (Text delimiter).

All coupon codes must be unique.

Save your file as in ".csv"format.

Exportyour text file using the correct "Field delimiter" (comma, colons, semicolons, space, or tab).

Coupon CSV Structure

To make sure that your coupons can be imported correctly, follow the file structure as explained in the table (below). Here's a sample file for comparison.

Column name

Description

Example

1

code

Each coupon must have a unique code. Punctuations or symbols are not allowed. The only exception is the hyphen (-).

ABC123

2

item_number

An item number is required for each coupon. You can use the default value "COUPON."

COUPON

3

public_name

This is the coupon name displayed at checkout and on the receipt.

Coupon x

4

description

This denotes the internal description or comments on the coupon.

Comment

5

amount

This lists the value of the coupon.

50,00

6

currency

This is the currency code you'll use.

USD, EUR, GBP, CHF

7

discount_percent

This is the percentage discount value (not applicable to shipping costs). You cannot use decimals here.

10

8

is_free_shipping

Enter 1 to offer free shipping when this coupon is used.

1 or 0

9

minimum_order_amount

This denotes the minimum order value to use the coupon.

This value must be 0 or higher than the value of the coupon.

50,00

10

valid_from

The coupon is valid from the date you enter. Use format yyyy-mm-dd

2012-01-24

11

valid_to

The coupon is valid until this date.Use format yyyy-mm-dd

2012-06-24

12

is_valid_iphone_app

Enter 1 if you allow the coupon to be used in the iPhone app.

1 or 0

13

is_valid_ipad_app

Enter 1 if you allow the coupon to be used in the iPad app.

1 or 0

14

is_valid_android_app

Enter 1 if you allow the coupon to be used in the Android app.

1 or 0

15

is_valid_wp_app

Enter 1 if you allow the coupon to be used in the Windows app.

No longer in use. Enter either 1 or 0.

1 or 0

16

is_valid_webapp

Enter 1 if you allow the coupon to be used in the mobile website.

1 or 0

17

is_valid_marketplace

Valid for the Shopgate Marketplace.

No longer in use. Enter either 1 or 0.

1 or 0

18

is_valid_standalone

Enter 1 if this is valid in your iOS or Android app.

1 or 0

19

restricted_item_numbers

Restrict your coupon only to the item number(s) listed here. Separate each item number with a "||". Leave empty to apply the coupon to all products.

987654||123456 or empty

20

excluded_item_numbers

Exclude your coupon from the item number(s) listed here. Separate each item number with a "||". Leave empty to apply the coupon to all products.

123456red||123456blue or empty

21

restricted_category_numbers

Restrict your coupon only to the category number(s) listed here. Separate each category with a "||".Leave empty to apply the coupon to all products.

159||753 or empty

22

excluded_category_numbers

Exclude your coupon from the category number(s) listed here. Separate each category with a "||".Leave empty to apply the coupon to all products.

159men||753men or empty

23

restricted_country_ids

Restrict your coupon only to the country code(s) listed here. Separate each country with a "||". Leave empty to apply the coupon to all countries.

us||de||fr or empty

24

redeem_limit

Set how you allow your customers to redeem the coupon: the coupon can be used only once (first come first serve), once per customers, or as many times as the customer wants.

'unlimited', 'once_per_user', 'once'

25

is_promote

Specifies whether the coupon should be displayed in a public list.

No longer in use. Enter either 1 or 0.

1 or 0

26

is_active

Enter 1 to activate the coupon.

1 or 0

Upload the CSV file

To upload the CSV file you created, log into your and find the Coupons page.

Navigate toMarketing Coupons.

On the Coupons page, click Import.

Click Select fileto upload the CSV file. Click Save.

Now the couponsshould appear in the coupons list. Check if the details are correct.To make any changes, simply update your CSV file and upload it again.

That's it! You have successfully uploaded a coupon using a CSV file.

Notifications generated by a mobile app while the app is not actively in use are called push notifications*. Push notifications commonly appear as pop-up dialogs, banners, or small badges on the app icon, according to the user's settings.

On Shopgate apps, push notifications are used for marketing and communication purposes. When correctlyset up, your customers can get timely information on special offers, discounts, new products, and much more.

this article

At the moment, a push notification can open 5different kinds of pages:

Page

Description

Product

The details page ofthe product you selected.

Category

The category page you selected.

Page

The app page you selected. This can be the homepage, cart page, or any page you created.

Coupon

The cart opens, with a coupon code you selected added to the cart.

Search Query

The search page withthe pre-defined results.

* Your customers can only receive push notifications if the app is not actively being used in the foreground.

Send/Schedule a push notification

Step #1: Create a new notification.

To find the push notification page at Shopgate, follow these steps:

Log into your Shopgate Admin.

Navigate toMarketing Push Messages. Here you will see a list of your push notifications.

ClickCreate newto create a new push notification If you already have a push notification created, clickAction Editto make changes.

A pop-up window will open. Configure your push notifications here. For ideas, tips, and tricks, read Best practices for push notifications.

Step #2: Configure the notification using the options provided to you by Shopgate.

Description

Audience

Specify who will receive this push notification.

All users

Use this option to sendpush notifications to everyone who has installed yourapp and allowed the app to receive push notifications.

Specific users

Use this option to send a notification to specific usersor totest your push notification.

Segments

Send a push notification to a segment of users. For more information on this, read our page on User segments.

Schedule

Set a time to send the push notification. This function is not available for sending to "specific users."

Destination

Specify what the push notification should do when opened by a user. These options are listed in the table above.

Message

Enter the content of your push notification here. Limited to 155 characters per notification. Learn how to insert emojis in your push notifications.

Test your push notification

Testing your push notifications before sending them out to the customers is always a good idea.

Anyone with a valid customer account can be a test user. You can send your test push notifications to multiple users at a time.

Here are a fewthings to keep in mind when testing a push notification:

Test users must first install your mobile app on their smartphone or tablet.

Test users must log into the app to receive push notifications.

Test users must select Agree in the app when asked to receive push notifications.

The test email address must be registered in your mobile app as a customer account.

Notifications will be sent immediately - you can't schedule a test notification.

To test a push notification, follow the steps below:

Ask your test user toinstall your live app onto asmartphone or tablet.

Ask your test user to log in or register an account with your app.

In your Shopgate Admin, create a new push notification (Marketing Push Messages +Create new).SelectSpecific users. Enter the email address of your test user's app account email (one email per line) inthe text field below.

ClickSaveto complete the process and return to the push notifications list.

Frequently Asked Questions

How do I use emojis in a push notification?

To insert an emoji in a push notification, follow these steps:

Go to Marketing Push Messages +Create new in your Shopgate Admin.

Visit an emoji website such as https://emojikeyboard.org/ or http://emojipedia.org/ and copy the emoji you want to use.

Paste it in the "Message" field.

Mac users can also bring up the emoji window byusing the keyboard shortcut "ctrl + cmd + space" and clickon an emoji to insert it.

The emojis might look different on different devices. Some of the news emojis may not be supported on the older devices. Test your push notification to make sure the emojis show up as you want them to be.

Why do I see more opens of a push notification on Android?

Due to the different usability of push notifications, studies have shown that on average, the open rate on Android is three times higher than that on iOS. Read for more information.

Why are my customers not receiving push notifications?

When the app is actively running in the foreground, customers will NOT receive any push notifications. Push notifications are only received if the app is closed or running in the background.

Best practices for push notifications

The best push notifications are those that areshort and actionable.In general, iOS users see around 120 characters, while Android devices only show about 40 characters without the notification being expanded. Because of this, your users may only see the first half of a sentence when your push notification pops up.

To make the most of this, use these tips:

Try to place the mostimportant keywords at the beginning.

Shorten the notification to one line, if possible.

Use emojis instead of words to save the precious screen real estate and attract attention at the same time!

Another good practice is to give users incentives to tap or slide on your push notifications. Only send a push notification when there is something your users can act upon, such as:

A coupon

A sales event

Anabandoned cart that needs to be completed

Create, measure, and optimize Facebook Ad campaigns on your mobile website simply by using Facebook Pixel.In this article, you will find everything you need to set up Facebook Pixel tracking at Shopgate.

NOTE:You cannot use Facebook Pixel tracking for the Facebook conversion tracking pixel (old).If you're using the Facebook conversion tracking pixel, read this article instead.

Getting started

Facebook Pixel is a piece of JavaScript code embedded in your mobile website.

It can report conversions, build audiences, and provide insights into how people use your entire mobile website.

To set up Facebook Pixel tracking on your mobile website, please collect the following information:

Account Info

Description

PixelID

Create one by following this guide.

If you use a Facebook conversion tracking pixel, you can transform it into Facebook Pixel by following this guide.

Setting up Facebook Pixel in the Shopgate Admin

To connect Facebook Pixel as a tracking service provider, please complete the following steps:

Log in to your Shopgate Admin page.

ClickSettings from the menu bar, then select Tracking Tools. Facebook Pixel

Locate the Facebook Pixel section, turn it to ON,and enter your Pixel ID. Click Save.

That's it! Facebook Pixel has been set up for your Shopgate mobile website.

Frequently Asked Questions

Can I use Facebook Pixel to track my mobile apps?

No. The Facebook Pixel can only be embedded in a website, not an app. To set up tracking for your mobile apps, use Facebook Analytics for apps.

Where can I find my Facebook Pixel ID?

To find the Facebook Pixel ID, go to yourpanel and look on the right-hand side.Your Pixel ID should show up here.

All merchants who wish to publish an iOS app are required to enroll in the Apple Developer program.

In this article, we will walk you through the process to enroll in the Apple Developer Program as a single-person business.

[email protected].

Set up at Shopgate

Enroll in the Program

Create an Apple ID

Create an Apple ID

Use an existing email addressassociated with your company to create an Apple ID.We recommend using an email address that multiple people in the company can access, such as your support or info email. If you don't have a company email address, please create one first.

Create Your Apple ID.

Enter your company email in the form and fill out the rest. This email will be your new Apple ID. Apple will send important actions or decisions regarding your app to this email. Please make sure to check your email regularly.

A 6-digit verification code is sent to you via email. Enter the code in the pop-up that opens. This code will expire three hours after the email was sent.

Your Apple ID is created. Make sure to turn off "Two-factor authentication" for your Apple ID. Please be aware that creating an Apple ID is NOT the same as creating an Apple Developer account.

Enroll in the Program

Once your Apple ID is created, open the Apple Developer Program Enrollment page.

Click Start Your Enrollmentand sign in with your new Apple ID.

Read and agree to the Apple Developer Agreement. Click Submit.

Now your Apple Developer Program will open. Select the block Join the Apple Developer Programon the Welcome page and click Enroll on the next page.

In the field "I develop apps as," select Individual/Sole Proprietor/Single Person Businessas yourEntity Type. Click Continue.

Enter your legal name, phone number, and address on the next screenand click Continue.Your legal name will be displayed as your app's seller in the App Store.

Important Note: the legal owner of the company must register for the Apple Developer account.

Accept the "Apple Developer Program License Agreement" by checking the box on the bottom of the page and clicking Continue.

On the next screen, review your purchase details and select the option Automatic Renewal. If Automatic Renewal is not used, please set a reminder on your calendar (repeat yearly) to renew your membership every year. Your app will be removed from the App Store within 24 hours upon the expiration of your membership.

You will now be forwardedto the App Store. Log in again with the same Apple ID and password.

On the next screen, pay $99 with your credit card and click Continue.

Accept the Terms & Conditions and click Continue. Follow the onscreen instructions until you see the "Thank you" page.

You have now enrolled successfully in the Apple Developer Program.You will receive two welcome emails and a payment confirmation from Apple at your Apple ID email address within anhour or so.

Set up at Shopgate

Your Shopgate team works hard to create and update your app. In order for our team members to do their job, please enter the information for your Apple Developer account at Shopgate.

Log into your Shopgate Admin.

Navigate to Settings Native Apps Apple Developer Account.

SelectIndividual/Sole Proprietor/Single Person Businessand click Continue.

Enter your Apple ID and Password,then clickConfirm Setup.

That's it! You have now finished setting up your Apple Developer account! Wewill create and upload your iOS app within a few days. You will get an email confirmation from Apple once this process is complete.

For more information on Apple Developer account, please visit Apple Developer Support.For questions about the enrollment process, please contact us at [email protected].

Frequently Asked Questions

Should I enroll as an individual or organization?

If your company is a corporation (Corp., Inc.), limited liability company (LLC, LC, Ltd. Co.), or a legal entity (GmbH, AG, KG, oHg, etc.), you must enroll as an organization or your app will be rejected.

If you are a sole proprietorship or a single person company, you must enroll asan individual.

Why should I turn off "Two-factor authentication" for my Apple ID?

Having the authentication turned off will ensure a smooth process for creating and updating your app.

"Two-factor authentication" requires a 6-digit verification code every time someone tries to login with the Apple ID. This code displays on a "trusted" Apple ID device, such as your iPhone, iPad, or Macbook. Since Shopgate does not have access to your personal devices, we will have to call you immediately every time we try to upload your app, create the necessary certificates, make changes, or update your app. If you are not available within the short period of time your 6-digit verification code is valid, we will NOT be able to do anything. Therefore, we strongly recommend having the"Two-factor authentication" feature off for this Apple ID.

If you enrolled in the "older" version of the service called "Two-step verification," please turn this off as well.

Can I enroll as an individual and have my company appear as the seller on the App Store?

No. To have your company name appear as the seller, you must enroll as an organization and your company must be recognized as a legal entity. If you are a sole proprietor/single person business, you must join as an individual and your legal name will appear as the seller.

If you have enrolled as an individual by mistake and need to convert your individual membershipto an organizational membership, please contact us at

How does the enrollment work?

When enrolling as an organization, you can review the license agreement and purchase a membership afterApple Developer Support has verified yourenrollment and sent you an email with the next steps. You can check your enrollment status in your Apple Developer Program. Be sure to sign in with the Apple ID you used to enroll.

Individuals and sole proprietors/single person businesses can review the license agreement and purchase a membership at the time of enrollment.

How much does a membership cost?

The Apple Developer Program membership is $99 per membership year in the United States and 99 in Europe. This cost is the same for an individual membership and an organizational membership.

To provide a long-standing app, you must renew and pay for your membership every year.

Magento 2 is a supported shopping cart system at Shopgate.

URL key used by the CMS page in Shopgate

By setting up Shopgate plugin inyour Magento 2 shop, you will get these useful featuresstraight into your app and mobile website:

Support

Import to Magento 2

Version

2.1+

Orders

Customer Account

Export to Shopgate Mobile Shop

Login with Desktop ShopAccountLogin to Desktop Shopwith Mobile AccountCustomer Groups/Tier PricingShow Desktop Orders onMobile

/

ProductsCategoriesReviews

Sync

Validate, upon Cart Changes

Delivery Status "Shipped"Order Status "Canceled"Stock Quantity on Product Detail Page

CouponShipping MethodPayment MethodProduct Availability

Supported Payments

Notes

Currently, payment methods are not mapped to the native Magento 2 implementations. This means that orders imported from Shopgate can NOT be captured or refunded from your Magento 2 backend.

Other supported features:

Info from the Shopgate custom fields (second phone number, birthdays, etc.) is now imported as order details in your Magento 2 backend.

Group, configurable, and simple products

Group pricing for simple and configurable products

In this article, you will find everything you needto set up the Shopgate plugin for your Magento 2 shop.

Install the Shopgate plugin

Before you install or update the Shopgate plugin

disable Magento cache if enabled

disable all external caching (e.g. Varnish, APC, ZendCache) ifused

After you install or update the Shopgate plugin

enable Magento cache again

flush the internal cache and all external cache immediately

Download the Shopgate plugin

Download the Shopgate extension for Magento 2 from the Magento Marketplace.

Follow these instructions to install the Shopgate extension in your Magento system.

Alternatively, you can use the command line and composer to install the extension. Our component name is "shopgate/cart-integration-magento2-m2". For more information on this method, review Magento's Composer Installation Guide.

Connect the plugin to Shopgate

After the Shopgate plugin has been installed, follow the steps here to connect your mobile shop to your Magento 2 backend.

Log in to your Shopgate Admin.

Navigate toIntegration,thenInstall Interface.

In the New Connection section, search for "Magento 2" in the drop-down and select it when it appears.

A pop-up will open.

Get API credentials

In the pop-up, copy Customer number, Shop number, API key, and Alias and paste them individually into the plugin configurations in your Magento 2 admin panel: Stores> Settings > Configuration.

The rest of the plugin configurations can be entered later, with instructions listed later in this article.

Connect your shop to Shopgate

Under 2. Enter URL, enter the URL of your shop. Click Connect to establish the interface.

If a connection is made successfully, the popup shown below will open. Leave all assignments to ON to access all the features. Click Save.

That's it! Now the Shopgate backend will automatically start to import product data via the newly established interface.

Understand the plugin configurations

To locate the Shopgate configuration, follow the steps here:

Log into your Magento 2 Admin Panel.

Navigate to Stores> Settings > Configuration.

You will see Shopgatelisted on the configuration page.

Use these sections to configure your Shopgate plugin: Configuration, Export, Import,andAdvanced.

Shopgate | Configuration

Basic Configuration

Enabled

Select Yes to activate the Shopgate plugin in your Magento 2 backend.

Customer number

Your customer number at Shopgate.

Shop number

Your shop number at Shopgate.

API Key

Your API Key generated at Shopgate. This keyis used to authenticate your account between Shopgate and Magento.

Mobile Settings

Redirect Type

Select your redirect type: HTTP or JavaScript. HTTP is recommended because it is more SEO friendly.

Website alias

Your Shopgate alias.

Custom URL

A URL used for the mobile version of your shop. The default is [alias].shopgate.com, but an alternate could be m.[alias].com

CMS Map

This feature allows mapping a Magento 2 CMS page to a CMS page created in your Shopgate Admin. Provide the .

Shopgate | Export

Categories

Force export disabled categories

List a comma separated list of category IDs (e.g. 1,4,6,34) which should be exported even if they are disabled.

In navigation only

Export categories that only have "Include In Navigation" checked.

Products

Description

Choose how you want to export your descriptions:Short descriptionDescription + short descriptionShort description + description.

EAN attribute

Select the attribute used for the EAN from the list.

Miscellaneous

Net Market Countries

Use the default value from Magento 2 or select the countries where your product prices are defined before tax (e.g. United States).

Shopgate |Import

Order

Send an email to customer on new order

On each order import, the customer will get an order confirmation mail after the import. This flag should be used in conjunction with the "send confirmation mail" flag in the Shopgate merchant area.

Shopgate Shipping Carrier Title

This text field allows the merchant to define a shipping title for any shipping handled by Shopgate. This shipping title is used in emails and order details.

Shopgate |Advanced

Staging

Shopgate server

Select the Shopgate Live server. Use the other options only for debugging purposes.

Shopgate Merchant API URL

This field is used only when Shopgate server is set to custom and is only useful for debugging purposes.

.htaccess user

.htaccess user and password are only used to bypass additional htaccess authentications.

.htaccess password

Frequently Asked Questions

How do I flush or disable the Magento cache?

If you need to flush or disable the Magento cache in order to install or update a Shopgate plugin, follow the steps here. Remember to enable the Configuration cache again after the plugin is installed or updated.

Go to System > Tools >Cache Management.

ClickFlush Magento Cacheto clear the Magento cache.

To temporarily disable the Magento cache, select Configuration, set Action to Disable, then click Submit.

Now the Magento cache has been flushed and disabled.

When your app is live, you can start converting your sporadic customers into shop regulars simply by using our tips and tricks for successful app promotion.All you need isthe right marketing tools that will convince your customers to download your app--and you need to use it over and over.

Why should I promote my app?

Every customer who downloads your app offers great potential to become a regular. Marketing research shows that retaining regular customers converts more sales in the long run. Obviously, retention should be a great priority!

Of course, promotion comes in the form of advertising. There are two types of advertisements: organic, which does not cost you money, and paid.

Organic advertisement

Tip #1: Define the added value of your app.

The biggest key to advertising your app? Explain exactly why your customers should make the effort to download your app. You need to explain what added value they get out of an app that is simply not offered on your website. An especially efficient way of doing this is to advertise special offers and campaigns that are app-exclusive. The Shopgate feature Deal of the Day is an excellent example of an app-exclusive sales event. Even before you launch your app, include information about upcoming Deals of the Day or any other app-exclusive features you want to offer.

Remember, apps simply add more to the retail experience you offer your customers. Keep reminding them of that.

Tip #2: Promote your app using email marketing and newsletters.

Email marketing may seem old-fashioned as you prepare to blaze a trail in the world of mobile. However, email is anything but obsolete--and it can be especially relevant for app marketing. While you may feel like apps and social media are the biggest features on smartphones, the truth is that 51% of emails are now opened on mobile devices. Chances are, your customers will open your emails on the very devices that allow them to jump directly to your app.

The key to modernizing your email marketing is to keep it mobile-friendly. Here are some ways to keep your email campaigns relevant to your new app:

Keep your message clean and concise--exactly what smartphone users want to see as they flip between emails, texts, social media, and other apps.

On the day of your app launch, send an email blast that offers a promo code. That incentivizes every stage of the mobile process: promo codes convince users to download the app, open the app, and buy from the app. Promises of future perks like more promo codes also serve your goal of retention.

Another important rule to follow for initial app marketing via email: create a series of emails with a focus on messaging and keeping a cohesive tone. We recommend scheduling four emails over the span of two months.

You should plan to keep up email marketing during the life of your app. A regular newsletter is an excellent way to keep customers informed of new products, upcoming sales events, or to simply wish them well on an upcoming holiday. Shopgate allows you to add a newsletter sign-up form inside your app. Plan to include that in your app.

App Design

Tip #3: Use social media channels.

Obviously, any Internet-based business is rendered essentially useless without a social media presence. Social media is one of the most powerful organic marketing tools to have in your belt. Weve gathered some tips for specific social media channels to maximize the visibility and promotion of your new app.

Facebook

Pin a post advertising the app to the top of your shops Facebook page.

Include images in Facebook posts to catch customers eyes in their text-heavy timelines. Make sure these images are interesting and high-resolution.

Feel free to include a promo code to incentivize app downloads.

Twitter

Tweet an advertisement for your app (with a promo code!) and pin it to the top of your profile.

Retweet your happy customers if they mention you--its a form of organic advertising that only takes a click.

Instagram

Instagram prides itself on beauty and style, so images posted here should match that aesthetic. Instagram is unique in that it doesnt focus on text. Therefore, the most beautiful and creative graphics available should be used on this particular platform.

Master your hashtags. Instagram has a feature called hashtag following, which allows users to see posts using a particular hashtag without even following extra accounts. Figure out the most popular hashtags that are relevant to your brand and your products, and use them on all of your Instagram posts.

Create a unique but recognizable hashtag where users can submit images of the swag theyve bought from the app. Repost the best pictures, mentioning the users and the app in the captions. This doesnt only advertise the function of your app--it makes your brand more personal, which is one reason shoppers are turning to mobile.

Tip #4: Promote the app on your website.

Your customers already visit your website. Advertising there should be a no-brainer.

Desktop

Add a pop-up, landing page, or a feature on the order confirmation page to let purchasers know about the app. Theyve obviously seen at least one thing they like about your shop--give them so many more. Feel free to offer a promo code or free shipping on their first app order.

There are a couple of obvious places to advertise your app on your desktop site. Your websites About section is one. If your website has a blog, you should be dedicating plenty of content there to your app. Again, don't shy away from offering an incentive such as a promo code or free shipping on their first app order.

Marketing Spotlight: Shopgate merchant KicksUSA dedicated an entire page to advertising their mobile app. It showcases various features of the app, gorgeous screenshots of their products and app pages, and links to download it in the App Store and Google Play.

Mobile

Add a badge with a direct link to the iOS App Store or the Google Play Store.

Shopgate automatically generates a smart banner for your mobile website. Mobile smart banners use a fraction of the screen on a mobile website to automatically open up the app when its installed or to fall back to an App Store page if not.

Tip #5: Use in-store advertising, package garnish, and other forms of print advertising with QR codes for app downloads.

Remind your customers of the app using simple, old-fashioned paper. Using your shipping packaging, receipts/invoices, fliers, and whatever other paper you use, encourage them to download an app with a QR code.You can also advertise your QR code in public, such as on signs in your brick-and-mortar store that potential customers can easily reach and scan. Bonus: you can also add an automatic coupon to a QR code!

If you offer paper catalogs to your customer, Shopgate offers an app feature called Scan & Buy. It allows customers to take a photo of yourcatalog page and directly order the products.Using linked catalogs shows your customers that you attemptto offer more convenience and fun while shopping.

Tip #6: Optimize the discoverability of your app in the app stores.

When your app is uploaded to the App Store, you can start making the most of App Store Optimization.

Tip #7: Update your design from time to time.

Changeyour app design every now and then to draw the attention of your customers. These design updates are especially worthwhile around the holidays or other special campaigns.

Tip #8: Promote app reviews of your customers.

When your app has a lot of good reviews, this encourages possible customers to download it. Offer a coupon to your purchasing customers in exchange for a post-purchase review.

Paid advertising services

Tip #1: Use Facebook Ads.

Using Facebook Ads, you can draw attention to your app with advertisements on Facebook. Facebook Pixel and Facebook Analytics help you track Facebook customers' behavior so you can address the right target group.

Tip #2: Generate app installations usingGoogle Adwords.

In addition to granting you higher visibility, Google Adwords also allows you to track your mobile shop with Google AdWords.

More information on app promotion

Shopgate offers all of the above features, and more.

Learn more about easy app marketing over at our Marketing Tools page.

Ourtutorials also offer valuable information about how to make your app alluring and effortless for your customers, making them want to come back for more.

How do I request an app update?

Also known as ASO, App Store Optimization makes your app more visible to an in-store app search, helps them stand out from similar apps, and gives people more reasons to download them.Once your apps are live in the app stores, you want to make sure that people can find them. While you can tell friends and customers about it on your website and social network accounts, how do you make people who don't know your shop to find your apps, download them, and become your customers?

The answer is easy: take advantage of all the marketing features the app stores offer you.In this article, you will find ASO tips to make your apps more visible, attractive, and compelling in the iOS and Android app stores.

Seven ways you can maximize ASO:

App icon

App name

Subtitles

Keywords & categories

Feature image

App description

Promotional text

App screenshots

App ratings & reviews

ASO Tip #1: Create a simple app icon

People are unlikely to download an app with a cluttered and confusing icon design. A good app icon tells the story of your shop and grabs the attention of a potential customer. Before you learn how to configure your app's icon and other graphics, find out below what makes an icon pique the curiosity of app store surfers.

To please the eyes of your picky customers, follow these tips:

Use your shop logo.Make sure it is legible at icon-size.

Keep it simple.Usethe most representative element of your shop logo or name.

Use graphical elements.You don't need to include your shop's name in the icon. Ifthe shop name is part of the logo, make sure it's short and legible.

Try colors and see if they fit.Colorful icons can attract attention. Use the main colors of your shop logo.

Pay attention to details.Make sure theicon looks clear and attractive atsize 1024x1024.

Use the same icon across platforms.Use the same icon for Android and iOS apps, and for smartphone and tablet apps.

Try to avoid the following mistakes:

Too much detail on the icon.Too many words and images will look tiny and unprofessional.

Including shop descriptions in the icon.There areapp descriptions and keywords for that!

Too many colors or irrelevantcolors.

Making an icon too small.Your iconwill look blurry on a big device.

Using different icons for each platform.Your customers may be confused when they try to download your apps on a different device/app store.

ASO Tip #2: Add keywords to your app name

"Around 60% of apps are discovered through app store browses and searches."-- Forrester

Your app name is the most important factor in search. You can learn how to enter an app name and other key information here, but keep reading here to learn how to maximize the effect this information can have!

Feel free touse your shop name as your app name, keeping in mind that you have a maximum of 30 characters in both app stores. However,adding a few keywords toyour appnamecould greatly increase your chance of being discovered.

Try these tips when adding keywords to your app name:

Keep it short.Use 2-3 keywords--the most relevant keywords you can think of. Keep in mind that only the first 19-20 characters (including spaces) of an app name are always displayed in the app stores, depending on the page.

Make it interesting.Describe your specialty products and services--the facets of your shop that set you apart from your competition.

Be explicit.Make it clear that users can buy physical products from your app. Summarize which products you sell.

Use URL-safe characters.Try not to use accented characters or symbols like & or ~.

ASO Tip #3: Choose a subtitle (only)

You also have the option to add a subtitle for your app that will show in the App Store. This will be displayed directly below the app title and cannot exceed 30 characters. The subtitle is also used by Apple to index search rankings, so you should consider it carefully.

Tips for choosing the right subtitle:

Formulate your subtitle as a call-to-action. Install the app and register for 10% off!

Use your subtitle to convey an idea, an intention or even a slogan.Just do it!

Choose something simple and straightforward. Use a descriptive term or emphasize the purpose of the app, such as Transform photos into works of art."

Note: Subtitles will only appear on the App Store for customers with iOS 11 or newer and changes will require an app update in order to appear.

ASO Tip #4: Choose research keywords & categories( only)

Keywords and categories have a huge impact on search. The App Store ranks your app in a search according to the keywords and categories you selected. Therefore, selecting competitive, best-fitting keywords and categories are crucial to making your apps visible.

Follow these tips when selecting your keywords:

Use relevant keywords only.Describe theproducts you offer, where and how your products are used, what functions they serve,what makes them special, which group of people is your shop aiming for, and other important facets of your brand. Keep in mind that there is a 100-character limit.

Use athesaurus to help you find alternative words.Try different keywords which may reduce competition and bring your app to a higher ranking from a search.

Research your competitors' keywords.

Analyze keywords' popularity and difficulty.Search for an ASO tool on the Internet to analyze the popularity and difficulty of your keywords.

An easy style guide on keywords:

Separate your keywords with commas only.Spaces are not necessary and take up precious space. For example: go with "awesome,organic,farm,fruits,veggie" instead of "awesome, organic, farm, fruits, veggie."

Use single words instead of phrases.Use "organic,farm" instead of "organic farm."

Use the singular form of a word instead of the plural form.Use "banana" instead of "bananas."

Use numbers instead of words.Use "8" in place of "eight" to save space.

Beware of the following mistakes - some of whichmay result in a rejection from the app stores:

Don't use names or brands from existing apps or third party companies.

Don't use offensive words.

Don't use irrelevant keywords.

Don'tuse your app name or company name as keywords.They are automatically added by the App Store, which gives you more characters to use!

Don'tadd the word "free."This is automatically added for Shopgate mobile apps.

ASO Tip #5: Adding an eye-catchingfeature image (only)

The feature imageis a wonderful opportunity to highlight your Android app and promote your brand in a big and visual way.

Follow these tips when creating your feature image:

Image needs to be 1024 x 500 pixels and designed to scale.Your feature image needs to look good in both a full-size web browser and on a handset.

Create fun and enticing graphics.Be bold and creative when promoting your brand.

Use colors that stand out on a black or white background.

Don't use a text-heavy advertising-style graphic.

Don't overload the graphic with details.

ASO Tip #6: Adding a smart description

You can describe your shop's products and services in 4000 characters. This description will help customers to understand your business in more details. Please note that you need an app update to change the description.

If you're looking for tips to write a good description, read these tips:

Place your most important info first.Describe the most important information about your shop and app in the first three lines. The rest of the text is only visible by clicking "read more."

Explain what you sell and whyshould people buy from you.

List the features and benefits your app provides.

Include social proof.List awards, customertestimonials, blog post reviews, recommendations fromsocial networks, and other forms of praise you've received.

ASO Tip #7: Create promotional text(only)

In addition to the standard description, youre able to add promotional text which can be used to share the latest news about your app, such as limited-time sales, important updates, or other events within your app. This text can be up to 170 characters long. A simple sentence or two can capture the users attention and persuade them to install the app.

To get the best results from your promotional text, follow these tips:

Avoid long run-on sentences, instead opting for something short and sweet. Remember to keep it simple!

Be persuasive enough to convince curious users to download your app.

Note: The promotional text will only appear in the App Store for customers with iOS 11 or newer and does not require an app update to show.

ASO Tip #8: Personalized screenshots

Note: You do notneed to upload screenshots of your own. Shopgate will create genericscreenshots of your app's homepage, product pages, and checkout page at no extra cost for you.

Note:When creating your own screenshots for Apple devices please ensure that no third-party platforms are displayed. Examples of third-party platforms are products (android devices, software products) from companies that could be considered competitors of Apple.

App screenshots are your best trick to turn potential customers into buyers. If someone has come so far to look at your screenshots, you need to be prepared to show them your best work, catch their eye, and make your app scream "download me!"

At Shopgate, we generate screenshots for each device/size (iPhone 6, iPhone 5, iPhone 4s, iPad, and Android smartphones and tablets). However, if you'd like to usepersonalized screenshots, feel free to upload them to your Shopgate Admin by clickingDesign Logos.

If you're making your own personalized screenshots, try out these tips:

Use as many screenshots as possible.You can upload five screenshots for each device size at Shopgate. If you would like to add more screenshots, send them to [email protected].

Put your most relevant screenshots first.The first one and a half screenshots will be directly visible on the app's detail page. Make sure your first two screenshots are attractive and informative. Use your splash screen if it has a nice design and tells a story about your shop.

Upload a video.Madea demo video of your brand and products? Wantto include additional information?Send yourvideo to [email protected] !Yourvideo should be in mp4 format and should be12-30 seconds.

Beautify and explain your screenshots.You can spice up your screenshots by editing them in an app (such as PhotoShop). Frame your screenshots on a phone, use a background, highlight your products, and add a short explanation.

Please note that Shopgate automatically generates and updatesscreenshots for all shops when a new app design rolls out. If you noticed that we updated your screenshots, send us an email at [email protected]. We can reverse the updatefor you.

ASO Tip #9: Ask for ratings and reviews

It's no secret that mobile users tend to trust apps with good reviews and a fair amount of downloads. Once your app islive, it's in your hands to get a good start!

Try these tips to get ratings and reviews for your apps:

Advertise your apps to your current customers.Add a banneron your shop's website saying that you're now offering native apps. Notify your customers of this news inyour newsletters. In all of your online advertising, make sure to provide links to download the apps.

Ask existing customers to review your products and services.Ask people who have bought products from your shop to write a review in your apps.

Tell your fans and followers about your apps.Your fans and followers already like you - tell them to download and reviewyour apps! Try posting on Facebook, Twitter, Instagram, Pinterest, blogs, or whatever you use to connect with your customers.

Give a little incentive.Motivate your customers with a coupon after theydownload and review your apps.

Going live in the app stores

It's always a good idea to preview your apps before you let them go live in the app stores. This will provide you an opportunity to see what your customers see, and correct any mistakes or features you aren't happy with. Learn how to preview your apps here.

After you've taken your big leap into the app stores, you may want to update your apps, as we've advised above. Fortunately for you, we have a whole article dedicated to what you should update and how to do it. Readfor this information and more.

Enable your customers to ask questions and get answers from your support agents without even leaving your app. Intercom Live Chat can be integrated into your Shopgate app if you register for the Intercom Live Chat solution. (Unfortunately, Shopgate mobile websites are not supported by Intercom Live Chat.)

here

How to set it up

To install Intercom Live Chat on your app, you will need the following information:

Your Intercom App ID

Your iOS API Key

Your Android API Key

Collect account information from Intercom

Follow the steps here to generate the API keys and find your App ID at Intercom:

Log in to your Intercom account.

On the bottom left, navigate to Account (your profile picture) Settings.

On the next page, click App settings on top.

Scroll the menu bar down to locate the Installation section.

For iOS apps, select iOS. On the right, click Add to Setup Guide. Your iOS API Key and App ID will appear.

For Android apps, selectAndroid. On the right, click the button Add to Setup Guide. Your Android API Key and App ID will appear. This App ID is the same as the App ID on the iOS page.

Set up Intercom at Shopgate

To set up Intercom Live Chat in your Shopgate app, follow the steps below:

Log in to your Shopgate Admin and navigate to Settings Live Chat.

LocateIntercom Settingsand turn it to ON.

Enter your App ID,iOS API Key for iOS, andAPI Key for Android. Click Save.

After Intercom is configured, please contact Shopgate Support. Ourcustomer service will then recompile and submit your app to the App Store and Google Play Store. It could take a few days until your app is updated to include the Intercom Live Chat.

Add a widget to your app

To display the Intercom Live Chat in your Shopgate app, add a widget to your homepage and/or any other pages you want it to display.We suggest displaying the live chat widget on the homepage and a custom page dedicated to the live chat. The live chat custom page is easily accessible from the"More"menu located in the navigation bar.

Log in to your Shopgate Admin and navigate to Pages.

Select the page you want to add Intercom Live Chat on. Add an image or an image slider widget.

A pop-up will open. Click theLinkicon, then select PageIntercom chat. Click Confirm.

Finish the rest of the widget configurations. Click Save.

That's it! You have successfully set up your Intercom Live Chat.

Frequently Asked Questions

Do I need to sign up at Intercom to integrate the live chat in my app?

Yes! If you are already using Intercom Live Chat on your desktop shop, you can set it up on your app for no extra cost. If you would like to learn more about Intercom solutions, click.

Which of my customers can use the live chat feature?

Anyone who has updated the app to the latest version should be able to chat with your agent. This means the app version should be 10.7 or newer for iOS users and 5.19 or newer for Android users.

If a customer's app version is not supported, a message will pop up telling the user to update the app when they tap on the Intercom live chat widget.

Collect emails and other information by setting up a signup form for your newsletter.

how

This is what your newsletter signup will look like in its final form:

While the email template in step 3 is not editable, you can customize yourSignup Page, Success Page, and Confirmation Page. The color ofthese pages is automatically calculated from your shop color.

Creating a newsletter signup form

Log into your Shopgate Admin.

Navigate toMarketing>Newsletter Subscription.

ClickConfiguration.

Here you will see thefields you can configure in your newsletter signup process:

Show (optional or required) or hide a pre-defined field

Add a custom input fieldusing a text box or a drop-down

Customize your Signup Page, Success Page, and Confirmation Pagewith atitle and content

Enter an email address to receive notificationswhen someone signs up for your newsletter

Once you've made your configurations, click Save. For more details, please refer to this table.

That's it! You've created a newsletter signup form for your apps and mobile website.

Displaying your form with a QR code

After you have created a newsletter signup form, don't forget to promote it to your customers! You can do so by displaying a QR code anywhere you want.

ClickOverviewto find a QR code for your main signup form.

To print, click a QR code to reveal the print version or right-click to download.

If you have configured differentstore locations, you'll find aQR code for each of your stores on this page. Display a store-specific QR code in store or on the packagingto see which store gets the most signup!

You can also display your newsletter signup formon your apps and mobile website. Here is.

Using the signupdata

You'll find the number of signups and the subscriber information you have collected via the signup form by clickingSignups.

You can also export your subscriber information by clicking Export as a CSV file.

To use this data, simply upload the CSV file to your email marketing or push notification service.

Frequently Asked Questions

What information can I collect using the signup form?

To get a quick idea of what you can configure and collect in your signup form, read below:

Pre-defined Fields

Title |First name, last name |Date of birth

Street, house number | Zip code,city | Email

Show or hide these fields in your form. If shown, all except email can beoptional or required.

Custom Fields

Text field

When selected, you can enter a title of this field. A text box will be visible to your customers.

Drop-down field

When selected, you can enter a title of this field and define as many entries as you like for your drop-down selections.

Add up to three input fields using text boxes or drop-downs. These fields are optional for your customers.

Custom Texts

Signup page

This page shows the signup form.

Success page

This page shows after a customer signed up for your newsletter.

Ask your customers to check their inboxes and confirm their subscriptions on this page.

Confirmation page

This page appears when the customer has successfully confirmed their email address.

Enter the content of the pages a customer will see throughout the signup process.

Notification

Email address

Enter an email address here to receive a notification when someone signs up for your newsletter.

Shopgate supports WooCommerce - a fully customizable, open source eCommerce platform built for Wordpress. This article will guide you through connecting Shopgate to your WooCommerce shop system.

The following features are immediately available in your mobile shop when you connect WooCommerce to Shopgate:

Support

Import toWooCommerce

Version

3.0.0+

Orders

Customer Account

Export to Shopgate Mobile Shop

Login with Desktop ShopAccount

Products

Login to Desktop Shopwith Mobile Account

Categories

Customer Groups/Tier Pricing

/

Reviews

Show Desktop Orders onMobile

Related Products, Upsell, & Cross-sell

Sync

Validate, upon Cart Changes

Delivery Status "Shipped"

Coupon

Order Status "Canceled"

Shipping Method

Stock Quantity on Product Detail Page

Payment Method

Product Tax Classes, Rates, & Rules

Product Availability

The Shopgate plugin for WooCommerce can be installed for version 3.0 or higher. Support for connecting to an older version of WooCommerce is available in this article.

Install the Shopgate plugin

To connect WooCommerce to Shopgate, you must first install the Shopgate plugin for WooCommerce.

Download the plugin

You can find the latest version of the Shopgate plugin at https://github.com/shopgate/cart-integration-woocommerce/releases. Click on "shopgate-woocommerce-integration.zip" to download the file.

Once you have downloaded the Shopgate plugin file, the next step is to upload it to WooCommerce. This can be done either via the Wordpress backend or via an FTP server - whichever you prefer.

Uploading the plugin via the Wordpress backend

Log in to your Wordpress backend and go to Plugins Add New.

Next, click Upload Plugin and select the .zip file containing the native Shopgate plugin you downloaded in the previous step. Then click Upload.

Once the plugin has been uploaded successfully, you will be prompted to enable it. Do this by clicking Activate Plugin. Where can I find my customer ID?

Uploading the plugin via an FTP server

Uploading the file via FTP is easy. First, you need an FTP tool such as FileZilla. Simply extract the zip file and place it in the Shopgate folder located in[shop root folder] / wp-content / plugins / shopgate-woocommerce-integration.

NOTE: Please make sure you have set a write permission to the [shop root folder] / wp-content / plugins / shopgate-woocommerce-integrationfolder. If it does not yet have a write permission, right-click on the folder and select File Permissions. Set the value to 774 and select Apply to all data and files. Click OK to complete the upload.

The plugin should now appear in the Wordpress backend.

Configure the Shopgate plugin

To get the plugin working, you'll need to enter some info in your Wordpress backend. The next step shows how to find the necessary values in your Shopgate admin area.

Shopgate access info

Log in to your Shopgate admin area.

Click Integration Shop Interface.

Go to the New Connection section. Drop down theSelect a system menu andsearch for "In-house / own implementation". Select this menu item.

A pop-up window will open. If it doesn't, check your browser settings to ensure pop-ups are not being blocked. In the section "1. Configure" you will find yourCustomer number, Shop number,API key and Alias.These are the API credentials you need to enable the Shopgate plugin.

Copy your Customer number, Shop number,API key and Alias- in the next step, you will enter this data in the WordPress backend. Leave the "Connecting to In-house / own implementation" pop-up window open, as you will need to return to it later (see Making the connection ).

Transfer Shopgate access data to the plugin

Go to your Wordpress backend to enter the access date you collected in the previous step.

Log in to your Wordpress backend.

Go to Plugins Installed Plugins and search for WooCommerce. Click on Settings.

On the page that opens, go to the Integration tab. This is where you will enter your API key,Shop number, CustomernumberandShop aliasfrom the Shopgate backend. Please also tick thecheckbox toEnable Shopgate Module. The remaining input fields are optional and can be reconfigured if necessary - the next section will explain these configuration options in further detail.

Finally, click Save changes to save your entries.

Optional configuration options

In addition to the basic configuration with your API access data (API key, customer number, shop number and alias), the WordPress backend also offers you optional settings for configuring your Shopgate plug-in:

Shopgate server

This option should generally be set to "Live". This allows you to choose a predefined URL that communicates with the Shopgate merchant API.

API URL

You can leave this field blank. It is normally only used if the "Shopgate server" flag is set to "custom", which is only useful for debugging purposes.

Custom URL

This refers to your URL, which is used for the mobile version of your shop. The URL to reach your mobile shop is usually[alias].shopgate.comorm.[alias].com.

Products description layout

In this field, you can configure the structure of the product description as desired. The following options are available:

Description

Summary

Description + Summary

Brief Description + Description

You can edit these options at any time. If you make any modifications, please always click on Save changesto apply them.

Establish the connection

It's time to establish the connection between WooCommerce and Shopgate. To do this, enter the URL of your shop in Shopgate:

Go back to the Shopgate admin panel to the pop-up window that you left open. If you have closed the window, navigate to Integration Shop Interface and select "In-house / own implementation" as interface type again.

Enter the URL of your shop in2. Enter URL. Important: Please add /wp-content/plugins/shopgate-woocommerce-integration/api/index.phpto the end of the URL.

Finally, clickConnect.

That's it! The plugin is now connected to Shopgate and a full import will start automatically.

Set up mobile redirect

To redirect mobile visitors to your mobile website,add the following code block to your template.

To do so, follow the steps here:

Locate your template on your FTP server. You should be able to find itin the file "/wp-content/themes/<your_theme_name>/header.php" in your WordPress.

Add the following code block to your template right above the closing <?php wp_head(); ?> tag.

Replace "YOUR SHOP NUMBER" (line 22) with your shop number at Shopgate. Where can I find my shop number?

<?php /* SHOPGATE MOBILE HEADER START */

if (!is_customize_preview() && class_exists('WooCommerce')) {

$shopgateMobileHeader = '';

if (is_product_category()) {

$categoryId = get_queried_object()->term_id;

$shopgateMobileHeader = "_shopgate.redirect = 'category';\n\t\t";

$shopgateMobileHeader .= "_shopgate.category_number = '{$categoryId}';";

} elseif (is_product()) {

$productId = wc_get_product()->id;

$shopgateMobileHeader = "_shopgate.redirect = 'item';\n\t\t";

$shopgateMobileHeader .= "_shopgate.item_number = '{$productId}';";

} elseif (is_front_page()) {

$shopgateMobileHeader = "_shopgate.redirect = 'start';";

} else {

$shopgateMobileHeader = "_shopgate.redirect = 'default';";

}

if (!empty($shopgateMobileHeader)): ?>

<!-- SHOPGATE MOBILE HEADER START -->

<script type="text/javascript">

var _shopgate = {};

_shopgate.shop_number = "YOUR SHOP NUMBER";

<?php echo $shopgateMobileHeader; ?>

_shopgate.is_default_redirect_disabled = true;

_shopgate.host = (("https:" == document.location.protocol) ? "https://static-ssl.shopgate.com" : "http://static.shopgate.com");

document.write(unescape("%3Cscript src='" + _shopgate.host + "/mobile_header/" + _shopgate.shop_number + ".js' type='text/javascript' %3E%3C/script%3E"));

</script>

<!-- SHOPGATE MOBILE HEADER END -->

<?php endif; ?>

<?php } /* SHOPGATE MOBILE HEADER END */ ?>

Frequently Asked Questions

What do the individual configuration options mean?

In the WordPress backend, you will come across various configuration options for configuring your Shopgate plug-in. Here is a brief summary of each option:

API Key

Your API key is generated by Shopgate and is used for authentication between Shopgate and WooCommerce/WordPress. Where can I find my API key?

Shop Number

Your shop number at Shopgate. Where can I find my shop number?

Customer Number

Your customer number at Shopgate.

Shopgate server

This setting allows you to choose a predefined URL that interacts with the Shopgate merchant API.

API URL

This field is only needed for debugging purposes and is therefore only used if the "Shopgate server" flag is set to "custom".

Custom URL to mobile webpage (CNAME) incl. http(s)://

This is your mobile shop's URL. It usually contains your shop alias and consists of the following:[alias].shopgate.comorm.[alias].com

Shop alias

Your Shop Alias is created by Shopgate when you register. This will usually include the name of your shop, but may not.

Products description layout

You can choose the following formats for displaying product descriptions in your mobile shop:

Description

Summary

Description + Summary

Brief Description + Description

Do I have to add "wp-content/plugins/shopgate/api/index.php" to my shop URL?

Yes. With the interface type "Internal / own implementation" it is important that you extend your URL with the path "/wp-content/plugins/shopgate-woocommerce-integration/api/index.php".

With AmeriCommerce, you are able to create your app and mobile website with the following features:

Support

Version

All

Import toAmeriCommerce

Orders

Customer Account

Login with Desktop ShopAccountLogin to Desktop Shopwith Mobile AccountCustomer Groups/Tier PricingShow Desktop Orders On Mobile

/

Export to Shopgate Mobile Shop

Products Categories Reviews

Sync

Delivery Status "Shipped" Order Status "Canceled" Stock Quantity, on Product Detail Page

Validate, upon Cart Changes

Coupon Shipping Method & Price Product Availability

Request SOAP API Service

The first step is to request enablement of theSOAP (Simple Object Access Protocol) API Servicein your AmeriCommerce account. Read more on AmeriCommerce's support site: What is API integration?

To request SOAP API service to your account, follow the simple steps below:

Log in to your AmeriCommerce backend.

Request your SOAP API key at the Developer's API SDK Access page. Note that this is a paid service at AmeriCommerce.

Note down your SOAP API key. You will need to enter this key as your "AmeriCommerce API Key" later.

Create API credentials

In this chapter, you will learn how to create the API credentials required in Build your mobile shop at Shopgate.

Enable API Access to a User Group

After SOAP API service is enabled for your AmeriCommerce account, you will be able to enable API Permissions to a User Group. This can be done by following our simple steps below:

Navigate to Settings Security User Roles/Groups, select a group you want to enable API Access to, and click the Edit icon.

NOTE: If you need to create a User Group for this purpose, click the big orange New button on the top right.

User Group Permissions window will open. If SOAP API service is enabled, you will see "API" listed as an option in the Permissions table. Enable API Access to this User Group by selecting all 4 checkboxes on the rowlabeled "API". Click Save.

Now you have successfully enabled API access to the selected User Group. Continue to create an "API" User - this user account will be used to access the API data.

Create an "API" User

Create a special "API" User Account by navigating to People Users. Click the New button on the top-right.

In the New User window, select a Username and a Password, and note them down in a safe place. These will be your API credentials at Shopgate. You will need to enter them as your "AmeriCommerce API Username" and "AmeriCommerce API Password" later.

In the section labeled "Member of," please select the User Group you have given the API Access to in Enable API Access to a User Group. Fill in the other information as you wish, and click Save.

That's it! Now you have all the information ready to build your mobile shop with Shopgate.

Build your mobile shop

To build your AmeriCommerce mobile shop at Shopgate, simply enter your AmeriCommerce API key and credentials. Follow the steps below to get started:

Log in to your Shopgate Admin and navigate toIntegrationInstall Interface.

In the drop-down labeled "Select a system," start typing "AmeriCommerce" and select it from the search result.

A pop-up will open. Enter your AmeriCommerce store URL. Enter your SOAP API Key as your AmeriCommerce API key. Enter the username and password from your User Account as your AmeriCommerce API Username & Password. Click Connect to establish the interface.

If a connection is made successfully, the pop-up shown below will open. Leave all assignments to ON and click Save.

That's it! Now the Shopgate backend will automatically start to import product data via the newly established interface. Welcome to the mobile world!

Frequently Asked Questions

How do I update my mobile shop?

You do not need to manually update your mobile shop. Whenever there is an update in the Shopgate software, we will update your shop via API method automatically.

Volusion is a shopping cart system at Shopgate.

[email protected]

By setting up a connection in your Volusion shop to Shopgate, you will get these featuresstraight into your app and mobile website:

Supported Version

Import toVolusion

Volusion "Pro" and "Premium" plans

Orders

Sync

Export to Shopgate Mobile Shop

Delivery Status "Shipped"Order Status "Canceled"Stock Quantity on Product Detail Page

ProductsCategoriesReviews

Customer Account

Validate, upon Cart Changes

Login with Desktop ShopAccountLogin to Desktop Shopwith Mobile AccountCustomer Groups/Tier PricingShow Desktop Orders onMobile

/

CouponShipping MethodPayment MethodProduct Availability

Supported Payments

Notes

Authorize.net

Tiered Pricing and Customer Groups are NOT supported at the moment.

In this article, you will find the instructions to set up a connection to Shopgate for your Volusion shop.

Get started

Volusion forces a password reset every few months.When this happens, your mobile shop will not be able to communicate to your Volusion backend via the API unless you update the password in the Shopgate Admin. In other words, your mobile shop will not be updated automatically.

To create a mobile shop from your Volusion backend, an API connection is required.Your orders and product imports/updates will be processed via the secure API method. Follow the steps below to create an API admin user:

Create an API administrator

Log into your Volusion backend and navigate to Customers Administrators.

ClickAdd.

Enter the Basic Customer Info. SetAccess Keyto "Administrator." Choose an email address and a safe password.

Scroll down to Special Privileges and check"Is Super Admin." ClickSave.

Now the page will refresh and an ID will be created for this API admin user. A new API admin user has been added to your Volusion backend.

Edit Access Rules

With this API admin user, your mobile shop can now talk to your Volusion backend. Please edit access rules so your mobile shop can receive updated information such as user accounts, orders, products, and more.

Click the red linkEdit Cust#n Access Rules(n is the ID) under Administrator.

ClickCheck All andSave.

Enable product import & export in XML format

Navigate to Inventory Import/Export.

Click Volusion API. Check both boxes for "Enable the public XML for Featured Products" and "Enable public XML for All Products." Click both Save buttons.

Find your "Product export URL"

Now that you have created an API admin user, you can soon start building your mobile shop! In order to do that, all you need is to find your "Product export URL" to make the connection.

On the page where you left off from the previous step (Inventory Import/Export Volusion API), click Volusion API Integration Helpin Generic.

In the drop-down box next to Export, select Generic Products. Select the email address you used to create the API account. Now click on the second section labeled"URL with Query String and General Information for Importing and Exporting" to review a URL at the bottom.

This is the URL your mobile shop needs to communicate to your shop system. Now continue to the next chapter to enter it in your Shopgate Admin.

Build your mobile shop

Establish a connection to Shopgate

To establish a connection between your Volusion backend and your mobile shop, enter the URL for importing and exporting your products. Follow the steps below:

Log in to your Shopgate Admin and navigate toIntegrationInstall Interface.

In the drop-down labeled Select a system, start typing "Volusion" and select it when it appears.

A pop-up will open. Paste the URL you found in Chapter 1.4 in the text field. Click Connect to establish the interface.

If a connection is made successfully, the pop-up shown below will open. Here you will be able to assign jobs to your first connection. We recommend leaving all assignments to ON at this time. Click Save.

Now you should see the progress bar running, and the Shopgate backend automatically filling your mobile shop with your products.

Depending on how many products you have, the import process can take anywhere from a few minutes to a few hours. You can always check the status of the imports. If no status bar is shown, it means either the import is finished, or no import is running at the moment.

Welcome to the mobile world!

Activate your mobile website

To redirect mobile visitors to your mobile website, a few lines of code need to be modified in your main template file. Follow the steps below to do so.

In your Volusion backend navigate to Designs File Editor. On the right, click your main template file. Its usually the first one under Shortcuts Template Files.

Copy the JavaScript code and paste them into the marked position of your template file (right below the opening <head> tag):

<!-- SHOPGATE MOBILE HEADER START --><script type="text/javascript"> var _shopgate = new Object(); _shopgate.shop_number = "YOUR_SHOP_NUMBER"; var shopgateRegHome = /^https?:\/\/[^\/]+(?:\/?(?:default\.aspx?)?)?(\/?\?.+)?$/i var shopgateRegCategory = /(-|_)s\/([0-9]+)\.htm(\??.*)$/ var shopgateRegProduct = /(-|_)p\/([-a-z0-9]+)\.htm(\??.*)$/ if (/\sg_debug=1$/.exec(document.URL) != null) { window.navigator = new Object({"userAgent":"RedirectBot"}); } if (shopgateRegProduct.exec(document.URL) != null) { _shopgate.redirect = "item"; _shopgate.item_number_public = RegExp.$2.toUpperCase(); } else if ((shopgateRegCategory.exec(document.URL) != null)) { _shopgate.redirect = "category"; _shopgate.category_number = RegExp.$2; } else if (shopgateRegHome.exec(document.URL) != null) { _shopgate.redirect = "start"; } else { _shopgate.redirect = "default"; } _shopgate.is_default_redirect_disabled = true; _shopgate.host = (("https:" == document.location.protocol) ? "https://static-ssl.shopgate.com" : "http://static.shopgate.com"); document.write(unescape("%3Cscript src='" + _shopgate.host + "/mobile_header/" + _shopgate.shop_number + ".js' type='text/javascript' %3E%3C/script%3E"));</script><!-- SHOPGATE MOBILE HEADER END -->

Replace YOUR_SHOP_NUMBER (line 4) with your shop number at Shopgate. Then click Save. Where can I find my shop number?

Now you have activated your mobile website.

Map payment methods

To show your Shopgate mobile orders correctly in your shop's backend, please create two payment methods in your shop's backend, and then map them to Shopgate payment methods in your Shopgate Merchant Area.

Create two payment methods

In your Volusion backend, navigate to Settings Payment.

Go to tabMore Payment Types. Enter "Shopgate" into the field Custom Typeand click ADD. Then, repeat the step by entering "Mobile Payment" into the field and click ADD.

Uncheck the boxes in front of the two newly created payment types. Click Save.

Find the IDs for both payment methods

On the top right, clickView List.

Write down the ID values in front of the two payment methods you just created.

Enter the IDs at Shopgate

Now enter the IDs in the settings dialog in your Shopgate Admin (Integration Install Interface Actions Edit). Click Save.

Understand the settings

At your Shopgate Admin, you can enter or update your VolusionAPI credentials and configure a few export settings.To do so, follow these steps:

Log into your Shopgate Admin and navigate to Integration Install Interface.

On your connection to Volusion, click Actions, then Edit.

Configure your connection on the settings page shown below. Detailed explanations for options listed can be found below.

Import mobile orders to desktop shop after

Orders can be transmitted right after they were placed or after they were paid. Since Volusion does not update orders, we highly recommended importing them after shipping has been approved.

Debug

This enables advanced debugging for your connection and is usually used by our developers only if there is a problem.

Advanced error logging

This will break all operations over your connection even on minor errors, making it easier for our developers to find the source of a problem (if you have one).

Export product custom fields as properties

When this is ON, the custom fields associated with a product in Volusion will be exported as product properties in Shopgate.Note that the custom labels that can be created for product custom fields in Volusion will NOT be imported into your app and mobile website. Properties created from product custom fields will display the generic labels CustomField1, CustomField2, CustomField3, CustomField4, and CustomField5. To change the labels, contact your Shopgate Support at [email protected].

Export products with the price of $0

When enabled, free products (price is $0) will be exported to your mobile shop.

URL to your shop

The plain URL to your shop. This is usually automatically generated when connecting and doesnt need to be changed.

The API login email address

The email address of the account you created for API access. This is usually automatically generated when connecting and doesnt need to be changed.

The encrypted API login password

The encrypted API password from the link you get from your Volusion help. This is usually automatically generated when connecting and doesnt need to be changed.

Export product from Volusion using

Choose which field to export as your products names from the Volusion API.

Discount level for products at Shopgate

Choose which discount level in your Volusion store should be used to export pricing.

Weight unit for products

Configure the weight unit youre using in your Volusion store.

ID of the payment method "Shopgate" in your Volusion store

The ID of the payment method thats assigned to incoming orders paid via payment methods managed by Shopgate.

ID of the payment method "Mobile Payment" in your Volusion store

The ID of the payment method thats assigned to incoming orders paid via payment methods managed by you.

Frequently Asked Questions

Why do products with children sometimes show as inactive in my mobile shop?

Due to a limitation in the Volusion API, a child product can be mapped to its parent product only if the name matches that of the parent. If you experience this problem, please edit the product names in Volusion accordingly.

For example, the part before " - <Color> - <Size>" must be exactly the same for parent and child products:

Wrong:

Parent: A nice sundressChildren: A pretty sundress - <Color> - <Size>

Correct:

Parent: A nice sundressChildren: A nice sundress - <Color> - <Size>

Do I need to update my mobile shop in the future?

You do not need to manually update your mobile shop. Whenever there is an update in the Shopgate software, we will update your shop via API method automatically.

I am receiving emails about orders not getting imported into my Volusion store. What should I do?

If you have set up your mobile shop following this document but the orders are not imported into your Volusion store, please try the following steps:

In your Volusion system navigate to Inventory Import / Export Volusion API and click the Runbutton on "Generic\Orders."

On the next screen, click the orange Run button.

If you still receive emails about orders not getting imported after these steps, please contact your support teamat .

Find out howto create an app and mobile website fromyour WooCommerce desktop shop.

With WooCommerce and Shopgate, you are able to create your app and mobile website with the following features:

Support

Import toWooCommerce

Version

2.4, 2.5

Orders

Customer Account

Export to Shopgate Mobile Shop

Login with Desktop ShopAccountLogin to Desktop Shopwith Mobile AccountCustomer Groups/Tier PricingShow Desktop Orders onMobile

/

ProductsCategoriesReviews

Sync

Validate, upon Cart Changes

Delivery Status "Shipped"Order Status "Canceled"Stock Quantity on Product Detail Page

CouponShipping MethodPayment MethodProduct Availability

Supported Payments

Notes

Shopgate

The payment validation feature allows you to offer specific payment options to targeted carts and customers.

Support for connecting to a newer version of WooCommerce (3.0.0+) is available in this article.

Get started

Collect information

To get started,please collect the following information:

Consumer Key

Consumer Secret

Your Consumer Key and Consumer Secret are API elements used by WooCommerce to control access to your shop backend.

Category Route

The category route is part of the URL of your web shop. You can find it between "wordpress/" and acategory name.

To find out your category route, go to your webshop and click on any category. You will see the Category Route like this:

Default Product Tax

Depending on your WooCommerce version, your default product tax can be "Standard" or "Default." Ask your WooCommerce support if you are not sure about this.

Generate API keys

To generate your WooCommerce Consumer Key and Consumer Secret, follow the steps here:

Go toWooCommerce Settings API Keys/Appsand select Add Key.

Select aUser and add a Description. ChooseRead/Write access Permissions. ClickGenerate API Key. WooCommerce will generate API keys for that user.

Now your keys have been generated. You should see your Consumer key and Consumer Secret(shown below). Enter these two keys in your Shopgate Admin as described in the next step.

Build your mobile shop

Establishing a connection to Shopgate

To establish aconnection between your WooCommerce backend and your mobile shop, follow the steps here:

Log in to your Shopgate Admin and navigate to Integration Install Interface.

In the drop-down labeled Select a system, start typing"WooCommerce" and select it from the list when it appears.

A lightbox willopen. Enter all the information shown below. The Shopgate technology will authenticate your credentials immediately.

If a connection is made successfully, a lightboxshown below will open. Leave all assignments to ONto access all the functions in your Shopgate mobile shop. Click Save.

That's it! Now the Shopgate backend will automatically start to import product data via the newly established interface. Welcome to the mobile world!

Set up mobile redirect

To redirect mobile visitors to your mobile website,add the following code block to your template.

To do so, follow the steps here:

Locate your template on your FTP server. You should be able to find itin the file "/wp-content/themes/<your_theme_name>/header.php" in your WordPress.

Add the following code block to your template right above the closing <?php wp_head(); ?> tag.

Replace "YOUR SHOP NUMBER" (line 22) with your shop number at Shopgate. Where can I find my shop number?

<?php /* SHOPGATE MOBILE HEADER START */

if (!is_customize_preview() && class_exists('WooCommerce')) {

$shopgateMobileHeader = '';

if (is_product_category()) {

$categoryId = get_queried_object()->term_id;

$shopgateMobileHeader = "_shopgate.redirect = 'category';\n\t\t";

$shopgateMobileHeader .= "_shopgate.category_number = '{$categoryId}';";

} elseif (is_product()) {

$productId = wc_get_product()->id;

$shopgateMobileHeader = "_shopgate.redirect = 'item';\n\t\t";

$shopgateMobileHeader .= "_shopgate.item_number = '{$productId}';";

} elseif (is_front_page()) {

$shopgateMobileHeader = "_shopgate.redirect = 'start';";

} else {

$shopgateMobileHeader = "_shopgate.redirect = 'default';";

}

if (!empty($shopgateMobileHeader)): ?>

<!-- SHOPGATE MOBILE HEADER START -->

<script type="text/javascript">

var _shopgate = {};

_shopgate.shop_number = "YOUR SHOP NUMBER";

<?php echo $shopgateMobileHeader; ?>

_shopgate.is_default_redirect_disabled = true;

_shopgate.host = (("https:" == document.location.protocol) ? "https://static-ssl.shopgate.com" : "http://static.shopgate.com");

document.write(unescape("%3Cscript src='" + _shopgate.host + "/mobile_header/" + _shopgate.shop_number + ".js' type='text/javascript' %3E%3C/script%3E"));

</script>

<!-- SHOPGATE MOBILE HEADER END -->

<?php endif; ?>

<?php } /* SHOPGATE MOBILE HEADER END */ ?>

Frequently Asked Questions

Where can I update API keys and other configurations?

If you have updated your WooCommerce API keys or other configurations, you need to update the same info for your mobile shop. To do so, log into your Shopgate Admin website and click the Actions drop-down and select Edit.

Configure your connection on the settings page below. Detailed explanations for options listed can be found below.

Debug

This enables advanced debugging for identifying issues in your connection. Use only when you know what you're doing.

Advanced error logging

This will break ALL operations over your connection even on minor errors. Useonlywhen you know what you're doing.

Consumer Key

Consumer Secret

Category Route

Product Tax Class

Here you can update your WooCommerce API Keys and other info.

Enable base price export

When turned ON, we will export base price for your products.

Do I need to update my mobile shop in the future?

You do not need to manually update your mobile shop. Whenever there is an update in the Shopgate software, we will update your shop via the API method automatically.