README for QuickPay Payment module protocol 10



Please contact kl@blkom.dk for questions, comments, feature requests and professional support.


ACKNOWLEDGEMENT
The QuickPay Standard Payment module was developed by Jakob Høy Biegel. This Module is in parts based
on the code of the QuickPay Standard Module.

QuickPay advanced payment module BETA 2 is developed by Cord Focke Rosted, mailbeez.com

Upgrades of QuickPay advanced payment module BETA 2 to Quickpay Advanced Payment module protocol 6,7 and 10 are made by Kim Løvendahl, kl@blkom.dk 2012/15.


IMPORTANT:
Using this module you acknowledge, that the Author can not be made responsible for any kind of damages, 
errors or problems caused by wrong or correct implementation of this module.


REQUIREMENTS:
You must have the following:
- Oscommerce 2.3 based webshop (might also work with version 2.2, but is not testet...)
- QuickPay Payment manager login (get it here: https://manage.quickpay.net).
- Credit card aquirer agreement. Could be Clearhaus, Nets and/or others. Must be set active in the QuickPay v10 manager.
- PHP version 5
- The php-extension Curl must be installed on your webserver and access to quickpay.net allowed by your web hosting provider (normally this is allowed) in order to use the transaction administration from within oscommerce admin. If you don't have this extension, you can still use
  this module, but will not get the full administration features.
  
  
  
CONFIGURATION NOTES

You can access all necessary settings in the "integration" menu in your version 10 QuickPay manager (https://manage.quickpay.net)



INSTALL INSTRUCTIONS:


#####################################################################################
STEP 0
BACKUP BACKUP BACKUP BACKUP BACKUP and lastly BACKUP

IMPORTANT: Remove previous installations of QuickPay payment module and order total module. If any. This is NOT an upgrade.
For previous users of QuickPay v7: Fees are replaced by the setting of autofee or not in shop admin.
You can manage fees in the v10 QuickPay manager, where you will find extensive help and examples.

#####################################################################################
STEP 1

	*** no need for changes to the DB , everything is handled by installation script***


#####################################################################################
STEP 2

new files:
copy these files and folders to your webshop


	
	callback10.php
	includes/modules/payment/quickpay_advanced.php
    includes/languages/danish/modules/payment/quickpay_advanced.php	
	includes/languages/english/modules/payment/quickpay_advanced.php
	images/icons/
	admin/quickpay10/application_top_quickpay.php
	admin/quickpay10/orders_actions.php
	admin/quickpay10/orders_gui_admin.php
	admin/quickpay10/orders_js.php
	admin/quickpay10/QPConnectorCurl.php
	admin/quickpay10/QPConnectorFactory.php
	admin/quickpay10/QPConnectorInterface.php
	admin/quickpay10/quickpay10.php
	

#####################################################################################
STEP 3 

modified files:
make sure your apply all modifications - marked with "quickpay..."

	checkout_process.php
	checkout_confirmation.php
	
	admin/orders.php
	admin/invoice.php
	admin/includes/classes/order.php
	admin/includes/classes/currencies.php
	admin/includes/languages/danish/orders.php
	admin/includes/languages/danish/invoice.php
	
	admin/includes/languages/english/orders.php
	admin/includes/languages/english/invoice.php
	includes/classes/order.php
	includes/classes/currencies.php
	includes/languages/danish.php
    includes/languages/english.php
    includes/modules/boxes/bm_information.php (adds payment icons)




#####################################################################################
  
#####################################################################################
STEP 4

Go into the Shop Administration->Modules->Payment.
If you have earlier versions of QuickPay installed, note any settings of cardlocks and remove the module.
QuickPay version 10 is not an upgrade and no Quickpay related settings from earlier versions are relevant.
New necessary settings can be found in the new manager application at https://manage.quickpay.net. under the section "integration"

install the module "QuickPay: Online Payment".


#####################################################################################
STEP 5

You can manage the online payment transaction from within the QuickPay manager or in your webshop Administration->Orders