MinaCart 2.0 User Guide1.0 OverviewThis section of the document provides users with an overview of the Mina Shopping Cart. It also explains the process required for you to register a domain name / point an existing domain name towards your Mina Shopping Cart. 1.1 New Domain Name RegistrationIf you have not registered a domain name in the past, or if you would like help with registering a new domain name for your Mina Shopping Cart, talk to DPS. DPS in partnership with 2day.com can assist in setting up a domain name for you. This will allow you to brand the Mina Shopping Cart the way you want it, in accordance with your company's branding requirements. For information on the registration procedure and charges associated with registering a domain name with 2day.com please visit www.2day.com. 1.2 Use Existing Domain NameIf you already have a registered, valid domain name, you will need to point that domain name (or sub domain e.g. shop.companyname.co.nz) towards the Mina Shopping Cart. Speak with the technical support department of the registrar you have registered your domain with about implementing this change. Technical Information The domain name's DNS settings (in particular the 'A' Record) must point towards the following IP address: 202.74.224.69. This server is unable to host email, DO NOT POINT THE MX RECORD TOWARDS THIS IP ADDRESS. 2.0 The Manager InterfaceYou will need to manage (add/edit/update content) of your Mina Shopping Cart via this management interface. This is done by accessing the management console website, and entering your unique username/password. Please contact DPS if you have misplaced your password. (Please note: Only registered contacts on the account will be able to request for a change in password for security reasons). 2.1 Understanding the InterfaceThe management console is the heart of your Mina Shopping Cart. It allows you to add/edit/update and deletes products as required. After you have successfully gained access to the Mina Shopping Cart management console, you will be presented with the following menu: ![]() Figure 1: The Mina Manager Interface You can access the Payment Manager interface simply by clicking on the 'Connect to PaymentExpress' button. For more information on the Payment Manager (Payline™) please view section 3 of this document. 2.2 Company ProfileThe company profile screen allows you to configure your company profile that will be reflective in your Mina Shopping Cart.
Any changes made will not be reflective until you 'submit' changes. Important Note: All images uploaded must have the following extensions only (.jpeg, .jpg, .gif, .png), and must be under 100K in size. 2.3 Payment Profile
Figure 2: Enabling/Editing Payment Options To configure each of these options, click on 'Edit'. Once you have made changes click on 'Update' to save changes. To disable a payment type click 'Edit' in the corresponding line and uncheck the check box. Click 'Update' once this is done to save changes. Cheque/Money Order Address 2.4 Freight
Add New Freight Option You will need to enter a 'Location' (e.g. North Island, New Zealand) and specify a price in 0.00 format only. Do not add the $ sign preceding the numerical value entered. Select the GST applicable checkbox if this is applicable to the location being entered.
Figure 3: Adding Freight Products and Making them GST Applicable Once you have added this freight option click on 'Update' to save changes. Delete Freight Option Edit a Freight Option 2.5 ProductsThis section of the guide will explain how to add a button that dynamically links from your current website to the Mina Shopping Cart engine by adding an 'add to cart' or similar image. Follow the steps below in sequence to enable this setup. 2.5.1 Add a New Product to the Shopping Cart EngineClick 'Add Product'. A new table entry will be created. Enter a unique ID for each product. (DPS recommend using product ID's 001, 0001 and increasing the number of preceding 0's depending on the number of products you are entering. Increment this ID by 1 (e.g. 002 after 001) for each new product added).
Figure 4: Adding a Product to Mina Enter a product title (e.g. Tennis Shoes). This will be the title displayed to the user. If you have images residing on a web server you would like Mina to map to, enter the absolute path of the full size image (in the Image (URL)) field, and the absolute path of the thumbnail image in the (Thumbnail (URL)) field. Alternatively, you can browse for an image (full size image) that you would like to upload to the Mina Shopping Cart Server. A thumbnail image is automatically generated. Enter the price (without GST) in 0.00 format. Do not precede this value with $. Enter a description of the product. To add in line breaks enter <br>. Click 'Update' to save changes. 2.5.2 Associate Mina Generated Links with Your Current StoreClick on the show button to view the generated HTML links. ![]() Figure 5: Showing URL You will be presented with an expanded table with the product code, name and links. Copy and paste the link that corresponds between the product you have entered in the Mina Shopping Cart and your own product page. You will need to change the 'pageback=' property to map to your own product page (e.g. if your page is http://www.companyname.com/tennis_shoe.htm) this is the value you will need to add. This step is vital. ![]() Figure 6: Copying and Pasting URL Important Notes
Optional Step To associate a characteristic with a product, click 'Edit' under the characteristic(s) column. This will allow you associate a defined characteristic with a product by selecting it from a checkbox. (Note: you can associate multiple characteristics to a product - e.g. size, color). To associate a product with a category, click 'Edit' in the first column, and select a category from the drop down list available under the categories column.
Edit a Product
Figure 7: Editing Products / Associating Characteristics & Categories
Delete a Product 2.5.3 Adding a Current Count and Total Item counterTo add a counter to your shopping cart pages, include the image tag and JavaScript tag generated in section 1 of the products page. (The illustration below is an EXAMPLE ONLY and WILL NOT BE APPLICABLE TO YOUR SHOPPING CART).
Figure 8: Adding an Current Count and Total Count (Example Only) 2.5.4 Adding a Checkout ButtonYou can link your own 'checkout' button with the code that is listed under section 2 of the products page. (The illustration below is an EXAMPLE ONLY, and WILL NOT BE APPLICABLE TO YOUR SHOPPING CART).
Figure 9: Example of Checkout Button Link 2.6 Characteristics
Add a New Characteristic Each characteristic (e.g. color) can have multiple values associated. To add multiple values click 'Add Value' and enter an appropriate value (e.g. green). Click 'Update' to save changes.
Edit a Characteristic
Edit a Value
Figure 10: Associating Values with Characteristics
Delete a Characteristic Delete a Value 2.7 Product Categories Adding a Category
Figure 11: Adding Product Categories Editing a Category
Figure 12: Editing Product Categories Deleting a Category 2.8 OrdersA list of transactions is displayed in the orders screen. This console can be used as a form of updating the status of each order and viewing detailed information on the order. The response field identifies the outcome of the transaction in a snapshot (e.g. Approved). View Detailed Order Information
Figure 13: Viewing Orders (Detailed View) This window will now display the items the customer purchased (lists all products and quantity) and displays the delivery option selected, GST amount paid and finally the total value of purchase. This 'report' will also detail delivery instructions that the customer entered - including the name, delivery address, billing address, telephone number and email address of the customer that has made a purchase. Editing Status of Each Order
Figure 14: Editing the Status of Each Order Deleting an Order 3.0 Using the Payment Manager (Payline™)The Payment Manager is included with the Mina Shopping Cart. It allows users to process MOTO (mail order / telephone order) transactions, process refunds and generate reports. 3.1 Understanding the InterfaceThe Payment Manager interface has been designed to be easy to use. Users are presented with a menu along the left that allows them to navigate through the Payment Manger with ease. The Payment Manager can be configured to suit each individual (e.g. supervisor privileges, user privileges) and multiple accounts can configured (an additional $30 configuration charge is incurred for each additional Payment Manager configuration). 3.2 Processing a MOTO transactionClick 'Purchase'. Enter a merchant reference; this can be anything such as an invoice number, or an order number. Enter a valid credit card number and expiry date. If you have multi-currency set up, select from the drop down menu the currency type (e.g. NZD, AUD) from the drop down menu and enter in the dollar value of the purchase. You will be notified of a successful / unsuccessful transaction in the next screen. NOTE: If you have pre-authorization / completion (sometimes known as tipping) enabled, and would like to use these features for your MOTO transactions, please view the Payment Manager Guide for more detailed processing information.
3.3 Viewing TransactionsTo view transactions that have been put through Mina and via the Payment Manager click 'Transactions'. This will display a list of transactions (both successful and otherwise) along with the merchant reference field. Approved transactions are marked with a green 'check' and unsuccessful transactions are marked with a red 'cross'. 3.4 Processing a RefundUsers can process refunds for any card that has made an initial purchase either via Mina or the Payment Manager. This refund process can be done multiple times (but only up to the original value of the purchase). To process a refund, click 'Refund'. To search for an initial purchase enter either a 'Merchant Reference' or search for the transaction within a data range (please note that the date range selected must be LESS THAN 14 DAYS). Alternatively, a list of transactions that can be refunded are also listed as radio buttons. Select the transaction you want to refund and click 'Next Step'. You will be prompted to enter a 'Refund Password' which by default is the same password you used to logon to the Payment Manager with. Enter an appropriate merchant reference (e.g. Invoice 2833 - Refund) and enter the amount you wish to refund. Click 'Submit'. You will be notified of a successful / unsuccessful transaction in the next screen. 3.5 ReportsDPS reports allow for easy reconciliation of funds with your bank reports. To generate a standard report follow the procedure listed below:
Once the report has been generated, it will appear in the panel below the entry screen. New/unopened reports are highlighted red and read reports are marked as normal in grey. To view a report, click on the report name. 4.0 Navigating Through Your Website4.1 Browsing ProductsTo browse products available, click on the tabs to each of the categories. To view all products click 'All products' (NOTE: This must be enabled at the Mina Management Console in order for this option to be enabled). 4.2 Add Products to Shopping CartOnce the user selects a product they want to purchase, click on 'Add to Cart'. This by default adds a quantity of 1 to the shopping cart. This quantity can be changed at time of checkout. 4.3 CheckoutTo proceed to the checkout, the click on 'Checkout'. To increase the quantity of the products currently in the shopping cart, replace the 1 value with the required quantity to be purchased. The total amount calculated is dynamically updated once the user changes the quantity amount. To remove a product from the basket, click 'Remove' from the corresponding item to be removed. Users can select options for delivery from a drop down list. Prices for each of these delivery options update dynamically. To complete the checkout, the user must enter their Name, Delivery Address, and select a payment method. The user then enters their credit card details in a secure environment. Once this is complete, clicks 'Submit'. The user will be informed of a successful / unsuccessful transaction. The merchant receives email confirmation of successful credit card orders placed via Mina. 5.0 TroubleshootingIf you experience any troubles when using the Mina Shopping Cart or the Payment Manager, please follow the procedure below to assist us in helping solve your problem. |
MinaCart 2.0 is a product of Direct Payment Solutions Ltd