Setting Up a Miva Merchant Shopping Cart

This document explains how to set up your Miva Merchant shopping cart to integrate with the Stone Edge Order Manager. Miva Merchant users must install an export module (integration script) in their store site. The module enables the secure transfer of order data from your shopping cart to the Order Manager via an internet connection. It also facilitates downloading your customers and products from your shopping cart upon setting up the Order Manager for the first time.

 

Important! If you do not have a secure URL to access your Miva Merchant shopping cart, buy a secure certificate from your site hosting company and install it before completing the following steps.

 

There are three overall steps to set up a Miva Merchant shopping cart with the Order Manager: 1) download the Miva Export Module from the Stone Edge Download Gateway, 2) add the Miva Export Module to your Miva Merchant shopping cart, and 3) configure the Order Manager to integrate with your Miva Merchant shopping cart.

Download the Miva Merchant Export Module

  1. Determine the Miva Merchant version that you are using.

  2. Go to the Stone Edge Software Download Gateway page (www.stoneedge.net/dlgateway). Refer to the email you received from Stone Edge Technologies when you purchased the Order Manager for the required username and password.

  3. Go to the category Other Downloads, locate the Miva Export Module for your store version (Miva 5.x or Miva 4.x), and click on the corresponding Download button.

  4. In the File Download window, click Save.

  5. Choose to save the file your Desktop or other location where you can easily find the module. When the download is complete, click Open.

  6. Click Extract all files and go through the Extraction Wizard.

  7. A new window will open showing the unzipped file (folder). Make note of the Miva Export Module location because you will browse to it in the next section.

Add the Module to Your Miva Merchant shopping cart

  1. Log into your Miva Administration page.

  2. In the left menu, expand Global Settings.

  3. Next to Modules, click Add.

  4. Click on the Upload button to the right of the Module text field.

  5. Click Browse and navigate to the extracted Miva Export Module on your computer.

  6. Select the Export Module file (omxmlexp.mvc or omxmlexp.mv) and click Open.

  7. In the Miva Upload File window:

    1. If you are installing the export module for the first time, click Upload.

    2. If you are upgrading the export module, click the Overwrite checkbox, and then click Upload.

Setting Up the Shopping Cart in the Order Manager

  1. Open the Shopping Carts dialog box:

    1. Quick Clicks> Create/Edit Shopping Cart

    2. Quick Clicks> Setup Wizard> Shopping Carts tab> Create/Edit Shopping Cart

    3. Main Menu> Maintenance Menu> Cart Functions> Create/Edit Shopping Carts

    4. Main Menu> Maintenance Menu> Setup Functions tab> Store Setup Wizard> Shopping Carts tab> Create/Edit Shopping Cart button

  2. The Shopping Carts dialog box opens:

 

  1. Click Add Cart.

  2. Enter the store name in the Store Name field. Note: If you are licensed to use multiple shopping cart types, you should enter a unique store name for each one to help you distinguish between them.

  3. Select "Miva Merchant" from the Cart Type drop down list. Note: If you are licensed to use only one shopping cart type, you will not see a drop down list in the Cart Type field.

  4. In the Cart ID/User Name field, enter your Miva Merchant Administrator user name.

  5. In the Cart Password field, enter the Miva Merchant Administrator password. If you leave this field blank, you will be prompted to enter your password each time you download orders.

  6. In the Reenter Password field, re-enter your password.

  7. In the Store Code field, enter the code for the store. Note: Find the store code in Miva Merchant by going to the Advanced Administration screen, Clicking Stores, selecting the store, and clicking the Identification link on the right.

  8. In the Script URL field, enter the Secure URL, which you copied from the Site Configuration tab of your Miva Administration. Your URL will likely be one of the following URLs. Choose the URL that corresponds to the Miva Merchant version you are using. Replace "www.mystore.com" with your web store address.

MM4 URL: www.mystore.com/Merchant2/4.24/modules/export/omxmlexp.mvc

MM5 URL: www.mystore.com/mm5/5.00/modules/export/omxmlexp.mvc

    1. To verify your script URL (optional), follow these steps:

      1. Log into your Miva Administration page.

      2. In the left menu, expand Global Settings and click Domain Settings.

      3. Click on Site Configuration button.

      4. Select and copy the URL shown in the Secure URL to Miva Merchant field, OMITTING the following: merchant.mv or merchant.mvc found at the very end of the URL.

      5. Paste the URL into the Script URL field on the Shopping Carts tab of the Order Manager, ADDING the Miva Merchant Version Number (If you do not know the version number, look for it on the Miva Merchant Administration web page.)

      6. After the version number, add /modules/export/omxmlexp.mv (uncompiled) OR /modules/export/omxmlexp.mvc (compiled).

Note: If the Secure URL to Miva Merchant field is blank, your site may not be setup with a SSL certificate. You cannot setup your shopping cart without one. Contact your site hosting company to purchase a certificate and then install it.

  1. Click Save.

  2. Click the Test button. You should see a message indicating the test passed and the version of the Export Module installed.

 

See Also

Miva Payment Encryption

Inventory Synchronization

Importing Orders from Miva Merchant

Importing from Multiple Shopping Carts into the Same Order Manager Store

 

Updated 8/26/08

Modified 10/30/09