MORNINGTIME OGONE PRO MANUAL (MANUAL V1.0) 1. Sign up for an Ogone account at http://www.ogone.com. 2. This module works for Magento Community 1.3-1.5 and Enterprise 1.7-1.10 CONTENTS Morningtime Ogone Pro Manual (manual v1.0)... 1 Step 1 - Preparations... 1 Step 2 - unpack and copy files... 2 Step 3 - copy required files to your custom theme... 2 Step 4 - login to Magento, flush caches, re-login... 2 Step 5 - Gateway URLS... 2 Step 6 - Configure Magento... 3 Step 7 - Configure payment methods... 4 Step 8 - PAyment STATUSES... 5 Step 9 - Ogone Technical configuration... 5 Step 10 - How to create a directlink API USER... 10 Step 11 - Multi-store, multi-site, multi-domain setups... 11 STEP 1 - PREPARATIONS Before continuing, please uninstall / remove previous Ogone installations (third party or Magento Core) Please disable the Magento compiler under System > Tools > Compiler. After installation, you may re-run and active the compiler for performance. If you have installed a previous 'Ogone' module, you must manually edit your database: o Go into database table 'core_resource' and delete the row with 'Ogone'. This is necessary to reinstall the correct mysql routines.
STEP 2 - UNPACK AND COPY FILE S Unpack the files from the purchased 'download.zip'. If you do not have software to unpack this, see http://www.7- zip.org/. You will find a main folder app. Copy this folder to your Magento root. No files will be overridden. STEP 3 - COPY REQUIRED FILES TO YOUR CUSTOM THEME Notice the module files under: app/design/frontend/default/default/layout/morningtime/ogone/ * app/design/frontend/default/default/template/morningtime/ogone/ * Often these files need to be copied to your custom theme. For example: app/design/frontend/mygroup/mytheme/layout/morningtime/ogone/ * app/design/frontend/mygroup/mytheme/template/morningtime/ogone/ * Please check and copy the files if needed. STEP 4 - LOGIN TO MAGENTO, FLUSH CACHES, RE-LOGIN Login to the Magento admin; Go to System > Cache Management and flush (refresh) all caches; Log out of the Magento admin; Now log back in. (You need to do this in order to load access rights for the first time.) The module comes with a MySQL installation script. This is normally run automatically. If you are experiencing problems with the module, please go into your database's "core_resource" table and delete the rows with "Ogone". Then flush the Magento cache again. STEP 5 - GATEWAY URLS TEST: https://secure.ogone.com/ncol/test/orderstandard_utf8.asp PRODUCTION: https://secure.ogone.com/ncol/prod/orderstandard_utf8.asp DirectLink TEST: https://secure.ogone.com/ncol/test/orderdirect.asp DirectLink PRODUCTION: https://secure.ogone.com/ncol/prod/orderdirect.asp
STEP 6 - CONFIGURE MAGENTO Go to System > Configuration > Sales > Ogone 1. Account Settings a. Enter your PSPID (Merchant ID) b. Enter the SHA IN and OUT pass phrases (copy them from your Ogone account technical settings - they must match perfectly.) c. Choose your signature method: old style for accounts before May 2010, new style for accounts after May 2010. 2. Payment Settings a. Choose Payment Action: Default, Authorization or Direct Sale (recommended). b. Enable Test Mode for testing with your TEST account (enabled by default). c. Debug mode stores the submitted Form Fields in a database table "ogone_debug". d. Email order: if you want to send an order email after payment. e. Email invoice: if you want to send an invoice email. f. Show logos: if you want to show the Payment Logo's (brands) on the Checkout Payment page 3. DirectLink Settings Warning: DirectLink is an Ogone subscription option for Premium Accounts only. You must be PCI compliant and offer HTTPS connections. With DirectLink, visitors can enter their CreditCard number directly during your checkout. The customer never leaves your website, they do not see any Ogone pages. DirectLink is an Ogone subscription option. Please ask Ogone to enable DirectLink for your account. Your server must support secure URLs HTTPS:// a. Enable DirectLink Yes/No (default No) b. Enter your API User Id (see Step 10 for more explanation how to create an API user) c. Enter your API User password (See Step 10) d. Enter your DirectLink SHA IN Pass phrase - different from the "normal" SHA-IN e. Choose the ECI (commerce indicator) and set it to E-commerce with SSL (default). You do not need to change this value.
4. Security Settings a. Enable Fraud Detection Module Yes/No? (default Yes, will submit IP Address of customer to Ogone) b. Enable 3-D Secure? Ask Ogone to activate your 3-D Secure account option. 3-D Secure only works for VISA/MasterCard and is an extra layer of security. Can also be used with DirectLink enabled, in which case you also need to activate Direct3-D. Ask Ogone to help your active these options in your account. 5. Template Settings a. iphone auto-detect? Yes/No. (Default No). This is only relevant for the Ogone payment form for non-directlink payments. b. Payment Template. Do you want Magento or Ogone to provide a payment template? Defaults to Magento. This is relevant only for non-directlink payments. c. If you have selected Ogone, then you must enter all other fields, e.g. text color etc. STEP 7 - CONFIGURE PAYMENT METHODS 1. All Ogone payment methods are found separately under System > Configuration > Sales > Payment Methods. You will find them all there, for example: 2. Enable any payment method you need. a. Set Enabled: yes b. Set your custom Title c. Set applicable countries d. Set Minimum or Maxiumum order total to use this payment methods e. Set the sort order
STEP 8 - PAYMENT STATUSES This step is only required for Magento 1.5+. Go to System > Order Statuses. Add the following statuses and map them to these states: Status Code Label State Code [title] ogone_pending Ogone Pending pending_payment [Pending Payment] ogone_cancel Ogone Canceled canceled [Canceled] ogone_decline Ogone Declined canceled [Canceled] ogone_processing Ogone Processing Payment processing [Processing] ogone_processed Ogone Processed Payment processing [Processing] ogone_auth Ogone Waiting for pending_payment [Pending Payment] Authorization The status code must be exactly the same. You may change the Label or State code [title]. It is recommended to keep the Morningtime suggestions. STEP 9 - OGONE TECHNICAL CONFIGURATION Login to your test or production account. Note: you must start with the TEST account and then migrate all your settings to PRODUCTION. Keep in mind that the SHA signatures will change between them, so re-check and reenter them. Login to your Ogone account
Global transaction parameters Global Security parameters
Payment page layout Data and origin verification
Transaction feedback - part 1/2
Transaction feedback part 2
STEP 10 - HOW TO CREATE A DIRECTLINK API USER Assuming you have DirectLink activated in your Ogone (if not, ask Ogone to enable it in your account). Go to Configuration > Users and click "New User" After saving the API user, Ogone will generate a password
STEP 11 - MULTI-STORE, MULTI-SITE, MULTI-DOMAIN SETUPS You can use this module for multi-store setups. 1. Single Magento installation, multiple websites and stores, single Ogone account a. In this setup, you can use your default domain settings for all Ogone configurations. The module will know which order came from which store. b. Please disable the postback url in your Transaction Feedback technical settings. 2. Multiple Magento installations, single Ogone account a. In this setup, you cannot have postback/offlineprocess functionality. This means sometimes your user will not receive a payment notification. This is an Ogone limitation, not Morningtime! b. Please disable the postback url in your Transaction Feedback technical settings. c. Please disable the offlineprocess url in your Transaction Feedback technical settings.