Best value in
web hosting HOSTING ORDERS SUPPORT CONTACT SITE MAP

Online User Manual - Miva Merchant

Main Online Manual

Online User Manual--Miva Merchant
Upsale
   Add Upsold Product
       Product Code
       Percentage of Order Total
       Price
          Absolute Price 
           Percentage of Original Price 
       Related Products for Upsale
          Set Related Products
      Edit/Delete Upsold Product
    Required Products

Tax Module

Shipping Modules
   Add Shipping Module
      UPS Online Shipping Calculations
      Minimum or Weight Shipping
      Flat Rate Shipping
      Base + Weight Shipping

 Payment Modules
   Add Payment Module
     Check
     Credit Card Pmt. w/ Simple Validation
        Remove
        Add
        Validation

GoChargeit Payment Module
         Add Module
           File Already On Server
              Add
           Add Module to Store
           Username for GoChargeit 
           Processing URL 
           Types of  Credit Cards

    CyberCash Configuration
        Add CyberCash Module
        URL to CyberCash 
        Merchant ID
        Type of Merchant
        Store Entire Credit Card Number
        Types of Credit Cards
        Configure Your Server

Return to Main Index
Upsale
When your customer has completed their order and submitted their payment, you may wish to have them presented with a special offer good only for that moment. The offer will be selected from a list of special items you designate, based on a set of criteria you designate.   This is called Upsale
To begin setting up your Upsale system, click on the small blue arrow to expand the sub-menu beneath Upsale. 
Add Upsold Product
Click on this to pull up the form for adding a product to your Upsale list.
  • Product Code

  • Enter the product code here, or, click on the Lookup link to have a complete list of existing products displayed for you. Select the product you wish to enter from the list and it's code will be entered automatically
  • Threshold Percentage of Order Total

  • An upsale item should not exceed the price of the total order, and should, in fact, be a percentage of the whole.  For example, if a customer's total shopping order is $100, you might want to exclude any upsale products that exceed %25 of that total, (or anything over $25.00) from being offered as an Upsale offer.
Return to Main Index        Back to Top
  • Price
    • Absolute Price 
      Select this option and enter  an exact upsale price for the item in decimal format.  The system will enter dollar signs as appropriate.
      Percentage of Original Price 
      Select this option and enter a percentage of the product's base price that you wish to charge as the upsale price. Use decimal format only.  (.80 instead of 80%)
  • Add

  • Click on the Add button to add this product to your Upsale list.
Related Products for Upsale
The criteria for selecting which products will be offered as Upsale items may depend on the items in a shopper's basket. If all items in your store are considered related to one another and you enter no special criteria for this, Miva Merchant will treat all Upsale items as being equally relative to each shopper's basket and base the item offered on price only (as selected above)

However if you offer different types of products, you may wish to designate the Upsale item offered based on the items in a shopper's basket. For example, if you sell jewelry and car parts, you would not necessarily want the Upsale offer to be a pair of earrings if the items in the shopper's basket are lug nuts and windshield wipers.

Return to Main Index        Back to Top
Set Related Products
To designate related products you must first enter a product for Upsale as explained above.  Then click on the name of the product in your Upsale section. 
  • Edit/Delete Upsold Product

  • A form will be displayed that has the information you entered in the Add Upsale Product.  You may edit this information if you wish. Click on the Update button to save your changes, or the Delete button to delete this product from your Upsale list. 
  • Required Products

  • You will see this at the bottom of the Edit/Delete Upsold Product form.  Enter a product that must be in a shopper's basket before this Upsale item will be offered. You may build a list with as many products as you like, but you must add them one at a time. 
    Use the Lookup link to display all of your existing products for you. The one you select will be automatically entered. Click on the Update button to add the currently selected product to the Required Products list.  The form will return with the entry field blank, ready for you to enter more items if you wish.
Return to Main Index        Back to Top
Tax Module
When you added your store you were prompted to select a method for tax calculations. Whichever one you selected will be displayed here. The current choices offered with Miva Merchant are Shopper Selected Sales Tax and State Based Sales Tax.  To change the default settings on your selection, click on it's title and make your changes. Click on the Update button to save your changes.  To change to a different tax module, go to Edit Store and make your selection change.

Shipping Modules
You will select your shipping module(s) from here. Click on the small blue arrow next to Shipping Modules to expand the sub-menu. 

