Shopping Cart Systems

Connect with your mobile customers using Shopgate.

3dCart

3dCart is available as a shopping cart system at Shopgate.

By setting up a connection in your 3dCart shop to Shopgate, you will get these features straight into your mobile shop and apps:

Supported Version Import to 3dCart
All 3dCart versions   Orders
Sync Export to Shopgate Mobile Shop
Delivery Status "Shipped"
Order Status "Canceled"
Stock Quantity on Product Detail Page


Products
Categories
Reviews



Customer Account Validate, upon Cart Changes
Login with Desktop Shop Account
Login to Desktop Shop with Mobile Account
Customer Groups/Tier Pricing
Show Desktop Orders on Mobile


✘ / ✘
Coupon
Shipping Method
Payment Method
Product Availability



Supported Payments Notes
N/A

Grouped products are now supported!

Some types of products cannot be exported to your mobile shop. Read more here.


In this article, you will find everything you need to set up a connection to Shopgate for your 3dCart shop.

 

Get started

Collect information

To get started, please collect the following information:

Your 3dCart store url

This is your store URL. An example: https://myawesomeshop.3dcartstores.com

Your 3dCart API Key

Your 3dCart API Key is an API element used by 3dCart to control access to your shop backend. When configured at Shopgate, your mobile shop will be able to handle orders, products, reviews, and more.

To find this key, log in to your 3dCart backend. Navigate to Modules and search for the SOAP API module. If enabled, an API Key will appear underneath.

If you don't see an API Key here, follow the instructions to generate one


Generate an API key

To generate an API key, follow the steps here:

  1. In your 3dCart backend, navigate to Modules and search for the SOAP API module. Click Change Settings.



  2. The API Settings page will open. Check mark Enable API and Enable Advanced API. Click Save. Now a key will be generated.

 

Build your mobile shop

Establish a connection to Shopgate

To establish a connection between your 3dCart backend and your mobile shop, you need to use the URL for importing and exporting your products. Enter it into your Shopgate Admin. Follow the steps below to make the connection:

  1. Log in to your Shopgate Admin and navigate to Integration → Install Interface
  2. In the drop-down labeled Select a system, type 3dCart and select it.
  3. A pop-up will open. Enter Your 3dCart store URL and Your 3dCart API key. Click Connect to establish the interface.



  4. If a connection is made successfully, a popup shown below will open. Leave all assignments to ON to access all the available features. 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.

Congratulations and welcome to the mobile world!

 

Activate mobile website

To redirect mobile visitors to your mobile website, a few lines of codes need to be modified in your template file. Follow the steps below to do so.

  1. Navigate to Settings → Design → Themes & Styles and click Edit Template (HTML).



  2. The Template Editor will open. Select your template folder by clicking the drop-down Go to folder on the top right. Then click on the file frame.html to edit.
    Your template folder could be named differently from the example shown below. This template should contain a frame.html file.



  3. Copy these JavaScript codes and paste them into the marked position of your template file. Replace YOUR_SHOPGATE_SHOP_NUMBER (line 8) with your shop number at Shopgate and click SaveWhere can I find my shop number?
    <!-- SHOPGATE MOBILE HEADER START -->
    <script type="text/javascript">
    var _shopgate = new Object();

    var shopgatePrdID = '[catalogid]';
    var shopgateCatID = '[catid]';

    _shopgate.shop_number = "YOUR_SHOPGATE_SHOP_NUMBER";
    if (!isNaN(parseInt(shopgatePrdID))) {
    _shopgate.redirect = "item";
    _shopgate.item_number = shopgatePrdID;
    } else if (!isNaN(parseInt(shopgateCatID))) {
    _shopgate.redirect = "category";
    _shopgate.category_number = shopgateCatID;
    } else {
    _shopgate.redirect = "start";
    }

    _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 -->

That's it! Now everyone who visits your website on a mobile device will be directed to your mobile website.

 

Map payment methods

A new payment mapping feature is available for your 3dCart mobile shop! With this new feature, your Shopgate orders are no longer showing as "Payment Method 0" in the Orders view of your shop's backend.

In order to use this feature, please create two offline payment methods in your shop's backend, and then map them to Shopgate payment methods in your Shopgate Merchant Area.

