24/7 Support: 800.608.6482

Get Started

Reference Guide

Identification Section


Miva Merchant has three types of admin users: Administrators, Managers, and ordinary admin users. Please note that these users exist in the admin interface and are not related to customer accounts in your on-line store.

  • Administrators have access to all admin features in all stores.
  • Managers have access to all admin features in the store where they are the manager.
  • "Ordinary" users have privileges that you can limit by creating a Group and then assigning the user to that group.
Store Code The store code uniquely identifies a store in the database. It will also show up in the URL bar as a parameter when customers visit your online store (&Store_Code=).
Store Name The store name appears in the Miva Merchant administration interface to indicate which store you are currently editing. If you have more than one store, your customers can also see the store name in the store selection screen.

To Assign a Manager to the New Store

You can only assign an existing user to be a manager. If you have already created a user that you want to assign as the manager, you can enter the user name in the Manager field, or you can click the Look Up button. Note that if you assign an administrator as the store manager, that person will still have access to all of your stores.


If you haven't already created your manager account, and you only want this person to have admin rights in one store:

  1. Go to Menu> Users > Users tab.
  2. Create a new user. Make sure that you do not check the "Administrator" checkbox in the Add User screen.
  3. Packaging Rules

    Store User

  4. Go back to Menu> Store Settings > Store Details > Identification section and enter the user name that you just created.


This tab contains contact information that Miva Merchant uses for the store manager, as default shipping information, and as registration information for certain payment options. Some of the fields in this tab are turned into tokens that are used throughout the admin interface. The fields in this tab are prepopulated with whatever was entered when the initial store setup is done.


Weight Unit Display Suffix: Enter the label to use throughout the store where weight is displayed. The default is pounds. This is only a label for the convenience of your customers. You can use any term you like such as ounces, kilos, or tons. You could also describe your products in some non-weight units such as cartons, bags, or pallets.
Weight Units: Enter the type of weight units that you would like to use in your store for calculation and for submission to shipping carriers. You can only use one unit of measurement throughout the store. All your product weights will be measured by the same term.
Dimension Units: Enter the type of dimension units that you would like to use in your store for calculation and for submission to shipping carriers. You can only use one unit of measurement throughout the store. All your product dimensions will be measured by the same term.
Basket Timeout (Minutes):

Defines the time a shopper's basket can be left without any action (store browsing, additions, removals, changes of quantity) before it expires. The default is 60 minutes. In builds before PR8 update 4, the max Basket Timeout was 1440 minutes (24 hours). In builds after PR8 update 4, there is no limit on the length of the timeout.

Just like in a brick–and–mortar store, items that are in shopping baskets are removed from your inventory. Sometimes customers may leave their baskets without checking out. If enough products accumulate in abandoned baskets, it can appear that your store has run out of them. When the basket expires, you can return the items to inventory by deleting the basket (see To Delete Expired Shopping Baskets).

To determine the right time limit for your store, consider the impact on your inventory levels of having items left in abandoned baskets and the potential for your customers to be interrupted (by a phone call, for instance). You want to avoid appearing to be out of items that are simply tied up in forgotten baskets and avoid frustrating shoppers by deleting their baskets while they are still browsing in your store.

Expired baskets should be deleted regularly. Note that order numbers are never reused, even from expired baskets.

Legacy Price Group Overlap Resolution: When you offer special discounts to certain groups of customers using Price Groups, and a customer belongs to more than one Price Group, there can be a conflict between prices. Specify whether you want the customer to be offered the highest of the two prices or the lowest.
Store User Interface: Static field that shows which css user interface you are using. In most cases, this will be CSSUI.
Sales Tax Calculation:

Specify the sales tax method to use in the store

Please use this feature with caution. Typically, you will make a selection when initially setting up your store and then never change it. If you select a different way of calculating sales taxes later, any changes you have made, including customized tax rates, or tax settings that vary by product, will be lost.

The standard options are:

Canadian VAT

The Canadian Value Added Tax module enables you to configure the Canadian VAT module to calculate Goods and Services Tax (GST) and Harmonized Sales Tax (HST) on shipments from a Canadian store to a Canadian Customer.

Note: the Canadian VAT module does not calculate Provincial Sales Tax (PST).

European VAT

The European Value Added Tax module lets you specify the ship-to countries where VAT should be charged, to specify one or more VAT rates, and to assign rates to each product in your store.

Shopper Selected Sales Tax

The Shopper Selected Sales Tax module lets you configure sales tax options that shoppers can select from a drop-down list during the checkout process.

Maintenance Mode

Take your store off-line to perform maintenance.

