.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ================================== EXT: Commerce iDEAL payment module ================================== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed: 2007-10-31T23:09:56 :Author: Michiel Roos :Email: extensions@netcreators.com :Info 3: :Info 4: .. _EXT-Commerce-iDEAL-payment-module: EXT: Commerce iDEAL payment module ================================== Extension Key: **nc\_commerce\_ideal** Copyright 2000-2002, Michiel Roos, 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.com .. _Table-of-Contents: Table of Contents ----------------- **EXT: Commerce iDEAL payment module 1** **Introduction 1** What does it do? 1 Screenshots 1 **Users manual 2** Installation 2 **Configuration 2** Example configuration 2 Reference 2 Security 3 Character set used in transaction 3 **Known problems 4** **To-Do list 4** **Changelog 4** .. _Introduction: Introduction ------------ |img-1| .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ Enable customers to pay for products using the iDEAL payment method. Currently this method is supported by the following banks: - ABN AMRO - Fortis - Postbank - Rabobank - SNS .. _Screenshots: Screenshots ^^^^^^^^^^^ .. _Users-manual: Users manual ------------ .. _Installation: Installation ^^^^^^^^^^^^ Install the extension with the extension manager. .. _Configuration: Configuration ------------- All configuration is done via TypoScript settings. .. _Example-configuration: Example configuration ^^^^^^^^^^^^^^^^^^^^^ This is a TS configuration used in the default setup: :: plugin.tx_commerce_pi3.iDEAL { Privatekey=priv.pem PrivatekeyPass=passwd Privatecert=cert.cer AuthenticationType=SHA1_RSA Certificate0=ideal.cer AcquirerURL=ssl://idealtest.secure-ing.com:443/ideal/iDeal AcquirerTimeout=10 MerchantID=005010700 SubID=0 MerchantReturnURL= Currency=EUR ExpirationPeriod=PT10M Language=nl DESCRIPTION=default description EntranceCode=15674022 LogFile=thinmpi.log } .. _Reference: Reference ^^^^^^^^^ plugin.tx\_commerce\_pi3.iDEAL .. ### BEGIN~OF~TABLE ### .. _: :: "" .. container:: table-row Property :: Privatekey Data type string Description The name of the key file Default priv.pem .. _: :: "" .. container:: table-row Property :: PrivatekeyPass Data type string Description The password for the private key file Default passwd .. _: :: "" .. container:: table-row Property :: Privatecert Data type string Description The name of the private certificate file Default cert.cer .. _: :: "" .. container:: table-row Property :: AuthenticationType Data type string Description The type of authentication used. Do not change this unless you have specific reasons to do so. Default SHA1\_RSA .. _: :: "" .. container:: table-row Property :: Certificate0 Data type string Description Contains the signing certificate of your acquirer. This field should not be changed. Default ideal.cer .. _: :: "" .. container:: table-row Property :: AcquirerURL Data type string Description Address of the iDEAL acquiring server. Use ssl://idealtest.secure-ing.com:443/ideal/iDeal during integration/test Use ssl://ideal.secure-ing.com:443/ideal/iDeal only for production Do not change AcquirerTimeout unless you have specific reasons to do so Default ssl://idealtest.secure-ing.com:443/ideal/iDeal .. _: :: "" .. container:: table-row Property :: AcquirerTimeout Data type int Description Do not change AcquirerTimeout unless you have specific reasons to do so Default 10 .. _: :: "" .. container:: table-row Property :: MerchantID Data type int Description Default MerchantID enables you to test the example demoshop. Your own Merchant ID can be retrieved via the iDEAL Dashboard. Default 005010700 .. _: :: "" .. container:: table-row Property :: SubID Data type int Description Do not change subID unless you have specific reasons to do so. Default 0 .. _merchantReturnURL: merchantReturnURL """"""""""""""""" .. container:: table-row Property merchantReturnURL Data type string Description If true, thumbnails will NOT be made square by 'center cropping' the image.MerchantReturnURL is the URL on your system that the customer is redirected to after the iDEAL payment. This page should carry out the Status Request MerchantReturnURL=http://[yourwebpage]/StatReq.php Default empty .. _: :: "" .. container:: table-row Property :: ExpirationPeriod Data type string Description ExpirationPeriod is the timeframe during which the transaction is allowed to take place Maximum is PT1H (1 hour). Default PT10M .. _: :: "" .. container:: table-row Property :: EntranceCode Data type int Description Used when you do not want to use transaction specific entrance codes. See documentation for more info. Default 15674022 .. _: :: "" .. container:: table-row Property :: Currency Data type string Description Do not change currenty unless you have specific reasons to do so Default EUR .. _: :: "" .. container:: table-row Property :: Language Data type string Description Language is only used for showing errormessages in the prefered language Default nl .. _: :: "" .. container:: table-row Property :: Description Data type string Description Used when you do not want to use transaction specific descriptions. Default 0 .. _: :: "" .. container:: table-row Property :: LogFile Data type string Description Specify an file to log transactions to Default thinmpi.log .. ###### END~OF~TABLE ###### .. _Security: Security ^^^^^^^^ Make sure you protect the directory in which the certificates reside. This can be done for web visitors by setting an .htaccess file with the following contents: :: AuthName "Leave!" AuthType Basic order deny,allow deny from all .. _Character-set-used-in-transaction: Character set used in transaction ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ When setting any of the configuration options that do not denote file paths, please only use characters in the character set described in the following table. Using a character that is not in the table will not result in the rejection of a batch or post, but will result in the translation of the characters to a space, question mark or asterisk. This also holds true for diacritic characters like ǔ, ã, ë, etc. The right most column shows the characters to which these will be translated. .. ### BEGIN~OF~TABLE ### .. _: :: "" .. container:: table-row Used characters :: A to Z Description Uppercase letters **Translation in H** .. _: :: "" .. container:: table-row Used characters :: a to z Description Lowercase letters **Translation in H** A to Z .. _: :: "" .. container:: table-row Used characters :: 0 to 9 Description Numbers **Translation in H** .. _: :: "" .. container:: table-row Used characters :: = Description Equals sign **Translation in H** .. _: :: "" .. container:: table-row Used characters :: Description Space **Translation in H** .. _: :: "" .. container:: table-row Used characters :: % Description Percent **Translation in H** .. _: :: "" .. container:: table-row Used characters :: * Description Asterisk **Translation in H** .. _: :: "" .. container:: table-row Used characters :: + Description Plus **Translation in H** .. _: :: "" .. container:: table-row Used characters :: , Description Comma **Translation in H** .. _: :: "" .. container:: table-row Used characters :: - Description Dash **Translation in H** .. _: :: "" .. container:: table-row Used characters :: . Description Dot **Translation in H** .. _: :: "" .. container:: table-row Used characters :: / Description Slash **Translation in H** .. _: :: "" .. container:: table-row Used characters :: & Description Ampersand **Translation in H** .. _: :: "" .. container:: table-row Used characters :: @ Description At **Translation in H** .. _: :: "" .. container:: table-row Used characters :: “ Description Double quote **Translation in H** \* .. _: :: "" .. container:: table-row Used characters :: ' Description Single quote **Translation in H** \* .. _: :: "" .. container:: table-row Used characters :: : Description Semicolon **Translation in H** \* .. _: :: "" .. container:: table-row Used characters :: ; Description Colon **Translation in H** \* .. _: :: "" .. container:: table-row Used characters :: ? Description Question mark **Translation in H** \* .. _: :: "" .. container:: table-row Used characters :: ( Description Left brace **Translation in H** \* .. _: :: "" .. container:: table-row Used characters :: ) Description Right brace **Translation in H** \* .. _: :: "" .. container:: table-row Used characters :: $ Description Dollar **Translation in H** \* .. ###### END~OF~TABLE ###### .. _Known-problems: Known problems -------------- merchantReturnURL may not contain & character, it should be a clean URI to a path or file. Please let me know if you run into any problems. .. _To-Do-list: To-Do list ---------- - check shipping cost. Is it included in total net? - Should we use the checkExternalData (current setup) or the finishingFunction - build and use hand made entranceCode - move security (certs etc.) to other place (not inside lib/iDeal/secutiry) .. _Changelog: Changelog --------- .. ### BEGIN~OF~TABLE ### .. _0-0-1-ALPHA: 0.0.1 (ALPHA) ^^^^^^^^^^^^^ .. container:: table-row Version 0.0.1 (ALPHA) Changes Initial release Date 29-10-2007 .. ###### END~OF~TABLE ###### |img-2| EXT: Commerce iDEAL payment module - 4 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 100 .. :id: graphics1 .. :name: graphics1 .. :width: 111 .. |img-2| image:: img-2.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102