User Manual Computop Paygate module for Magento
Contents
1. dotSource die ecommerce agentur User Manual www dotsource de c Computop Paygate module for Magento Magento module for the Paygate payment interface By dotSource GmbH Leutragraben 1 07743 Jena Germany Created on Tuesday 06 July 2010 Updated on Tuesday 20 November 2012 A www dotSource de infofadotsource de www handelskraft de www socialcommerce de Gesch ftsf hrer dotSource GmbH fon 49 0 3641 573 34 91 Bankverbindung Christian Otto Gr tsch c o Intershop Tower fax 49 0 3641 573 33 06 Commerz bank Jena Christian Malik Leutragraben 1 Konto 259 99 34 00 07743 Jena BLZ 820 400 00 Deutschland Deutsche Bank Gera Konto 305 80 39 BLZ 820 700 24 Gerichtsstand Amtsgericht Jena HRB 210634 USt IdNr DE246243309 Steuer Nr 161 107 10848 l Versions dotSource die ecommerce agentur www dotsource de bs Date Author Adjustments 06 07 2010 Erik Dommrich initial version 08 07 2010 Erik Dommrich first version 10 08 2010 Erik Dommrich update 16 08 2010 Erik Dommrich update 19 08 2010 Erik Dommrich update 02 09 2010 Christian Bernecker installation procedure 03 09 2010 Christian Bernecker revision 03 09 2010 Erik Dommrich technical details 07 10 2010 Erik Dommrich errror handling 19 10 2010 Erik Dommrich update 09 11 2010 Erik Wohllebe 4 2 added 17 02 2011 Erik Wohllebe new functions added 28 04 2011 Erik Dommri2. Leave empty for open text field Show Middle Name initial No x WEBSITE Always optional Show Suffix No x WEBSITE The suffix that goes after name Jr Sr etc Suffix Dropdown Options WEBSITE Semicolon separated values Put semicolon in the beginning for empty first option Leave empty for open text field Show Date of Birth Required x WEBSITE Show Tax VAT Number No WEBSITE Show Gender No x WEBSITE Figure 19 Date of birth is queried at the checkout The third condition is the querying of the General Terms and Conditions at the checkout These must be configured first and then activated In order to create General Terms and Conditions navigate to Sales gt Terms and Conditions Create a new order condition there The necessary data are queried in the processing template The condition must now also be activated for use in the store front To do this the setting System gt Configuration gt Checkout gt Enable Terms and Conditions must be set to Yes Checkout Checkout Options Enable Onepage Checkout Yes STORE VIEW Allow Guest Checkout Yes s storevem Enable Terms and Conditions Yes STORE VIEW Figure 20 Enable Terms and Conditions If credit rating is active you have the option to configure a Minimum order value for the rating A credit rating is then performed only from the configured shopping cart value upwards A value of 0 00 means that a credit rating
3. please contact your Computop Account Manager Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 8 of 25 amp dotSource die ecommerce agentur www dotsource de 3 Back Office 3 1 Account information You can save your interface data which you have received from your Computop Account Manager in the Global Connection Settings menu in your Magento Back Office under System gt Configuration gt Computop Account These settings are used with each request to Computop or Paygate The settings include the Base URL wherein alternatively https www netkauf de paygate can be used as the default address and https www computop paygate com as an alternative address selectable by drop down menu The alternative address is to be used if the default address is unreachable The Merchant ID is an alphanumeric value issued by Computop enabling the clear identification of your merchant account The Merchant encryption password is used to encode the request the payment request by a blowfish algorithm This prevents the request from simply being intercepted and falsified Since the blowfish algorithm guarantees the reversibility between encoding and decoding the receipt and decoding of the payment request by both Computop and the merchant are ensured In order to provide
4. further security a Hash Message Authentication Code corresponds to the Merchant HMAC option is attached to each request This HMAC is used to check whether the request is authentic and has not been manipulated As with all other connecting settings you will receive your Merchant HMAC from your Computop Account Manager Additionally you have the possibility to specify specific merchant information for credit cards which apply depending on the customer s invoicing country You will also receive these data from your Computop Account Manager PaymentOperator Account Save Config Global Connection Settings A Base URL https www netkauf de paygate zl TORE VIEW Merchant ID dotsourcetest STORE VIEW Merchant Encryption Password eeeeeeeecececcece STORE VIEW MerchantHmaC eeeseeeseccccececesesesececsessn Specific Credit Card Account Information o You can setup specify account Currency Merchant ID Merchant Password Merchant Hmac STORE VIE data for the payment method British Pound Sterlin 9 vj UK Merchant eeeeeeeseeeeese cccccsccecececece Delete credit card If you don t setup any Ll currency the global account Q Add New Merchant settings are used Figure 1 Shows a configuration example Copyright O 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 9 of 25 amp dotSource die ecomm
5. rating In order to improve the error behaviour you have the option to configure alternative payment methods Activate alternative payment methods must be active for this With the configuration of the option Alternative cases you can specify when the alternative payment methods are offered If you have deactivated the Activate alternative payment methods option or if an unselected alternative case occurs all active payment methods will be offered as though credit rating had been deactivated 3 5 1 Credit In the Magento Back Office you have the option to make a credit against an invoice To do this you must first open the invoice for the order which was completed with a Computop payment method In the invoice overview you will find the Credit button on which you must click in order to make a credit against the paid invoice After entering all information press the Refund button The credit is transacted via the Computop Paygate The amount is refunded to the customer s account A successfully completed credit possesses the status Refunded 3 5 2 Cancellation If you cancel an order all amounts from the order that have not yet been refunded and which were transacted via Computop Paygate are refunded to the purchaser s account 3 5 8 Editing an order An existing order can be changed in the order overview via the Edit button In doing so the current order is cancelled and a new order is created in the editing process Th
6. 1 Module functions VC dotSource die ecommerce agentur www dotsource de A bz With its services Computop Paygate offers a broad basis for the support of your business processes for the back office of online offerings The module can be used to offer the checking of addresses and credit ratings as well as the following methods of payment 1 2 1 2 1 Computop Credit Card Computop Direct Debit Computop giropay Computop iDeal Computop Direct Transfer Computop mpass Computop PayPal Computop PayPal Express Computop ClickandBuy Computop Klarna Purchase On Account Computop Klarna Financing Computop BillPay Purchase On Account Computop BillPay Payment By Installments Computop BillPay Direct Debit Requirements Magento versions supported Magento Community Edition o 1 5 0 1 o 1 5 1 0 o 1 6 1 0 o 1 7 0 2 Magento Enterprise Edition o 1 9 0 0 o 1 10 0 2 o 1 12 0 2 Billpay payment methods are only available in marked version Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 4 of 25 dotSource die ecommerce agentur www dotsource de A 1 2 2 Requirements for the operation of the module amp e arunning Magento instance with a Magento version supported by the Computop Paygate module see item 1 2 1 e ordering process in https mode Base URL
7. ch update 09 08 2011 Erik Dommrich update 25 08 2011 Erik Dommrich update 11 10 2012 Bernd Schelter Update 20 11 2012 Uwe Rabe Update Bernd Schelter Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 2 of 25 dotSource die ecommerce agentur www dotsource de A Magento module for the Paygate payment interface CER sed l MICIDUuLIM 2 1 Module functions and requirements ursuussuuannsannsnnnennnunnnunnnunnnunnunnnunnnunnunnnnnnnnnnnnnn 4 1 4 Module f rictlons oido ee ee 4 1 2 Redg lremients ee een etre bed nen aE aaa Eaa del Dre ERE 4 1 2 1 Magento versions supported ssssssssssssseseeeeeeneeneenennnene 4 1 2 2 Requirements for the operation of the module sessssssssss 5 1 3 l echinical details uini ee einen 5 2 Module installation i ecco rera ceice eroe a a ie 8 2 1 Magento shop system sesssssssssssseeeeeeeen nenne nnne nnne rnnt nnne nnne nnne 8 2 2 Computop merchant account scssi esc esto s osa ek den eL ec a La Da ERU 8 3 Bak Offi 9 3 1 AACCOUMTINTONIMALION pe M 9 3 2 Merchant information for d
8. chnungsadresse All possible error codes and their descriptions are listed separately in the errors xml file in the backend element Please contact Computop if you wish to obtain a current list of the error codes Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 23 of 25 dotSource die ecommerce agentur www dotsource de 5 2 Error analysis amp Under certain circumstances errors can occur when installing the module Below you can find a few tips for carrying out an error analysis yourself 5 2 1 Revision The revision number provides you with the possibility to check the versions of the Computop module The revision number can be found in the Magento Back Office in the Configuration section under System The System entry can be found in the left hand menu under the Advanced heading There you will find the Revision entry from which you can take the current revision number 5 2 24 Debug mode log function This function creates a log file in which the data regarding the requests and responses of the module are collected This file is needed for the evaluation and analysis of errors The function is not to be used during operation It is important to activate Magento s own log function before use Back office System gt Configuration gt Advanced gt Devel
9. ddress verification is needed This can be set under System gt Configuration gt Computop Risk Management gt Address Verification PaymentOperator Riskmanagement Address check Enabled Yes x storevem Risk Management can only be activated if Address Management is also activated On undefined error lock customer No STORE VIEW in billing step This options is used if an error code is not specified in the errors xml Figure 18 Activation settings for address verification The second condition for a credit rating is the querying of the date of birth This must be acquired as a compulsory parameter This applies both to guests and to registered users Copyright O 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 17 of 25 amp dotSource die ecommerce agentur www dotsource de The corresponding setting can be found in the Magento Back Office under System g Configuration gt Customer Configuration gt Name and Address Options gt Show Date of Birth The selection must be set to Required Number of Lines in a Street 2 WEBSITE Address Leave empty for default 2 Valid range 1 4 Show Prefix Required x WEBSITE The title that goes before name Mr Mrs etc Prefix Dropdown Options MMs WEBSITE Semicolon separated values Put semicolon in the beginning for empty first option
10. dress Here you can choose if you allow unequal addresses for billing and shipping Default is No because Billpay doesn t support this at the moment Minimum Order Total If the order amount is beneath this Billpay will not be shown as available payment method Keep in mind that the amount configured here has to be the same as the one by Billpay Computop Otherwise a error will occur at the checkout process Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 15 of 25 dotSource die ecommerce agentur www dotsource de Company Legal Form allows to adjust or to add more company legal forms to the LOV in the checkout Be aware that you can only use keys which are supported by Billpay BILLPAY PaymentOperator Billpay Purchase On Account Salutation Firma Company Name Company Legal Form Please select Ihave read and accept the terms and conditions and the privacy policy of Billpay GmbH Abbildung 15 Firmenrechtsform im Checkout Key Company Legal Form gmbh GmbH misc Miscellaneous Abbildung 16 Firmenrechtsform konfigurieren im Backoffice Ge At the moment Billpay supports the predefined keys already set u 3 4 Address verification The address verification provides you with the possibility to check customer addresses for correctness du
11. e new order cannot use any of the Computop Paygate payment methods because it is created in the Back Office The order to be changed is cancelled and goes through the same process as if it had been manually cancelled see 3 5 2 3 5 4 Creating a new order If an order is to be created via the Back Office no Computop Paygate payment method can be selected Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 20 of 25 dotSource die ecommerce agentur www dotsource de 4 Store Front 4 1 Payment In the ordering process distinction must be made between two payment variants on the one hand a payment via a server to server connection and on the other via a paygate In the case of a server to server connection the data must be entered in the shop In the case of a paygate payment the customer is taken to the payment page at the end of the ordering process and the payment process takes place in this paygate If payment is made during the ordering process by means of a Computop payment method that uses a server to server connection and Instant charge is selected as the payment method the order is given the status Processing In the case of Charge on delivery the order is given the status Ready for Computop capture In the case of paygate payment methods the logic is different When the customer is taken
12. erce agentur www dotsource de 3 2 Merchant information for different Magento stores websites Magento offers the possibility to define different configurations for different stores or websites As standard the settings are made in the Default Config Current Configuration Scope PaymentOperator Account Default Config ze Manage Stores Global Connection Settings Configuration Base URL https Avww netkauf de paygate x GENERAL Merchant ID dotsourcetest General Merchant Encryption Password eeccccccccccescs Web Merchant Hmac e0000000000000000000000000000006 Design Figure 2 Configuration of a Computop account in the Default Config If for example you need a different configuration for a shop or a web page simply switch to the store or website that you wish to configure using the store switcher located at the top left in your Magento Back Office Current Configuration Scope PaymentOperator Account Default Config Global Connection Settings Main Main Website Store E C Default Store View Base URL hitps www netkauf de paygate STORE VIE gt GENERAL Merchant ID dotsourcetest STORE VIEW General Merchant Encryption Password I STORE VIEW Web Merchant Hmac 00000000000000000000000000000000 STORE VIEW Design Currency Setup z Specific Credit Card Account Information Figure 3 Special Computop account configuration for another store 3 3 Payment 3 3 1 Payment options All sett
13. ifferent Magento stores websites 10 3 3 Payment naar mare ER in nl 10 3 3 1 Payment Optlons cL 10 3 3 2 Capturing authorised orders 15 3 3 3 Billpay o tions u ee ee 15 3 4 Address verification ou s4044440nnnannnnnnnnnnnnnnnonnnnnnnnnnnnnnnnnnnnnarnnnnnnonarnnnnnonarnnnnnnennn 16 3 5 Credit rating aus scien een ahnen 17 3 5 1 OK cele eee M FEIEFIE Deore 20 3 5 2 G ncellat OM p UM 20 3 5 3 Editing an Ord6r eerte tt aa a ei ean ea raae erake iniaeeaa 20 3 5 4 Creating a new order nennen 20 4 Stn 21 Ko 1 He 21 CNEEMELCIUNMIUEMEI ER 21 5 Error handling Ice ertet eerte trece cete e button eese recuso Cer bocan een 22 5 1 Error meSsage Settings u oaee eed ede a geared RD neers 22 5 2 ziii SIUE MM EH 24 5 2 1 PROVISION LE 24 5 2 2 Debug mode log function sesssseeeeeeeneneennenneen nennen 24 5 2 3 Database P T 25 5 2 4 Account problems sssssssssseeeseeneenn nennen nnne nnne nennen ennt nere n nenne 25 Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 3 of 25 1 Module functions and requirements 1
14. illpay salutation o billpay company name o billpay dob o billpay company legal form o billpay eft owner o billpay eft ban enc o billpay eft ban4 o billpay eft bcn o billpay term o billpay receiver owner o billpay receiver ban enc o billpay receiver bcn o billpay receiver bank name o billpay receiver invoice ref o bhillpay receiver invoice date o billpay payment plan o billpay transaction id e customer o paymentoperator risk check computop risk check prior to version 1 7 1 12 e quote address o paymentoperator checked address hash computop checked address hash prior to version 1 7 1 12 e customer address o paymetoperator checked address hash computop checked address hash bei Modulen prior to version 1 7 1 12 e Order address o paymetoperator checked address hash computop checked address hash prior to version 1 7 1 12 Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 7 of 25 dotSource die ecommerce agentur www dotsource de 2 Module installation Appropriate Magento know how is necessary for the installation of the module Moreover please integrate the module with your Magento installation on a test system and test it before using the module for the first time 2 1 Magento shop system The module is installed either via Magento Connect
15. imata sanctus est Lorem ipsum dolor sit amet Lorem ipsum dolor sit amet consetetur sadipscing elitr sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat sed diam voluptua At vero eos et accusam et justo duo dolores et ea rebum Stet clita kasd gubergren Hiermit stimme ich den AGB zu P Figure 21 Shows the order process with the option When displaying the payment methods If the rating is to be performed only when dispatching the order and it turns out that the payment method cannot be offered to the customer the customer is returned to the payment step with an error message and is shown only those payment methods configured for his creditworthiness value The credit agencies are the suppliers that are contacted for a credit rating enquiry Depending on the return value the customer s creditworthiness may fall in the categories green yellow and red If the customer is evaluated with green all active Magento payment methods are offered to him In the case of the creditworthiness values yellow and red the payment methods configured in Back Office are offered Copyright O 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 19 of 25 e dotSource die ecommerce agentur www dotsource de However it is also possible for an unknown error to occur during the credit
16. in the invoicing address Payment from Applicable Specific Countries STORE VIEW Countries Payment from Specific Countries U S Virgin Islands la STORE VEW Uganda Ukraine United Arab Emirates United Kingdom United States Uruguay Uzbekistan Vanuatu Vatican City Figure 6 Setting options payment methods 3 PaymentOperator Credit Card offers the additional option to allow or refuse payments from certain countries by checking which country the credit card is registered in In addition PaymentOperator Credit Card and PaymentOperator Direct Debit have the option to include or exclude certain IP zones This function will be offered by Computop for the PaymentOperator Direct Debit payment method in the near future At present it is available only for PaymentOperator Credit Card Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 11 of 25 dotSource die ecommerce agentur www dotsource de These three possibilities serve to prevent fraud Allow Restrict countries Allow any countries STORE VIEW a TUINS amu carmcus iSramus Choose allowed restricted countries STORE VIEW Tuvalu U S Minor Outlying Islands U S Virgin Islands Uganda Ukraine United Arab Emirates United Kingdom United States Uruguay Lithakictan ls Le Allow IP zones Allow
17. in the secure area under Magento Back Office System gt Configuration gt Web gt Secure must begin with https e appropriate access data Base URL Merchant ID Merchant encryption password and Merchant HMAC which you receive from your respective Computop Account Manager see items 3 2 and 4 1 e an Internet connection must be available in order to send requests to the Computop Paygate and to receive replies regarding order completion C e To use Billpay you have to configure salutation as a mandatory field See Magento A Backoffice System gt Configuration Customer Configuration gt Name and Adress Options gt Show Prefix 1 3 Technical details The following Magento classes and templates are updated e Blocks o Mage Adminhtml Block Sales Order View o Mage Adminhtml Block Sales Order Grid o Mage Paypal Block Adminhtml System Config Fieldset Hint o Mage Checkout Block Onepage Payment Methods o Mage Checkout Block Onepage Billing o Mage Sales Block Order Totals o Mage Sales Block Order Invoice Totals e Models o Mage_Sales_Model_Order_Payment e Templates o checkout onepage billing phtml o checkout onepage shipping phtml o checkout onepage agreements phtml o checkout onepage payment methods phtml Two tables are created in the appropriate Magento database e paymentoperator transaction computop transaction prior to version 1 7 1 12 e paymentoperator action computop action pri
18. ing options for the payment methods can be found in the Back Office under System gt Configuration gt Payment Methods As is usual for Magento payment methods you can decide whether to activate or deactivate a payment method The Title field gives the payment method a name for the ordering process For most Computop payment methods there are additionally one to maximally two individually configurable purposes of use These are transmitted to Computop and are visible to the customer e g on a statement of account Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 10 of 25 G eX dotSource die ecommerce agentur www dotsource de Payment Methods PaymentOperator Credit Card PaymentGate Enabled Yes x STORE VIEW Title Credit Card by Computop STORE VIEW Reference any kind of information you like STORE VIEW Maximum length is 756 Attention some special characters will deleted automatically Figure 4 Setting options payment methods 1 An order can also be specified for the payment methods in the ordering process Sort order STORE VIEW Figure 5 Setting options payment methods 2 Among other things you can set the PaymentOperator Credit Card payment method so that it is available only to purchasers from certain countries This is checked on the basis of the country shown
19. ion is used error code 0053 gt Example 3 If you wish to provide several error codes with a description the error codes can be recorded in a code attribute separated by spaces If an error code is declared individually and as a list in the code tag the error tag of the individual declaration is preferred The error 0001 is declared in Example 1 and in this example If this error occurs the description from Example 1 is output The error tag with only one error code in the code attribute is regarded as more specific since it possesses only one error code in the code attribute lt error code 0001 0002 0053 gt There is an error lt error gt Example 4 In order to be able to handle an error message more specifically the callback attribute can be used This attribute can be used to execute PHP functionality on occurrence of the error In the example the clearQuotePayment method from the Dotsource_Clickpay_Model_Error_Observer class is called if the error 0306 occurs lt error callback computop error_observer clearQuotePayment code 0306 gt Reserved lt error gt Example 5 You can also write the error description in English If a translation of the description in German is desired then the English description and the German translation can be stored in the Dotsource_Computop csv file in the app locale de DE folder in the main Magento directory Use the following format for this Billing Address Re
20. is always performed Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 18 of 25 dotSource die ecommerce agentur www dotsource de The field Renew after expects a value in days Following the expiry of the validity of a rating a new customer credit rating is performed if this is required The time for the credit rating can be set under the option Credit rating time On the one hand a rating can be performed before displaying the payment methods option When displaying payment methods or only when the order is dispatched option When dispatching order If the credit rating is to be performed when displaying the payment methods the Terms and Conditions must be confirmed beforehand These are then masked out in the final ordering step Checkout E Payment Information Lorem ipsum dolor sit amet consetetur sadipscing elitr sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat sed diam voluptua At vero eos et accusam et justo duo dolores et ea rebum Stet clita kasd gubergren no sea takimata sanctus est Lorem ipsum dolor sit amet Lorem ipsum dolor sit amet consetetur sadipscing elitr sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat sed diam voluptua At vero eos et accusam et justo duo dolores et ea rebum Stet clita kasd gubergren no sea tak
21. mputop_setup entry in the core_resource table This number provides information on the last executed installation script Always indicate the version number with error messages In order to re install the tables delete the computop setup entry from the core ressource table Once this has taken place Magento attempts to carry out the installation again Following this procedure check whether the Computop tables are present 5 2 4 Account problems It is known that parameters other than those required by the Paygate module are transferred from Computop accounts created before the year 2004 This can be determined by logging the payment procedure and evaluating the log file The error can be rectified by having the account updated by Computop Please contact Computop support for this Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 25 of 25 e
22. oper gt Log Settings The activation should be carried out only by an administrator or a developer The following actions are required in order to activate the log function e add the line SetEnv COMPUTOP DEMO MODE 1 to the VirtualHost entries that concern the Magento installation or e add the line Mage register computopDemoMode true to the index php file which is located in the main Magento directory When doing so care must be taken that the line in the index php file is written above the last entry Mage run mageRunCode mageRunType Otherwise the debug mode will not be activated The function is deactivated by deleting these entries again or by commenting them out The entry in the VirtualHost requires a restart of the server After activation the Magento cache is to be emptied in order to avoid errors The log file itself can be found in the main Magento directory under var logs computop connection log Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 24 of 25 dotSource die ecommerce agentur www dotsource de 5 2 8 Database amp Check whether the following tables exist in your Magento database e computop_transaction e computop_action If these tables are missing there was a problem during the installation In order to retrace this check the version number of the co
23. or from a Zip file which you have received from us To install the module by means of the Zip file unpack the file to a temporary directory After that adapt the unpacked files to the group and user access rights and adapt the folder write rights to the current revision level of your Magento installation Then copy the extracted directories app skin etc to your main Magento directory In the next step delete the complete Magento cache This is located in your main Magento directory in the var directory Now delete the entire contents of the Magento cache folder var cache Log off from the Back Office of your Magento Store and then log in again in order to update the rights administration for the Back Office user Now save your merchant information see the following chapter 2 2 Computop merchant account The XSLT Template directory which is located in the main directory of the shop system after the installation contains a template design for the Computop Credit Card payment method This can be used as the basis for the adaptation of designs to the corresponding Magento Shop Please note that in the file names dotsourcetest paySSL xml and dotsourcetest paySSL xsl as well as in the directory name imagesdotsourcetest the placeholder dotsourcetest must be replaced by your own merchant account Merchant ID The template is used only if this is configured in the Back Office If you have any further questions
24. or to version 1 7 1 12 Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 5 of 25 Additionally EAV entities or tables were extended dotSource die ecommerce agentur www dotsource de c e order payment o o o paymentoperator transaction id computop transaction id prior to version 1 7 1 12 eft owner eft ban enc eft ban4 eft bcn klarna dob klarna gender klarna_ssn klarna_annual_salary billpay_salutation billoay company name billpay dob billpay company legal form billpay eft owner billpay eft ban enc billpay eft ban4 billpay eft bcn billpay term billpay receiver owner billpay receiver ban enc billpay receiver bcn billpay receiver bank name billpay receiver invoice ref billpay receiver invoice date billoay payment plan billpay transaction id e quote payment o o o o paymentoperator transaction id computop transaction id prior to version 1 7 1 12 eft owner eft ban enc eft ban4 Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 6 of 25 e dotSource die ecommerce agentur www dotsource de o eft_ben c o cc prefill information o klarna dob o klarna gender o klarna ssn o klarna annual salary o b
25. r to make partial deliveries the capture time must be set to Charge on delivery The result of this is that the payments are initially only authorised and are only captured when a delivery takes place Partial deliveries are captured by dispatching only a part of the goods The remainder remains authorised and must be captured within a time limit as long as authorisation exists by dispatching the remainder of the goods The length of this time limit depends on the credit card provider Advanced transaction Yes STORE VIEW management Use Pseudo Credit Card STORE VIE Information Figure 14 Setting options payment methods 11 Copyright O 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 14 of 25 N G amp dotSource die ecommerce agentur www dotsource de The payment methods PaymentOperator Direct Debit PaymentOperator giropay and PaymentOperator mpass can be used only by customers from Germany PaymentOperator Direct Transfer can be used only by customers from Germany Austria Switzerland Belgium the Netherlands and Great Britain The PaymentOperator ClickandBuy payment method is offered in the countries with the following country codes DE AL DK EN FR IT JP NL NO PL PT RU TR SP SE and CZ In the case of the payment methods PaymentOperator Klarna Purchase On Acco
26. ring the ordering process and to have them corrected automatically if necessary The configuration can be found in the Back Office under System gt Configuration gt Computop Risk Management Copyright O 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 16 of 25 dotSource die ecommerce agentur www dotsource de Address check gt Enabled STORE VIEW g Management is also activated On undefined error lock customer No STORE VIEW in billing step This options is used if an error code is not specified in the errors xml Figure 17 Configuration option in the Back Office Firstly the address verification can be activated here This setting affects the credit rating because a Credit rating can only be performed if address verification is also active In addition you can configure what should happen in the case of an unconfigured error whether the customer can pass the invoicing step in the ordering process with an invalid address or not If necessary unconfigured errors can be extended in errors xml section 6 1 or their handling can be adapted 3 5 Credit rating Like the address verification the credit rating can be found under System gt Configuration gt Computop Risk Management Three conditions must be satisfied in order to be able to use the credit rating Firstly an activated a
27. ront are to be placed inside the errorhandling default frontend element General Back Office error messages are to be described in the errorhandling default backend element In addition it is possible to specify error messages separately for each payment method as well as for the address verification and credit rating For example by using the XML path errorhandling cc_computop frontend or errorhandling cc_computop backend for the Computop Credit Card payment method In general note that the word default in errorhandling default frontend or in errorhandling default backend must be replaced by the corresponding code for the payment method Example 1 If a description is to be assigned to an individual error then the code number of the error is to be stored together with the description of the desired element For the declaration only digits 5 to 8 of the 8 digit error code are used error code 0001 gt The PayID parameter is causing the problem lt error gt Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 22 of 25 dotSource die ecommerce agentur www dotsource de Example 2 If an error code is declared several times the error tag that is higher up is used If the error code is to be declared but a description is not to be assigned to it the following construct
28. specific ip zones STORE VIEW IP Zones 276 STORE VIEW Figure 7 Setting options payment methods 4 As a further option you can set for PaymentOperator Credit Card whether you wish to use an XSLT template for the input of the credit card data after the checkout process Use XSLT Template Yes STORE VIEW Template name of your specific template STORE VIEW Figure 8 Setting options payment methods 5 The Logos option for the PaymentOperator Credit Card payment method enables you to specify which credit cards logos are to be displayed in the online shop checkout process under the Payment information option The logos for Dankort and Carte Bleue Nationale are only displayed if Denmark or France respectively is set as the invoicing country Copyright O 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 12 of 25 Ge dotSource die ecommerce agentur www dotsource de Logos Visa STORE VIEW MasterCard ETS fe American Express Dankort Carte Bleue Nationale JCB ie Figure 9 Setting options payment methods 6 For the payment methods PaymentOperator Credit Card PaymentOperator Direct Debit PaymentOperator mpass PaymentOperator PayPal and PaymentOperator PayPal Express you can specify whether the amount is only authorised during the ordering process and capt
29. tion capture method conversely reserves the invoice amount directly after the order is dispatched Capture is possible within 3 days Payment moment d STORE VIEW R Debit on Delivery TOM Payment Action Immediate payment STORE VIEW Figure 12 Setting options payment methods 9 The payment methods PaymentOperator Credit Card PaymentOperator giropay and PaymentOperator Direct Transfer additionally offer the Prepopulate payment information option The Use pseudo credit card data option must be activated for the PaymentOperator Credit Card payment method Therefore if the customer has already made a payment using these payment methods and the option is active his data will be saved and pre populated if the respective payment method is used again In the case of PaymentOperator giropay the Bank Sort code validation setting offers the additional option to validate the bank sort code specified by the customer Bank Code Number Available Yes STORE VIEW Check Pre Fill Payment Information Yes x STORE VIEW Figure 13 Setting options payment methods 10 The extended transaction management ETM and the Use pseudo credit card data option for the PaymentOperator Credit Card payment method must be active in order to render partial invoices If they are deactivated and a capture is made with a lower value than the actual order value the remaining amount is lost and cannot be captured In orde
30. to the paygate the order has the status Waiting for confirmation of capture Instant charge payment method or Waiting for confirmation of authorisation Charge on delivery payment method If the customer aborts the payment procedure he is taken back to the first ordering step The order is automatically cancelled at the same time If the payment fails in the paygate the customer is taken to the shopping cart and receives an error message see section 6 0 If payment is successful the customer is taken to the Success page The order then has either the Processing status Instant charge payment method or the Ready for Computop capture status Charge on delivery payment method In addition each change in the order is attached to the order with a comment Copyright 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 21 of 25 dotSource die ecommerce agentur www dotsource de 5 Error handling 5 1 Error message settings It is possible for the shop operator to provide all errors that could occur during communication with Computop with his own error descriptions which are then displayed if the error occurs The errors are described by editing the errors xml file in the app code community Dotsource Computop etc folder in the main Magento directory General error descriptions for Store F
31. unt and PaymentOperator Klarna Financing an invoice type must be selected before use Additionally in the case of PaymentOperator Klarna Financing a financing code must be entered which you can find in the Klarna Back Office 3 8 2 Capturing authorised orders Orders can be captured via the Back Office in the order overview Orders that can be captured possess the status Ready for PaymentOperator capture For example you can filter for this status and mark the filtered orders The selected authorised orders are captured via the mass action CT render invoice An authorisation can also be captured when you render an invoice Partial captures are possible only with Computop Credit Card with active extended transaction management or use pseudo credit card data 3 3 2 1 Rendering activating a Klarna invoice For the Klarna payment methods no invoices can be rendered in order to capture an amount An invoice is automatically rendered and activated at Klarna if a delivery is created An order that is ready for dispatch possesses the order status Klarna Ready for dispatch 3 3 3 Billpay options In general options configured in the modul has to be equal to the settings which ares provided by Computop and Billpay Payments by Billpay offer some additional Billpay specific options Option Payment Delay offers you to enhance the Billpay standard due date Option Allow a unequal address as billing and shipping ad
32. ured after manual confirmation of the delivery in the Magento Back Office by means of the Charge on delivery option or automatically captured after the purchase by means of the Instant charge option Payment moment STORE VIEW Debi ivery E E Debit in x hours Immediate payment STORE VEW Debit in x hours SE Figure 10 Setting options payment methods 7 With PaymentOperator Credit Card PaymentOperator Direct Debit and PaymentOperator mpass you can additionally select whether the amount should be automatically captured after a certain number of hours Payment moment Debit in x hours STORE VIEW Debit in x hours lt hours gt STORE VIEW Figure 11 Setting options payment methods 8 In the case of the Charge on delivery capture time for the PaymentOperator PayPal Express payment method you can additionally choose between the capture methods Order and Authorisation wherein if order is set the PayPal account is only checked and confirmed but the amount is not reserved As soon as the capture is made the amount is then also reserved and captured at the same time The capture must be made Copyright O 2011 dotSource GmbH All rights reserved Designated brand names are brand names of the respective owner Subject to change without prior notice Page 13 of 25 G amp dotSource die ecommerce agentur www dotsource de within 365 days The Authorisa
Download Pdf Manuals
Related Search