Create 2 Offline Payment Methods

  1. Log in to your 3dCart Online Store Manager backend. Navigate to Settings → Payment and click the button Select Payment Methods.



  2. On the Payments page, click the button +Add New on the top right.



  3. On top of the page, a new section called "Add New Payment Type" will appear. Change the Payment Method to Offline Payments: Custom and click + Add.



  4. Now you will find a new entry Custom under the section labeled Offline Payment Methods. Click Settings to modify it.



  5. Enter Shopgate as the Name, check mark Hidden, then click Add. (You're hiding the payment so it will not show up at checkout.)



  6. A new row will appear. This time, enter Mobile Payment as the name, check-mark Hidden, then click Add.



  7. Now you have successfully created two offline payment methods called Shopgate and Mobile payment. Continue to find out their payment ID.

Find the payment ID

Now you need to find out the ID of both payment methods to map the payments later. To do so, scroll down on the Offline Payment Methods page and follow the steps:

  1. Find the payment method Shopgate.
  2. Right-click on the row Shopgate and select Inspect.
  3. Look for "id" or "name". Use the numeric value as the ID for the payment method "Shopgate."

Repeat the steps to find out the payment ID for the payment method "Mobile payment."

IMPORTANT: In the example below, the attribute has an id of "divPayment47_ofl". The ID you are looking for is 47, not "divPayment47_ofl". An incorrect ID may cause your orders to fail to transfer to 3dCart.



If the "Inspect Element" function is not available for you, right click on any white space of the page, and select View Page Source. You should be able to find the same code shown in this screenshot.

Enter the ID at Shopgate

  1. Log in to your Shopgate Admin page and navigate to Integration → Install Interface.
  2. Find your shop's connection and click Actions → Edit in the upper right corner.



  3. The configuration window will pop-up. Enter the payment ID's in the corresponding fields, and click Save.
    • 3dCart Mobile Payment Id = payment methods that are processed by you
    • 3dCart Shopgate Payment Id = payment methods that are processed by Shopgate

Now your payment methods have been successfully mapped.

If you have finished all tasks described above, you have successfully set up everything you need for your 3dCart mobile shop with Shopgate. Now simply sit back and watch your business grow!

 

Frequently Asked Questions

Where can I update API keys and other 3dCart configurations at Shopgate?

If you have updated your 3dCart API keys or other configurations, you need to update the same info for your mobile shop.

To do so, log into your Shopgate Admin and navigate to Integration → Install Interface. On your connection to 3dCart, click Actions, then Edit.

Configure your connection on the Settings page. Detailed explanations for options listed can be found below.



When should the order be transmitted? Orders can be transmitted right after they were placed or after they were paid. It's recommended to select Directly after placing the order for 3dCart.
Debug Used by Shopgate developers only, for advanced debugging purposes. Contact Shopgate support if you have experienced issues with your mobile shop.
Advanced error logging Used by Shopgate developers only. Enabling this option will stop all import and export activities when an error occurs. Contact Shopgate support if you have experienced issues with your mobile shop.
Prepend "SG" to orders that get imported from Shopgate into your 3dCart store When enabled, your mobile orders will show "SG" in front of the order number.
Your 3dCart store URL

The URL to your 3dCart shop. This is usually automatically generated by 3dCart. Update your store URL here if it has been changed.

Your 3dCart API key

The API key to your 3dCart shop. This is generated by 3dCart.

3dCart Mobile Payment ID If you are using the payment mapping feature explained in Chapter 3, enter the ID value of the Mobile Payment method. The payment methods mapped here are those processed by you. For more information, follow the instructions in Chapter 3.2.
3dCart Shopgate Payment ID If you are using the payment mapping feature explained in Chapter 3, enter the ID value of the Shopgate Payment method. The payment methods mapped here are those processed by Shopgate. For more information, follow the instructions in Chapter 3.2.

 

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.

Why are some products missing in my apps and the mobile website?

Certain types of products cannot be exported from your 3dCart system to your apps/mobile website. These are:

  • Products which contain an option with the type File or OneTimeFee.
  • In the "Option set" section: if the "Custom Item" option is used to put a different product to the cart.

See the example below:

 

Was this article helpful?
Can't find what you're looking for?
Let us help you—submit a support ticket.
Contact Support