.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ===================== EXT: multishop\_paynl ===================== :Author: Bas van Beek :Created: 2014-06-26T10:28:25.350000000 :Changed by: Bas van Beek :Changed: 2015-02-23T21:46:30.370000000 :Classification: multishop_paynl :Keywords: multishop_paynl :Author: Bas van Beek :Email: bvbmedia@gmail.com :Language: en .. _img-1-EXT-multishop-paynl: |img-1| EXT: multishop\_paynl ============================= Extension Key: multishop\_paynl Language: en Version: 1 Keywords: multishop\_paynl 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\_paynl 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>`_** `API Tokens and Account ID 5 <#__RefHeading__665_1788240698>`_ `Creating website profile 7 <#__RefHeading__522_214932857>`_ **`TYPO3 backend steps 10 <#__RefHeading__1159_1841071799>`_** **`TYPO3 Multishop steps 12 <#__RefHeading__1165_1841071799>`_** **`TYPO3 Multishop Support 19 <#__RefHeading__838_118242056>`_** **`Help TYPO3 Multishop 20 <#__RefHeading__840_118242056>`_** .. _Introduction: Introduction ------------ Pay.nl offers innovative and solid payment products and solutions for small business and large corporations. With Pay.nl 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/paynl/ `_ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This plugin adds the payment service provider Pay.nl 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 Pay.nl then you will need to install this plugin. .. _Installation-requirements: Installation requirements ------------------------- **To configure Pay.nl properly on your TYPO3 Multishop web shop make sure that:** - You have registered an Pay.nl account: `https://www.typo3multishop.com /payment-service-providers/paynl/ `_ - 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 - TYPO3 is updated to 4.5.33 (or later) / 4.7.19 (or later) / 6.2.3 (or later) .. _Installation-instructions: Installation instructions ------------------------- Open the following page to login to your Pay.nl account dashboard: |img-2| `https://www.pay.nl `_ .. _API-Tokens-and-Account-ID: API Tokens and Account ID ^^^^^^^^^^^^^^^^^^^^^^^^^ After logged in, click “Merchant/ Company Data (Connection)” |img-3| |img-4| scroll to the bottom to get to the API Tokens table, and click “add” to create the new API tokens and Account ID |img-5| Fill in the description, and check the “All merchant rights” checkbox and click save.Now you are done creating the API Tokens along with Account ID, we will get back to this section later on. On next page i will explain on how to create website profile. .. _Creating-website-profile: Creating website profile ^^^^^^^^^^^^^^^^^^^^^^^^ |img-6| Click “Manage” menu Click “Service” submenu And, clik “Add” at bottom of the Service Listing table You will redirected to “New Service” form page, as showed below: |img-7| A. General Information section: The name of you new service/website profile (e.g: MyWebshop) URL of your webshop (e.g `http://www.mywebshop.com `_ ) The category of your webshop, select the category that matches/close to your webshop services Brief description about your webshop Module name, in this case you must select “Webshop”\ Select “Own Webshop” for the Connected-via Leave the “Plug-in” selectbox as it is, now we continue on next sectiuon within same “New Service” form page B. Payment Options section: |img-8| check the payment method you want to associates with your web profile, once you done with it you can leave the other form input as it is and click the little grey “add” button at the bottom of the page. |img-9| |img-10| Once you click the “Add” button you will redirected to “Service Listing” page again When all step on pay.nl dashboard done, we can continue on install and setup in Typo3 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. Search for “multishop paynl” 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 Pay.nl” |img-11| **NAME** The title of the payment method. I.e. Pay.nl. **DESCRIPTION** The description of the payment method. I.e. Pay your order secure with Pay.nl. **CODE** Unique code that will be used in the orders database (payment method key). I.e. paynl\_ideal. **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/shipping costs. **Pay.nl fields** To get the Pay.nl website profile details you can see it on your account dashboard project details page `http://www.pay.nl `_ and goto Manage > Services |img-12| Manage Menu Services Submenu Link Website Profile details popup Switch for “Test/Production” mode of the website profile Click on number 3, to see the Website profile details page |img-13| **ACCOUNT\_ID** This field must contain the Pay.nl “ **Account ID** ". **PROGRAM\_ID** This field must contain the Pay.nl “ **programID** ” **WEBSITE\_ID** This field must contain the Pay.nl “ **websiteID** ” **LOCATION\_ID** This field must contain the Pay.nl “ **websiteLocationID** ” **API\_TOKEN** This field must contain the Pay.nl “ **Token** ” once all those field above are filled in, you will see the new Field “PAYMENT\_TYPE” are created, the payment method displayed in radio button are the method related to website profile you have in pay.nl **PAYMENT\_TYPE** The payment type you want to relate with this setup based on your “Website Profile” on Pay.nl Project. **SUCCESS\_STATUS** Update to this order status when the payment is succeeded. **CANCELLED\_STATUS** Update to this order status when the payment is cancelled. **FAILED\_STATUS** Update to this order status when the payment is failed. **OPEN\_STATUS** Update to this order status when the payment is still waiting for payment clearence. Click the “Save” button to store the new payment method to the database. .. _generated: ((generated)) ^^^^^^^^^^^^^ .. _generated: ((generated)) """"""""""""" .. _Relate-payment-method-to-zone: Relate payment method to zone ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Open SYSTEM / SHIPPING & PAYMENT / PAYMENT ZONE MAPPING |img-14| Relate payment method to shipping method ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Open SYSTEM / SHIPPING & PAYMENT / SHIPPING TO PAYMENT MAPPINGS |img-15| Example checkout: |img-16| |img-17| -------- .. _img-18-img-19-TYPO3-Multishop-Support: |img-18| |img-19| 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: 170 .. :id: graphics6 .. :name: graphics6 .. :width: 631 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 105 .. :id: graphics7 .. :name: graphics7 .. :width: 631 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 101 .. :id: graphics16 .. :name: graphics16 .. :width: 631 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 527 .. :id: graphics17 .. :name: graphics17 .. :width: 631 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 207 .. :id: graphics8 .. :name: graphics8 .. :width: 631 .. |img-7| image:: img-7.png .. :align: left .. :border: 0 .. :height: 312 .. :id: graphics9 .. :name: graphics9 .. :width: 631 .. |img-8| image:: img-8.png .. :align: left .. :border: 0 .. :height: 338 .. :id: graphics19 .. :name: graphics19 .. :width: 631 .. |img-9| image:: img-9.png .. :align: left .. :border: 0 .. :height: 333 .. :id: graphics18 .. :name: graphics18 .. :width: 631 .. |img-10| image:: img-10.png .. :align: left .. :border: 0 .. :height: 287 .. :id: graphics20 .. :name: graphics20 .. :width: 631 .. |img-11| image:: img-11.png .. :align: left .. :border: 0 .. :height: 123 .. :id: graphics5 .. :name: graphics5 .. :width: 631 .. |img-12| image:: img-12.png .. :align: left .. :border: 0 .. :height: 254 .. :id: graphics10 .. :name: graphics10 .. :width: 631 .. |img-13| image:: img-13.png .. :align: left .. :border: 0 .. :height: 463 .. :id: graphics21 .. :name: graphics21 .. :width: 631 .. |img-14| image:: img-14.png .. :align: left .. :border: 0 .. :height: 79 .. :id: graphics11 .. :name: graphics11 .. :width: 631 .. |img-15| image:: img-15.png .. :align: left .. :border: 0 .. :height: 99 .. :id: graphics12 .. :name: graphics12 .. :width: 631 .. |img-16| image:: img-16.png .. :align: left .. :border: 0 .. :height: 482 .. :id: graphics13 .. :name: graphics13 .. :width: 631 .. |img-17| image:: img-17.png .. :align: left .. :border: 0 .. :height: 539 .. :id: graphics22 .. :name: graphics22 .. :width: 631 .. |img-18| image:: img-18.png .. :align: left .. :border: 0 .. :height: 419 .. :id: graphics14 .. :name: graphics14 .. :width: 631 .. |img-19| image:: img-19.png .. :align: left .. :border: 0 .. :height: 483 .. :id: graphics15 .. :name: graphics15 .. :width: 631