.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt =================================== EXT: Yellowpay Gateway for commerce =================================== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: Cedric Spindler :Changed: 2008-12-16T12:10:57 :Classification: yellowpay2commerce :Description: The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ---- :Keywords: forAdmins :Author: Cedric Spindler :Email: cs@cabag.ch :Info 4: :Language: en |img-1| |img-2| EXT: Yellowpay Gateway for commerce - yellowpay2commerce .. _EXT-Yellowpay-Gateway-for-commerce: EXT: Yellowpay Gateway for commerce =================================== Extension Key: yellowpay2commerce Language: en Keywords: forAdmins Copyright 2000-2008, Cedric Spindler, 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 This extension is sponsored by cab services ag: `http://www.cabag.ch/typo3.html `_ .. _Table-of-Contents: Table of Contents ----------------- `EXT: Yellowpay Gateway for commerce 1 <#1.EXT:%20Yellowpay%20Gateway%20for%20commerce|outline>`_ **`Introduction 3 <#1.1.Introduction|outline>`_** `What does it do? 3 <#1.1.1.What%20does%20it%20do_|outline>`_ `Screenshots 3 <#1.1.2.Screenshots|outline>`_ **`Users manual 4 <#1.2.Users%20manual|outline>`_** `FAQ 4 <#1.2.1.FAQ|outline>`_ **`Administration 5 <#1.3.Administration|outline>`_** `FAQ 5 <#1.3.1.FAQ|outline>`_ **`Configuration 6 <#1.4.Configuration|outline>`_** **`Tutorial 7 <#1.5.Tutorial|outline>`_** **`Known problems 8 <#1.6.Known%20problems|outline>`_** **`To-Do list 9 <#1.7.To-Do%20list|outline>`_** **`ChangeLog 10 <#1.8.ChangeLog|outline>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This extension provides a commerce payment-provider to the yellowpay payment gateway. The yellowpay-provider will be added to the existing list of payment providers in commerce. Please put any bug reports or feature requests on forge.typo3.org project page. Patches are welcome when tested and commented properly (always with documentation text please). .. _Important: Important """"""""" This extension does not check if the payment was successful or if the order and userdata is valid! Manual checking in the Postfinance Backoffice by the seller is strongly recommended. TYPO3 does not provide the required security level to handle fully trusded payments! .. _Screenshots: Screenshots ^^^^^^^^^^^ .. _generated: ((generated)) """"""""""""" .. _Selection-of-the-Yellowpay-payment-method: Selection of the Yellowpay payment method ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. _img-3-Extension-Manager-Configuration: |img-3| Extension Manager Configuration. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The Postfinance backoffice will provide you with the required information: |img-4| .. _Users-manual: Users manual ------------ - After installing the extension a new payment article is added to the commerce payment product. You probably want to rename it, translate it or define a price. - Please be careful with this aricle, because the field “classname” is not shown in the backend, but the value in this field is required for the extension to work. .. _FAQ: FAQ ^^^ .. _generated: ((generated)) """"""""""""" .. _Does-the-extension-check-if-the-commerce-order-and-userdata-is-valid: Does the extension check if the commerce order and userdata is valid? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ No. This extension does not check if the payment was successful or if the order and userdata is valid! Manual checking in the Postfinance Backoffice by the seller is strongly recommended. TYPO3 does not provide the required security level to handle fully trusded payments! .. _Administration: Administration -------------- - You need a yellopay-payment-article. The classname of this article has to be set to “yellowpay” in the table “tx\_commerce\_articles”. - After installing the extension you sould configure it using the Extension Manager .. _FAQ: FAQ ^^^ Questions? Feel free to ask. .. _Configuration: Configuration ------------- - You can provide a test payment URL (yellowpayTestPaymentURL). As soon as you enter the URL for the production environment (yellowpayPaymentURL), the extension will use it instead of yellowpayTestPaymentURL. - The locale for selecting the Yellowpay gateway language is taken from $GLOBALS['TSFE']->config['config']['locale\_all']. Be sure to set it. Example (TS Constants): *lang.current\_locale = de\_DE.UTF-8* - The Postfinance backoffice has to be configured as shown in the Tutorial. .. _Tutorial: Tutorial -------- - Make a contract with Postfinance - Provide the Postfinance backoffice with the required information like URLs and Payment method. - 1.1.: GET - 1.2.: Your email adresses for the shop - 2.2.: URL that leads to the site containing the checkout plugin. - 4.1. first field: URL thad leads to the site containing the checkout plugin, followed by *?tx\_commerce\_pi3[terms]=termschecked&tx\_commer ce\_pi3[step]=finish&tx\_commerce\_pi3[yellowpay]=success* - 4.1. second field: URL thad leads to the site containing the checkout plugin, followed by: *?tx\_commerce\_pi3[terms]=termschecked&tx\_commerce\_pi3[step]=finish &tx\_commerce\_pi3[yellowpay]=failed* - 4.2.: “Make this request just after the payment and let the result customize the answer seen by customer (HTML code or redirection).” Authorize to defer the request if the online request has failed ? No. - 4.3.: “for "3 tiers" modes only” - 5.2.: “Display a ticket to the client if a redirection to your website is detected just after the post-payment process (redirection in the POST-SALE or ACCEPTURL page)” - 5.4.: “Send an email to the client if the address is available “ - 6.: Yes - 7.1.: Never - 8.: Online (Immediate) - 9.: Automatic authorisation and payment (data capture) on request - Install the extension yellowpay2commerce from TER. - Set the values for the fields yellowpayTestPaymentURL, yellowpayPSPID, yellowpayOrderIDprefix and yellowpayOrderTitle. URL and PSPID are provided by the Postfinance backoffice. Examplex provided by the Extension Manager Configuration. - Set a name, price and translations for the yellowpay payment article in the commerce module. - Test your payment system. - If everything works and you are ready for production, put the production URL into the Extension Manager Configuration field “yellowpayPaymentURL”. .. _Known-problems: Known problems -------------- This extension does not check if the payment was successful or if the order and userdata is valid! Manual checking in the Postfinance Backoffice by the seller is strongly recommended. TYPO3 does not provide the required security level to handle fully trusded payments! .. _To-Do-list: To-Do list ---------- The Postfinance backoffice provides the possibility to configure a lot of things like the layout of the gateway, predefined user and payment settings. Implement some of them in this extension. .. _ChangeLog: ChangeLog --------- 15.12.2008 - Cedric Spindler \* Version 0.0.2 \* the extension now uses currency / language settings from TypoScript settings. \* added extension icon 28.11.2008 - Cedric Spindler \* Version 0.0.1 \* implemented request handling with the yellowpay payment gateway \* added ext\_conft\_template.txt for configuration 30.10.2008 - Cedric Spindler \* Initial release - Version 0.0.0 \* Defined the steps for the orderprocess \* TODO: develop the request handling for communication with yellowpay 10 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 21 .. :hspace: 9 .. :id: Grafik2 .. :name: Grafik2 .. :width: 87 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 157 .. :id: Grafik1 .. :name: Grafik1 .. :width: 436 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 408 .. :id: Grafik3 .. :name: Grafik3 .. :width: 436