#################################################################
#                                                               #
#  INSTALLATION GUIDE		                                #
#                                                               #
#  Direct debit (German/Austria),                               #
#  Creditcard, Creditcard 3d Secure,                            #
#  Prepayment, Invoice, Online Transfer, Telefon Payment        #
#  PCI Standard (Credit Card/Austria/German)                    #
#                                                               #
#  These modules are used for real time processing of           #
#  transaction data                                             #
#                                                               #
#  Released under the GNU General Public License                #
#   								#
#			 				  	#
#  This free contribution made by request.                      #
#  If you have found this script usefull a small recommendation #
#  as well as a comment on merchant form would be greatly	#
#  appreciated.							#
#  			                			#
#  Copyright (c) 2010 Novalnet AG                               #
#                                                               #
#################################################################
#					   	   	#
#  SPECIFICATION DETAILS		   	   	#
#					   	   	#
#  Created	     - Novalnet AG         	   	#
#					   	   	#
#  shop Version       7.x	 		   	#
#					   	   	#
#  Novalnet Version   1.1.1			   	#
#					   	   	#
#  Last Updated	     - 14th October 2011	   	#
#					   	   	#
#  Compatibility     - Drupal 7.x-ubercart 3.0		#
#					   	   	#
#  Stability	     - Stable		   	   	#
#				  	   	   	#
#  Categories	     - Payment & Gateways  	   	#
#					   	   	#
#########################################################

-------------------------------------------------------------------------------------------------------

How to install:
Please follow the steps to do bercart Novalnet payment gateway integration:

-------------------------------------------------------------------------------------------------------

- Installations and Configuration -

1. Copy the module folder(uc_novalnet) to "drupal/sites/all/modules/ubercart/payment/".


2. Login as Administer  and click on "Modules" activate Novalnet Payment methods whatever you want by selecting that checkbox.(All payment methods stand for their own so you should activate Novalnet Core module with at least one payment method).
   
3. Login as Administer  click on  Store  Configuration > Novalnet settings) and enter your Novalnet auth code, product id, tariff id, vendor id.

4. Login as Administer  Store  Configuration  Payment settings > Payment methods) and activate Novalnet Payment methods whatever you want by selecting that checkbox.

5. Now Novalnet Payment Modules are ready to Process.

Note*: 
------
1) To include Novalnet Payment Details in customer order email, 

	1.a) If you are using 'customer' template, kindly append below code in customer email template. (This facility already available on 'admin' template, so no need to edit that file)
	
	Customer Template file/path: "\modules\ubercart\uc_order\templates\uc_order-customer.tpl"
		
	Search for the following line "<b><?php echo t('Order Summary:'); ?></b><br>" and place the below code after the searched line.

		<codes>
		
				<?php echo $order_comments; ?>

		</codes>

		
That's all. Your Shop is now Ready for Online Payment.

Note: If you use prepayment and/or Invoice then contact us for more details.

On Any Technical Problems, please contact sales@novalnet.de / 0049-89-923 068 320.

------------------------------------------------------------------------------
Important Notice for Online Transfer (Sofortberweisung):

If you use real transaction data (bank code, bank account number, ect.) real transactions will be performed, even though the test 
mode is on/activated!
-------------------------------------------------------------------------------
If you do not have access to our admin tool "https://admin.novalnet.de" yet, you can perform tests nevertherless by using the 
following TEST data:

I. Parameters (Which are to be entered in the admin interface)
  Novalnet Vendor ID:        4
  Novalnet Vendor Auth-Code: JyEtHUjjbHNJwVztW6JrafIMHQvici
  Novalnet Product ID:       13
  Novalnet Tariff ID:        127

II. Test Bank Data / Test Credit Card Data (Frontend)
  1.  Direct Debit For Germany 
      Bank Account Number: 2411761956
      Bank Code:           30020900

  2.  Direct Debit For Austria
      Bank Account Number: 028121956
      Bank Code:           15090

  3.  Credit Card
      CC No.: 4200000000000000 (14 x 0)
      CVC:    123
      The expiry date must be any date of the future

  4.  Credit Card 3D Secure
      CC No.: 4200000000000000 (14 x 0)
      CVC:    123
      The expiry date must be any date of the future
      PW: tc70174 (If you are requested to enter a password while testing)

  5.  Online Transfer (Sofortberweisung)
      Password: a87ff679a2f3e71d9181a67b7542122c
      Bank Code (if you are asked to enter it on processing your test transaction): 88888888 (8 x 8)
      Every further entry is arbitrary

  6.  PayPal:
      I. These data are to be entered in the admin area like vendor_id, etc. The test_mode must be set to true/1:
      Password: a87ff679a2f3e71d9181a67b7542122c
      Test API-Data
      API-Username: jz_1287157817_biz_api1.novalnet.de
      API-Password: VWALBMU5W6P9WBRC
      API-Signatur: AFcWxV21C7fd0v3bYYYRCpSSRl31AWcKRxnHYdbSH9iWi003HSPk9Ueh

      II. Login then into sandbox by using the follwing login details:
              Website: https://developer.paypal.com/
              login:   jz@novalnet.de
              pw:      novalnet

      III. Test username and password if you are requested to enter them after redirecting to pPayPal payment page:
          username : test_1308209838_pre@novalnet.de
          password : novalnet123
          
      Note : Sandbox login is a must before testing novalnet paypal! 
------------------------------------------------
Test end customer account (If you as end customer are redirected to the Paypal pay page, enter these data, please):
               type: buyer
               login email: jz_1287157420_pre@novalnet.de
               pw: 287157299