Add Shipping Module
Click on the Add Shipping Module link to pull up the form. Select the shipping type you wish to use and click on the Add button.  This will install the currently selected shipping method.  You may select and setup as many of the shipping modules as you like. When your shoppers are ready to checkout, the different shipping options will be displayed for them in a drop-down menu  along with the total shipping charges for their order. They will then be allowed to select the method they wish to use.

  • UPS Online Shipping Calculations

  • This form has default settings pre-selected for you. You may make any changes that you wish in the selections of different shipping methods you wish to offer, and the Rate Chart you wish to display.  For more information on these settings and what they mean, visit the UPS website at:
    www.ups.com
    You should not change the UPS Gateway URL as this connects directly to UPS for accurate cost calculations. 
    Note: You MUST enter weights for your products in order to use UPS shipping.
  • Minimum or Weight Shipping

  • This shipping method allows you to configure charges based on total order weight, or a minimum charge if the weight is under a specific amount.  You may add several methods and different rates for each method with this module by using the Update button. 
Return to Main Index        Back to Top
      Shipping Method
      Enter the name of the shipping method that you are using here. For example, USPS Priority.
      Amount/Weight Unit
      Enter a charge for each unit of measure. (For example, if you selected to use pounds as the unit of measure for your store, you will enter here your charge per pound of the order.  Go to Edit Store to determine the unit of measure for your store if necessary)  Enter in decimal format only (1.00) The system will automatically add the dollar sign ($) where appropriate.
      Minimum Charge
      Enter the amount to be charged if the total weight of the order is less than one unit of measurement. Enter in decimal format only  (1.00) The system will automatically add the dollar sign ($) where appropriate.
      Update/Remove
      Click the Update button to save your changes.  The saved shipping Method will be displayed, and the form will be returned for you to add a new method.  Click on the Remove this Module button to remove this module from your store.
  • Flat Rate Shipping

  • This is the simplest shipping method to use. It does not require any weights to be entered for your products.
      Add
      Enter an order total rate, such as Orders to $25.00.
      Amount
      Enter your flat rate charge for this order.  Enter in decimal format only. 
      Update
      Click the Update button to add this Rate.  The form will return with the Rate just added at the top of the form, and the entry fields empty. You may now add another Rate, such as Orders to $50.00
      To remove a rate, check the box next to it in the list and click the Update button.  Click on the Remove this Module button to remove the module from your store.
Return to Main Index        Back to Top
  • Base + Weight Shipping

  • This module will charge a Base charge you designate, plus a charge calculated based on the total weight of the order.
      Add
      Enter the name of your shipping method here.
      Base Charge
      Enter the base charge for this method here. Use decimal only.  The system will automatically enter the dollar sign ($) where appropriate.
      Weight/Unit
      Enter the charge per unit of weight here.  (For example, if you selected to use pounds as the unit of measure for your store, you will enter here your charge per pound of the order.  Go to Edit Store to determine the unit of measure for your store if necessary)  Enter in decimal format only (1.00) The system will automatically add the dollar sign ($) where appropriate.
      Update
      Click the Update to add the current method.  This will be listed at the top of the form and the entry fields will be returned blank so that you can add more methods. To remove a method, select it by checking the box next to it and click the Update button.  Click on the Remove this Module button to remove the module from your store.
Return to Main Index        Back to Top
Payment Modules
You will select your payment module(s) from here. You may select and setup as many of the payment modules as you like. When your shoppers are ready to checkout, the different payment options you select and offer will be displayed for them to choose from.  Click on the small blue arrow next to Payment Modules to expand the sub-menu.

Add Payment Module
Click on the Add Payment Module to pull up the form. Select the Payment module you wish to use from the drop-down menu and click on the Add button.  A form for configuring the payment method selected will be displayed.
Note:  You will find several third party commerce vending services  (except Check and Credit Card Payment with Simple Validation)  on your Payment Module menu. You must contact the vendor for the service you wish to use for full details on setting up and using their payment services.  You will find hyperlinks to each vendor's website on the form displayed when you select their module.  This manual covers instructions for setting up the simple Check and Credit Card Payment with Simple Validation modules as well as CyberCash, and GoChargeit.

