Модулът е предназначен за интеграция в електронен магазин osCommerce. Инсталацията му дава възможност потребителите на вашия електронен магазин, след избора на стоки и услуги, директно да преминат към разплащане през системата на ePay. Модулът можете да свалите от линка поставен на края на тази статия.
Модулът за разплащания през системата на ePay се инсталира, като файловете се разархивират и след това се копират на мястото където е инсталирана osCommerce. В пакетът файловете са подредени в съответните директории, така както трябва да бъдат във вашия хостинг акаунт на сървъра. По този начин при качването на файловете те ще се разпределят по съответните директории на osCommerce. Файловете можете да качите с FTP клиентска програма.
Дървовидна структура на директориите, в които трябва да се разположат файловете, можете да намерите в диаграмата по-долу.
/admin/
/includes
|––– /languages
|––––––-/bulgarian
|–––––––––– orders.php
|––––––-/english
|–––––––––– orders.php
|–––orders.php
/epay/
epay.php
/includes/
/languages
|––––/bulgarian
|––––––––/modules
|–––––––––––/payment
|––––––––––––––- epaybg.php
|––––/english
|–––––––-/modules
|–––––––––––/payment
|––––––––––––––– epaybg.php
/modules/
|–––-/payment
|––––––– epaybg.php
Най-добре е инсталацията да се направи след кирилизация на системата, тъй като презаписва някои файлове. Това се налага поради факта, че се въвежда нова колона за номер на фактура (изисква се от ePay).
След като сте копирали файловете, влезте в администрацията на вашия електронен магазин и от менюто в ляво изберете „Modules / Модули„:
Изберете „Payment trough ePay.BG“ и след това натиснете бутона „Install„:
В случай че администрирате osCommerce на английски език и след инсталацията на модула страницата се зареди с неразпознати символи, сменете енкодинга на вашия браузър с Cyrillic (Windows-1251). Би трябвало след това да видите съдържанието на български език.
Изберете бутона „Edit„:
Попълнете полетата с информацията предоставена ви от ePay. В полето за избор на ePay.BG URL първоначално изберете демо адреса (https://devep2.datamax.bg/ep2/epay2_demo/ ), а след като приключите с конфигурацията го сменете с истинския (https://www.epay.bg/).
В системата на ePay трябва да зададете адрес, към който системата ще се обръща за потвърждаване състоянието на поръчката. След като модулът е инсталиран и конфигуриран адресът е:
http://www.your-domain.com/path-to-oscommmerce/epay/epay.php
т.е., ако директорията в която е разположен е catalog (която се поставя по подразбиране при инсталация на osCommerce), а your-domain.com е myeshop.com, то адресът ще бъде:
http://www.myeshop.com/catalog/epay/epay.php
Пуснете тестова поръчка през вашия електронен магазин и извършете плащане по нея. В случай че всичко е конфигурирано правилно, до 15 минути след извършване на плащането на посочения от вас e-mail адрес ще получите информация за статута на плащането.
Update за нова версия на osCommerce
Ако ползвате версия на osCommerce rcX или 2.2 MS2, трябва да свалите и използвате един от следните файлове. При свалянето на файла е необходимо да съобразите енкодинга на вашия сайт.
Прикрепени файлове: payment_ePay.bg.zip, payment-epay.bg-cp1251-v2.zip, payment-epay.bg-utf8-v2.zip