Test vendor account (in order to see/view all the transaction data from the end customers):
               type: seller
               login: jz_1287157817_biz@novalnet.de
               pw: 287157756

------------------------------------------------ 


REMARK:

Regarding Prepayment, as the actual money transfer will be made some time later after the end customer makes his order, you have to use the merchant script (integrate it into your Web server and enter the link in the Novalnet Admin Tool (https://admin.novalnet.de; go to Angebote -> Ein Angebot auswhlen -> Stammdaten -> Hndlerskript URL), to which a response will be sent for every transaction by the Novalnet-Server. Here is an example:

test_mode=0&product_id=316&product=Testshop&marker=&payment_type=INVOICE_CREDIT&tid=12112700001500028&currency=EUR&amount=2995&status=100&subs_billing=&tariff_id=582&status_message=erfolgreich&paid_until=&signup_tid=&signup_date=&signup_time=&login=&password=&firstname=xxx&lastname=xxx&street=xxx &house_no=10&zip=12345&city=xxx&email=xxx@xxx.com&birthday=&country=Deutschland&country_code=DE&tid_payment=12112700001429137&reference=&vendor_id=229 

The parameter payment_type=INVOICE_CREDIT means, that the money has been transferred. The parameter tid_payment is referring to the original TID (when the end customer ordered via shop) and the parameter tid implies the subsequent TID (once the end customer has transferred the money to the Novalnet Bank Account). You can sort the original tid by referring to the tid_payment it belongs to. 

CALLBACK SCRIPT:
----------------
The following steps to call callback script ( for Invoice and Prepayment module ).

=> Copy the callback script (callback_novalnet2uebercart3.php) to root folder

Url: (siteurl)/callback_novalnet2uebercart3.php
 
 [[ Ex: http://uebercart.novalnet.de/callback_novalnet2uebercart3.php ]]

Note:
-------
 For testing callback action script, kindly make the follwing changes in callback_novalnet2uebercart.php
 
 1) $callback_test_mode = true; # in line 3
 
 2) vendor_id = 4; #(Shop vendor ID - Ex: 4), in line 34

 3) tid_payment = a real existing Previous TID(when the customer ordered via shop); #in 7

 4) amount = 2500 (in Eurocents. The amount of the order with tid_payment.); #in line 7
 
 5) Set Database Configuration and Email Configurations (lines 26-29; 42-43)
 
 6) Run the callback script

 For real time transactions, kindly do the follwing changes in callback_novalnet2uebercart.php
 
 1) $callback_test_mode = false; # in line 3

 2) vendor_id = your own vendor id; #in line 34

 3) Set Database Configuration and Email Configurations (lines 26-29; 42-43)

 4) Log in as shop administrator and go to: Administer -> Store Administration -> Configuration -> Payment Settings -> Novalnet Prepayment Settings -> Uncheck Test Mode

--------------------------------------------
Freeware-License Agreement
--------------------------------------------

Preamble:
The following agreement governs the rights and responsibilities between you (the "Partner") and the Novalnet AG ("Novalnet") in relation to the cost-free software solutions Service and Support provided by Novalnet, by connecting your e-commerce systems to the payment platform of Novalnet. Services, which Novalnet offers in accordance with a service contract to its partners, are not affected explicitly by this agreement. From this particular agreement, is not explicitly affected the services Novalnet under the contract between the parties to the service contract partners are providing. By installing and using the software, you automatically confirm that you have read this freeware license agreement and agree with it. If you do not agree to these conditions, as a partner, please do not install and use the software.

License
Novalnet grants you a non-exclusive, free of charge right of usage on the payment modules provided by novalnet free of charge and all further modules Novalnet publishes elsewhere whose duration is limited to the duration of the service contract between the parties involved. According to the license agreement, you may install the software on one or more computers and use them. The license for the software is free. The partner agrees to the usage of the payment modules and / or parts of modules exclusively for the Novalnet-provided services, mentioned under the Treaty/agreement. The partner is not entitled to any technical support of any kind from Novalnet. Novalnet is therefore not obliged to ensure the maintenance or revision or development of the software.

Copyright 
All title, ownership rights and intellectual property rights to and from the Software, as well as all copies of the software, and any related documentation, are the property of Novalnet (www.novalnet.de). All rights are reserved. Novalnet reserves legal measures in case of a breach of this Agreement.

Guarantee and Liability
The Payment modules will be explicitly made available "as they are defined". For the correct functioning of the payment modules and / or parts of the payment modules, Novalnet does not provide guarantee. Similarly Novalnet assumes no liability for damages and / or consequential damages, directly or indirectly which can be associated with the use of Novalnet cost-free payment modules, unless the damage is intentional or through gross negligence. Not part of this disclaimer agreement, is damage caused from injury to life or health.

Legal claims and severability clause 
The laws of the Federal Republic of Germany will be applicable. The place for court of law or going to court will be Munich. Should any present or future provision of the Agreement, in whole or in part, become invalid, for reasons other than the   305-310 of the Civil Code (BGB), the validity of the remaining provisions of the agreement will not be affected. The parties shall replace the ineffective, invalid or unenforceable provision by a valid one that will be void in its legal and economic substance, of the ineffective or not feasible provision, and also in compliance with the overall purpose of the agreement. The same applies, if after the conclusion of the agreement, there are gaps or loopholes found in the agreement. The provision of  139 BGB (severability) is totally excluded.

If you need further information, kindly contact our Technical service Team:

Novalnet AG
Tel.: +49 (0)89 9230683-20
Fax: +49(0)89 9230683-11
E-Mail: Technik@novalnet.de