To Take Your Store Offline

  1. Click the Offline At radio button and enter a time when you want your store to go off-line. If a customer has some items in their basket when your store goes off-line:
    • If the customer has submitted payment for the order before your store goes off-line, the order will be processed.
    • If the customer has not submitted payment for the order before your store goes off-line, the order will be cancelled and the customer's basket will be emptied.
  2. Enter a time value in the "No New Customers" text box. For example, if you enter 30 minutes in this text box, a "trigger" will go off 30 minutes before your store goes offline.
    • Customers who had a session cookie before the trigger went off can still browse your store, add products to their baskets and complete their orders.
    • Customers who visit your store after this trigger goes off cannot browse your store or add products to their basket until your store goes back online.
  3. If your store uses PR8 Update 4 or later, you can enter one or more IP addresses in the "Allowed IP address(es)" field. Normally, once your store goes off-line, no one, including administrators, can browse the store. If you enter your IP address in this field, when the store goes off-line you will still be able to browse and access your on-line store for testing purposes.
  4. Separate multiple IP addresses with commas. You can also use "/XX" to enter a range of IP addresses using CIDR notation. See http://en.wikipedia.org/wiki/CIDR_notation.

  5. Enter some text in the Warning Message text box. The Warning Message will be displayed at the top of your store pages as soon as you click the Update button in the Store Details tab, and continues to be displayed until your store goes off-line. For this reason, you may not want to set the "Offline At" time to more than one hour in advance. For example, if it's currently 11:00 pm, and you set the "Offline At" time to midnight tonight, the warning message will be displayed in your store from 11:00 pm to Midnight.
  6. Store Warning

    The store warning message.
  7. Enter some text in the Maintenance Message text box. When your store goes offline, the Warning Message is removed and the Maintenance Message is displayed. This message is displayed (and your store remains off-line) until you manually go back to the Maintenance Mode screen and click the Store Online radio button and then click Update.
  8. Store Closed

    " alt="Store Warning">

    The store maintenance message.

  9. The Available Tokens show the list of tokens that you can add to your Warning Message or Maintenance Message.
  10. Click the Update button to apply your changes.

To Bring Your Store Back Online

  1. Go to Menu > Store Settings > Store Details tab > Maintenance Mode section.
  2. In the Maintenance Mode section, click the Store Online radio button, then click Update.

Order Minimums

It is sometimes not worthwhile to sell small quantities or items, or to process low-value orders. You can set a minimum on orders in your store. If a shopper attempts to check out when their order has not met the minimum, they will see a message that you've created.

You might want to mention your policy in your store, especially if the minimums are relatively high, so shoppers can plan their purchases accordingly, rather than being surprised when they are ready to checkout.

Specifying Required Minimums

Specify the Minimum Quantity and/or Minimum Price that will be accepted as an order. You can use only one, either one, or both.

Minimum Quantity Only

If you specify only a Minimum Quantity of 3 items, then any order with 3 or more items will be accepted.

Minimum Price Only

If you specify only a Minimum Price of $5.00, then any order where the items total $5.00 or more, before shipping and tax, will be accepted.

Minimum Quantity or Price

If you specify a Minimum Quantity of 3 items, and a Minimum Price of $5.00, but do not select Must Meet Both Minimums, then any order with 3 or more items, or where the items total $5.00 or more, before shipping and tax, will be accepted.

Minimum Quantity and Price

If you specify:

  • A Minimum Quantity of 3 items
  • A Minimum Price of $5,00
  • Must Meet Both Minimums

then any order having 3 or more items, where the items total $5,00 or more, before shipping and tax, will be accepted. If the order total was $100,00, but only included 2 items, it would not be accepted.

Minimum Not Met Message

Enter a message here, either in plain text, or with HTML formatting, that explains your store policy on order minimums, and advises the shopper on how to proceed. They will see the message when they click Checkout. You may want to reassure them that they can return to shopping, and can continue to add items to their existing basket.

State Tax Options

Use this tab to automatically add sales tax to orders based on the customer's state. Please note that, by default, Miva Merchant can only apply a sales tax rate to an entire state. If you need to apply sales tax in a more sophisticated way, you can purchase a third party module.

To Add State Sales Tax to Orders

  1. In the Tax Based On drop down list, you can choose to apply the sales tax for the customer's shipping state or the customer's billing state. In many cases, the customer's shipping and billing state will be the same.
  2. Click the Add Rate button.
  3. In the State drop down list, select a state, such as California.
  4. Enter the sales tax you want to charge for that state.
  5. Check the Tax Shipping checkbox if you want sales tax to be calculated based on (Order Total + Shipping Costs). If you only want to apply sales tax to the order total, leave the Tax Shipping checkbox unchecked.
  6. Click the Update button.

When a customer places an order from California, the sales tax you created for that state will automatically be applied to the order and will appear in the Payment Information screen and on the invoice.

Looking for Developer Docs?

We have a whole section for that, including: Developer Training Series, Template Language docs, Module Development tutorials and much, much more.

Head to the Developer Section

Miva believes that all online businesses should have access to a scalable ecommerce platform that can meet their unique business requirements. Miva offers PCI compliant ecommerce, hosting, and custom website design and development solutions. Miva customers have processed over $100 billion in online sales since 1997.

Copyright © 2016 Miva, Inc - All Rights Reserved   Privacy Policy | Store Policy

Contact Us
Receive Tips & Updates

Copyright © 2017 Miva, Inc - All Rights Reserved

Back To The Top