Support Center

Connecting to 3dCart

Follow

 

 

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 wonderful 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!

NOTE: 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.

 

Topics covered in this article:

  1. Getting started
  2. Building your mobile shop
  3. Mapping payment methods
  4. Frequently Asked Questions (FAQ)

 

 

1. Getting started

1.1 Collecting information

To get started, please collect the following information:

Account Info Description
Your 3dCart store url

This is your store URL.

An example could be 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

 

1.2 Generating 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 on the "Change Settings" link.
  2. The API Settings page will open. Check mark Enable API and Enable Advanced API. Click Save. Now a key will be generated.

 

2. Building your mobile shop

2.1 Establishing a connection to Shopgate

To establish a connection between your 3dCart backend and your mobile shop, the URL for importing and exporting your products needs to be entered in your Shopgate page. Follow the steps below to make the connection:

  1. Log in to your Shopgate Admin page.
  2. Click on Integration from the menu bar, then select Install Interface.
  3. In the drop-down labeled Select a system, type 3dCart and select it.
  4. A popup opens. Enter Your 3dCart store URL and Your 3dCart API key. Click connect to establish the interface.
  5. 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.
  6. Congratulations! 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 :)

 

2.2 Activating your 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 on the button Edit Template (HTML).
  2. Now 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?

  4. <!-- 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 visited your website on a mobile device will be directed to your mobile website.

 

3. Mapping 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 2 offline payment methods in your shop's backend, and then map them to Shopgate payment methods in your Shopgate Merchant Area.

3.1 Creating 2 Offline Payment Methods

First of all, please create 2 offline payment methods as instructed below.

  1. Log in to you 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 section 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 2 offline payment methods called Shopgate and Mobile payment. Continue to find out their payment ID's.

 

3.2 Finding the payment ID's

Now you need to find out the ID's 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". In the screenshot, the value is 47. This is your ID for the payment method "Shopgate".

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

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.

 

3.3 Entering the ID's 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

  4. 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!

 

4. Frequently Asked Questions (FAQ)

4.1 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 page, and navigate to Integration > Install Interface. On your connection to 3dCart, click on Actions, then Edit.

Configure your connection in 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 an "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.

 

4.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.

 

4.3 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 "Custom Item" option is used to put a different product to the cart.

See example below.

 

Comments