Return to Main Index        Back to Top
  • Check

  • This requires no setup configuration. It simply adds a field to your order form that asks the shopper to enter a check number.  They will then need to mail you their check for payment of their order.
  • Credit Card Payment with Simple Validation

  • This module comes pre-loaded with Visa, Mastercard and American Express.  These three payment services are listed at the top of the form. 
    Remove
    You may remove a payment service by checking the box next to it and clicking on the Update button.
    Add
    You may add a payment service by entering it's name in the entry field and clicking on the Update button.  Click on the Remove This Module button to remove the module from your store.  All of the credit cards you add to the configuration form will be displayed for your shoppers to select from. 
    Validation
    Credit card numbers entered by your customers will be validated against a simple algorithm.  Real credit card numbers should pass, while false ones are rejected and an error message displayed. Please note:  This method of simple validation  is not perfect. Occasionally a real credit card number MAY be rejected by this system.  You may test the system using the following sets of numbers which should pass.

    4222 2222 2222
    4111 1111 1111 1111

    Four fields will be displayed on your order form to collect information from your customers wishing to pay by credit card.  These are:
    Customer Name, Exp. Date, Credit Card, and Card Number. Of these four only the Card Number field is validated here.

    Return to Main Index        Back to Top
    GoChargeit Payment Module
    To use the GoChargeit Payment Services module you will need to have a GoChargeit account, and a merchant account. Contact your IHP (Internet Host Provider)  for more information on obtaining a GoCharegeit account.
    Add Module
    Once you have a GoChargeit account, you will need to add the GoChargeit module.  The files for this are already installed with your Miva Merchant files on your server. You simply need to enter the path to have it displayed in your module list. 

    Click on the small blue arrow next to Modules in your Miva Merchant Admin menu.  Then click on the Add Module link. This will pull up the Add module form.

    File Already On Server
    Since the files for this module are altready on the server select this option.  Then enter the following path into the entry field exactly:
    modules/payment/gochargeit.mv

    Return to Main Index        Back to Top
    Add
    Click on the Add button and the GoChargeit module will be added to your module list.

    Add Module to Store
    Now you must add the module to your store's payment options. 

    • Click on the small blue arrow on Stores to expand it's sub-menu. 
    • Expand the sub-menu for Payment Modules, then click on  Add Payment Module to pull up the form.
    • Select the Gochargeit Payment Services module from the drop-down list and click the Add button. 
    The GoChargeit Payment Services module will now be installed and listed under Payment Modules. Click on it to pull up the configuration form.
    Return to Main Index        Back to Top
    • Username for GoChargeit Account

    • Enter your GoChargeit account username here
    • Processing URL for GoChargeit Payment Services Account:

    • The URL entered here by default should not be changed.
    • Process the Following Types of Payment

    • Select the card types you are setup to accept. Remember to check your merchant account to learn what cards you may accept.
    • Update/Remove

    • Click on the Update button to save any changes.  Click on the Remove This Module button to remove this module from your store.
    Return to Main Index        Back to Top
    CyberCash Configuration
    You must have a CyberCash account before you can add this functionality to your Miva Merchant. Visit www.cybercash.com to learn more about CyberCash, and to apply for your account. 

    You will be issued a merchant account and a merchant keystring which will serve as identifiers for your CyberCash account.  Note:  CyberCash customers must have a merchant account to process  customer's credit cards.

    There are two steps to configuring your CyberCash system to work. First you must add and setup your CyberCash module. Then you must configure your server.

    Add CyberCash Module
    Once you have opened your CyberCash account and received your merchant keystring, go to Add Payment Modules and select the CyberCash Payment Services module.  Click on the Add button to pull up the CyberCash configuration form.

  • URL to CyberCash CashRegister

  • This URL is set by default and will probably never need to be changed.
  • Merchant ID

  • Enter the merchant ID supplied by CyberCash here
  • Type of Merchant

  • Select the option that applies to you according to your CyberCash account type.
  • Store Entire Credit Card Number

  • Check this box if you need to have the full credit card number to display when processing.  (For example, if you do not Authorize Live, you will need the full number to process the charge.)
  • Process the Following Types of Credit Cards

  • Check the boxes next to the cards you will accept.
    Return to Main Index        Back to Top
    Configure Your Server
    Once you have your merchant ID and merchant keystring from CyberCash, you can configure your server.
    • Using a text editor such as Notepad, create a plain text file that contains your merchant keystring, with a carriage return after it.
    • Save the file using your merchant ID plus .key as a filename. For example, if your merchant ID is test-mck  then the filename would be  test-mck.key
    • Find the top data directory in your web account. This may be called "mivadata" or "htsdata" and usually resides either inside your home directory or parallel to your html directory.  This is where Miva Merchant has installed all of it's data, (i.e. htsdata/Merchant/)
    • Once you find your top data directory, create a new directory inside of it called CyberCash (i.e. mivadata/CyberCash/)  After you create the new directory, place the text key file you just created inside of it.
    Return to Main Index        Back to Top

    http://hostings.com   888-404-HOST (toll-free US/PR/VI/GU), 706-897-4743 call via Skype