.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ============================ EXT: multishop\_multisafepay ============================ :Author: Bas van Beek :Created: 2014-06-26T10:28:25.350000000 :Changed by: Bas van Beek :Changed: 2014-06-26T10:28:26.140000000 :Classification: multishop_multisafepay :Keywords: multishop_multisafepay :Author: Bas van Beek :Email: bvbmedia@gmail.com :Language: en .. _img-1-EXT-multishop-multisafepay: |img-1| EXT: multishop\_multisafepay ==================================== Extension Key: multishop\_multisafepay Language: en Version: 1 Keywords: multishop\_multisafepay Copyright 2012-2014, Bas van Beek, BVB Media BV ( `bvbmedia@gmail.com `_ ) Official TYPO3 Multishop web site: `https://www.typo3multishop.com/ `_ This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.org .. _Table-of-Contents: Table of Contents ----------------- **`EXT: multishop\_multisafepay 1 <#__RefHeading__5708_1738894311>`_** **`Introduction 3 <#__RefHeading__5710_1738894311>`_** `What does it do? 3 <#__RefHeading__463_413120346>`_ `What can it be used for? 3 <#__RefHeading__1147_1841071799>`_ **`Installation requirements 4 <#__RefHeading__374_148308531>`_** **`Installation instructions 5 <#__RefHeading__836_118242056>`_** **`TYPO3 Multishop Support 17 <#__RefHeading__838_118242056>`_** **`Help TYPO3 Multishop 18 <#__RefHeading__840_118242056>`_** .. _Introduction: Introduction ------------ MultiSafepay offers innovative and solid payment products and solutions for small business and large corporations. With MultiSafepay you can offer specific local payment options for Germany, The Netherlands and Belgium and a wide variety of creditcards for all other countries. More information can be read here: `https://www.typo3multishop.com/payment-service- providers/multisafepay/ `_ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This plugin adds the payment service provider MultiSafepay to your TYPO3 Multishop installation. .. _What-can-it-be-used-for: What can it be used for? ^^^^^^^^^^^^^^^^^^^^^^^^ If you need your customers to pay securely through MultiSafepay than you will need to install this plugin. .. _Installation-requirements: Installation requirements ------------------------- **To configure MultiSafepay properly on your TYPO3 Multishop web shop make sure that:** - You have registered an MultiSafepay account: `https://www.typo3multishop.com/payment-service- providers/multisafepay/ `_ - Multishop is updated to version 3 or higher - Your web server is running PHP 5.3.3 (5.4.27 or later is recommended) - You use MySQL 5 as database server (5.5.0 or later is recommended) - The PHP memory limit is higher than 256MB. For optimal backup functionality larger is recommended. - PHP is compiled with mbstrings - CURL is enabled, which is required by some payment service providers - SimpleXML module is enabled for reading XML strings as object - TYPO3 is updated to 4.5.33 (or later) / 4.7.19 (or later) / 6.2.3 (or later) .. _Installation-instructions: Installation instructions ------------------------- .. _generated: ((generated)) ^^^^^^^^^^^^^ .. _generated: ((generated)) """"""""""""" .. _Creating-a-web-site-profile-on-your-MultiSafepay-test-account: Creating a web site profile on your MultiSafepay test account ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Open the following page to login to your MultiSafepay test account dashboard: https://testmerchant.multisafepay.com/ |img-2| Click “Settings / Site Wizard” Add the web site URL. I.e. `http://www.yourdomain.com `_ Click “Continue” |img-3| |img-4| **Description** Define the web site title. **Notification URL** Define the following URL: :: http://www.yourdomain.com/index.php?id=39&type=2002&tx_multishop_pi1[page_section]=psp&tx_multishop_pi1[payment_lib]=multisafepay&tx_multishop_pi1[payment_section]=notification&paytype=initial Note: the value of the variable id must be the id number of the Multishop core shop page. In our example this is 39, which you can see in the following illustration: |img-5| **Type of software** Enable the checkboxes that are related to your shop Press “Continue” |img-6| When all fields are defined press “Continue” to review the website profile. |img-7| Press “Submit Website” to save the new Website Profile. The site ID is now created and listed in the menu Sites. You have to write down the site ID and Site Secure Code, because you will need to configure this in Multishop. .. _TYPO3-backend-steps: TYPO3 backend steps """"""""""""""""""" Login to your TYPO3 dashboard and open the Extension Manager. Make sure you update the repository first, otherwise it can happen that TYPO3 will download an older version of the plugin. |img-8| |img-9| |img-10| The plugin is now installed and you can proceed with configuring it inside the Multishop admin panel. .. _TYPO3-Multishop-steps: TYPO3 Multishop steps """"""""""""""""""""" Go to the site and login as the Multishop admin user. - Open SYSTEM / SHIPPING AND PAYMENT / PAYMENT METHODS - Click “Add payment method” - Click “Add MultiSafepay” |img-11| **NAME** The title of the payment method. I.e.MultiSafepay. **DESCRIPTION** The description of the payment method. I.e. Pay your order secure with MultiSafepay. **CODE** Unique code that will be used in the orders database (payment method key). I.e. MULTISAFEPAY. **HANDLING COSTS TYPE** If you need to calculate extra handling costs when customers pay through this payment method. The value can be an exact amount or based by order amount percentage. **HANDLING COSTS** The amount of the handling costs. **VAT RATE** The VAT amount that should be calculated over the handling costs. **MultiSafepay fields** **MERCHANT\_ACCOUNT** This field must contain the MultiSafepay “account ID". **MERCHANT\_SITE\_ID** This field must contain the MultiSafepay “Site ID” **MERCHANT\_SECRET\_CODE** This field must contain the MultiSafepay “Site Secure Code” **SUCCESS\_STATUS** Update to this order status when the payment is succeeded. **CANCELLED\_STATUS** Update to this order status when the payment is cancelled. **PENDING\_STATUS** Update to this order status when the payment is pending. **DECLINED\_STATUS** Update to this order status when the payment is declined. **EXCEPTION\_STATUS** Update to this order status when an exception occurred. **PAYMENT\_GATEWAY** Select the payment gateway. I.e. IDEAL. **TEST** Select “true” if you are configuring your MultiSafepay test account. Select “false” when you configure the MultiSafepay production account. **AUTOSUBMIT** When this is set to “true” the customer will be automatically redirected to the MultiSafepay payment page, after he/she finished the checkout. Click the “Save” button to store the new payment method to the database. .. _Relate-payment-method-to-zone: Relate payment method to zone ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Open SYSTEM / SHIPPING & PAYMENT / PAYMENT ZONE MAPPING |img-12| Relate payment method to shipping method ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Open SYSTEM / SHIPPING & PAYMENT / SHIPPING TO PAYMENT MAPPINGS |img-13| Example checkout: |img-14| |img-15| |img-16| |img-17| |img-18| |img-19| |img-20| TYPO3 Multishop Support ----------------------- If you have difficulties to configure MultiSafepay you can always check our payment service provider forum: :: https://www.typo3multishop.com/forum/list_topic/payment-service-providers/ .. _Help-TYPO3-Multishop: Help TYPO3 Multishop -------------------- **Do you like Multishop? Share it and join us on:** - `http://www.facebook.com/typo3multishop `_ - `https://twitter.com/typo3multishop `_ - `http://www.linkedin.com/groups/TYPO3-Multishop-3117344 `_ - `https://www.xing.com/net/typo3multishop `_ - `http://www.typo3multishop.com/forum/ `_ **You'd like to do something back for our hard work?** Send a donation! Link: https://www.typo3multishop.com/donate/ **Your support is truly appreciated!** .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :align: left .. :border: 0 .. :height: 270 .. :id: graphics6 .. :name: graphics6 .. :width: 631 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 342 .. :id: graphics7 .. :name: graphics7 .. :width: 631 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 517 .. :id: graphics8 .. :name: graphics8 .. :width: 631 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 444 .. :id: graphics9 .. :name: graphics9 .. :width: 245 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 357 .. :id: graphics10 .. :name: graphics10 .. :width: 631 .. |img-7| image:: img-7.png .. :align: left .. :border: 0 .. :height: 696 .. :id: graphics11 .. :name: graphics11 .. :width: 631 .. |img-8| image:: img-8.png .. :align: left .. :border: 0 .. :height: 335 .. :id: graphics1 .. :name: graphics1 .. :width: 631 .. |img-9| image:: img-9.png .. :align: left .. :border: 0 .. :height: 335 .. :id: graphics2 .. :name: graphics2 .. :width: 631 .. |img-10| image:: img-10.png .. :align: left .. :border: 0 .. :height: 227 .. :id: graphics3 .. :name: graphics3 .. :width: 476 .. |img-11| image:: img-11.png .. :align: left .. :border: 0 .. :height: 335 .. :id: graphics5 .. :name: graphics5 .. :width: 631 .. |img-12| image:: img-12.png .. :align: left .. :border: 0 .. :height: 91 .. :id: graphics12 .. :name: graphics12 .. :width: 631 .. |img-13| image:: img-13.png .. :align: left .. :border: 0 .. :height: 70 .. :id: graphics13 .. :name: graphics13 .. :width: 631 .. |img-14| image:: img-14.png .. :align: left .. :border: 0 .. :height: 313 .. :id: graphics14 .. :name: graphics14 .. :width: 631 .. |img-15| image:: img-15.png .. :align: left .. :border: 0 .. :height: 381 .. :id: graphics15 .. :name: graphics15 .. :width: 631 .. |img-16| image:: img-16.png .. :align: left .. :border: 0 .. :height: 176 .. :id: graphics16 .. :name: graphics16 .. :width: 631 .. |img-17| image:: img-17.png .. :align: left .. :border: 0 .. :height: 542 .. :id: graphics17 .. :name: graphics17 .. :width: 631 .. |img-18| image:: img-18.png .. :align: left .. :border: 0 .. :height: 437 .. :id: graphics18 .. :name: graphics18 .. :width: 631 .. |img-19| image:: img-19.png .. :align: left .. :border: 0 .. :height: 161 .. :id: graphics19 .. :name: graphics19 .. :width: 631 .. |img-20| image:: img-20.png .. :align: left .. :border: 0 .. :height: 171 .. :id: graphics20 .. :name: graphics20 .. :width: 631