Готови модули за CMS

Ако за сайта си използвате една от изброените по-долу системи за управление на съдържанието (CMS), то предлагаме да разгледате възможността за използване на специални платежни плъгини, които са подготвени специално, за да започнете да приемате плащания възможно най-бързо.
Просто изберете плъгин за нужната CMS и следвайте инструкцията за инсталация.

• WordPress
• Magento
• Joomla!
• Drupal
• OpenCart
• CS-Cart
• PrestaShop
• Shopify

WordPress

С този плагин за WordPress вашите клиенти ще могат да правят покупки чрез нашата платежна страница.

За да работи този плагин, необходимо е да инсталирате WooCommerce за WordPress. Този плагин беше тестван със следните версии на WordPress и WooCommerce (вж. таблицата по-долу).

Препоръчителна версия WordPress: не по-стара от 4.8.3. За това ръководство бяха използвани следните компоненти и версии:

• WordPress 4.7.3
• WooCommerce 3.0

Можете да изтеглите необходимата версия WooCommerce от github.com (връзка към историята на версиите на WooCommerce).

Препоръчваме да се запознаете със следната документация за WordPress и WooCommerce:

• WordPress;
• WooCommerce.

WooCommerce не е съвместим с всички теми на WordPress. В този документ използваме темата Storefront (външна връзка), създадена от разработчиците на WooCommerce.

Инсталация

1. Влезте в своя административен панел.
2. От лявата панел изберете Плагини > Добави нов (вж. фигурата по-долу).
   
   Ще се отвори страницата Добави плагини.
3. Натиснете Качи плагин в горната част на страницата.
4. Изберете файла с плагина, който изтеглихте по-рано, и натиснете Инсталирай.
5. След завършване на инсталацията, от лявата панел изберете Плагини > Инсталирани (вж. фигурата по-долу).
   
   
6. В раздела WooCommerce натиснете Активирай.

Настройка

За да настроите платежния плагин за WordPress, направете следното.

1. Влезте в своя административен панел.
2. От лявата панел изберете Плагини > Инсталирани (вж. фигурата по-долу).
   
   
3. В раздела WooCommerce натиснете Настройки.
   Ще се покаже следната страница.
   
   
4. Задайте настройките, ръководейки се от таблицата по-долу.

Настройка на бързи методи на плащане

След раздела на основни настройки е представен раздел Payment Widget settings с настройки за плащания Google Pay и Apple Pay:

Ограничения:

• Достъпно за плъгин версия 5.5.0 и по-висока;
• За правилна работа се изисква WooCommerce версия 9.0 и по-висока;
• За работа с Apple Pay е необходимо да регистрирате домейн в Платежния шлюз с верификация в Apple Services. Това може да се направи в раздел Бързи бутони в Портала на търговеца.

Задайте настройките, ръководейки се от таблицата по-долу

Можете да стилизирате показването на бутоните в зависимост от вашата тема, използвайки следния код:

apple-pay-button {
    // styles for Apple Pay button
}

.gpay-button {
    // styles for Google Pay button
}

Натиснете Запази промените.
В областта на известяванията ще се показва Вашите настройки са запазени. Сега можете да приемате плащания.

Magento

С този плъгин за Magento вашите клиенти ще могат да извършват покупки чрез нашата платежна страница.

Стабилна работа на плъгина е гарантирана за следните версии на Magento. Ако използвате други версии (например, след актуализация), плъгинът може да работи некоректно.

Инсталиране

За да инсталирате платежния плъгин за Magento, изпълнете следните действия.

1. Разархивирайте архива на плъгина и качете съдържанието на папка upload на вашия сайт. Получената пътека ще бъде: <your site>/app/code/BPC/BPC/<plugin files and folders>.
2. Свържете се към вашия сайт с помощта на интерфейс на командния ред, например, чрез утилитата PuTTY.
3. В зависимост от типа на вашия хостинг изпълнете следните команди (вж. таблицата по-долу).

Инсталирането е завършено — преминете към настройка на плъгина.

За да премахнете плъгина, изпълнете процедурата за премахване.

Настройка

За да настроите платежния плъгин за Magento, изпълнете следните действия.

1. Влезте в административния си панел на Magento.
2. В менюто вляво изберете Stores > Configuration (вж. фигурата по-долу).
   
   
3. В менюто на страницата изберете Sales > Payment Methods (вж. фигурата по-долу).
   
4. На показаната страница в раздел Other Payment Methods преминете към точка Direct payment with credit/debit card (BPC) (вж. фигурата по-долу).
   
5. Натиснете , за да видите списъка с настройки на плъгина (вж. фиг. по-долу).
   
   
   
6. Задайте настройките, ръководейки се от таблицата по-долу.
   

Кликнете Save Config.

Премахване

За да премахнете платежния плъгин за Magento, изпълнете следните действия.

1. Свържете се към вашия сайт с помощта на интерфейс на командния ред, например чрез утилитата PuTTY.
2. В зависимост от типа на вашия хостинг изпълнете следните команди (вижте таблицата по-долу).

Премахнете файловете и папките на плъгините от вашия сайт: app/code/BPC/.

Joomla!

Joomla! и JoomShopping

С този плъгин за Joomla вашите клиенти ще могат да правят покупки чрез нашата платежна страница. Този плъгин изисква инсталирано разширение JoomShopping в Joomla!.

Стабилната работа на плъгина е гарантирана за следните версии на Joomla! и разширения. Ако използвате други версии (например след актуализиране на Joomla!), плъгинът може да работи некоректно.

Инсталиране

За да инсталирате плъгина, извършете следните действия.

1. Влезте в административния панел на Joomla.
   

2. В менюто отляво изберете Компоненти > JoomShopping > Инсталиране и обновяване.
   

   
   

3. В секцията Качете файл на пакет кликнете върху бутона Преглед/Browse, посочете пътя към файла на платежния плъгин. След това натиснете Качи.
   

   
   

Изчакайте завършването на качването и появяването на съобщението "Операцията завърши".

Настройка

За да настроите плъгина, извършете следните действия.

1. Влезте в административния панел на Joomla.
   

2. Отидете в Компоненти > JoomShopping > Опции и изберете Плащане.
   

   
   
   

3. Ще се покаже страницата Плащане със списък на платежните решения. Кликнете върху името на плъгина radar-DSK.

4. Ще се отвори страницата за конфигуриране на плъгина. Раздел Главен съдържа общите настройки на плъгина. Тук можете да зададете названието на начина на плащане, което клиентът ще види при създаване на поръчка, в полето Наименование.

Раздел Конфигурация съдържа параметрите за свързване.

5. Настройте плъгина (вижте таблицата по-долу) и натиснете Запази и затвори отгоре.

Joomla! и VirtueMart

С този плъгин за Joomla вашите клиенти ще могат да извършват покупки чрез нашата платежна страница. Този плъгин изисква инсталирано разширение VirtueMart в Joomla!. Стабилната работа на плъгина е гарантирана за следните версии на Joomla! и разширения. Ако използвате други версии (например, след актуализиране на Joomla!), плъгинът може да работи некоректно.

Инсталация

1. Влезте в административния панел на Joomla.
   

2. В горното меню изберете Разширения > Мениджър на разширения > Инсталация.
   

   
   

3. На отворената страница натиснете Или изберете файл, за да намерите файла на плъгина, или плъзнете файла за качване. След това натиснете Качи и инсталирай.
   

   
   

Изчакайте завършване на качването и появяването на съобщението "Инсталацията на плъгина успешно завърши".

4. В горното меню изберете Разширения > Мениджър на разширения > Управление.
   

   
   

5. В показания списък намерете в списъка пункта VM Payment - radar-DSK и натиснете Включи.

6. В горното меню изберете Virtuemart -> Payment Methods (Способи за плащане).
   

   
   

7. Ще се отвори списък със способи за плащане. Натиснете New (Създай) отгоре, за да създадете нов способ за плащане.
   

   
   

8. В отворения прозорец Payment Method настройте параметрите на новия способ за плащане. В полето Payment Method изберете VM Payment - radar-DSK Module.

Настройка

За да настроите плъгина, изпълнете следните действия.

1. Влезте в административния панел на Joomla.
   

2. Отидете в VirtueMart > Payment Methods.
   

3. В списъка със способи за плащане щракнете върху името на способа за плащане, в който се използва плъгинът radar-DSK . Ще се отвори страницата за конфигурация.

4. Настройте плъгина (вижте таблицата по-долу) и натиснете Save отгоре.

Drupal

С този плъгин за Drupal вашите клиенти ще могат да правят покупки чрез нашата платежна страница. За работата на този плъгин трябва да бъде инсталиран модулът Drupal Commerce.

За този плъгин са необходими следните версии на Drupal и Drupal Commerce.

Инсталация

За да инсталирате плъгина, изпълнете следните действия.

1. В горното меню изберете Управление > Разширения и натиснете Инсталиране на нов модул.
   
2. В областта Качете архив на модул или тема за инсталиране натиснете Choose file и укажете пътя към архива на плъгина.
   
   Изчакайте съобщението за успех.
   
3. Изберете модула Commerce DSK и натиснете Инсталиране (вж. фиг. по-долу).

Изчакайте инсталацията на модула.

Настройка

За да настроите платежния плъгин, изпълнете следните действия:

1. В горното меню изберете Управление > Търговия > Конфигурация > Плащане > Платежни шлюзове.
   Ще се отвори следната страница.
   
2. Натиснете Добавяне на платежен шлюз.
3. Изберете DSK.
4. Настройте платежния плъгин, ръководейки се от таблицата по-долу.

Натиснете Запазване, за да запазите настройките.

OpenCart

С този плъгин за OpenCart вашите клиенти ще могат да правят покупки чрез нашата платежна страница.

Инсталиране

За да инсталирате платежния плъгин, изпълнете следните действия:

1. Влезте във вашия сайт като администратор и изберете Модули/Разширения > Инсталиране на разширения.
   Ще се покаже следната страница.
   
2. Натиснете Качване и изберете изтегления файл в стандартния диалогов прозорец за избор на файл.
3. Изчакайте приключването на процеса на инсталиране.
4. В страничното меню изберете Модули/Разширения > Модули/Разширения. В полето Изберете тип разширение изберете Плащане. Страницата ще изглежда по следния начин.
   
   
5. До названието на инсталирания модул натиснете (Инсталиране).
6. Преминете към настройване на плъгина.

Настройване

За да настроите платежния плъгин, изпълнете следните действия:

1. Влезте във вашия сайт като администратор и в страничното меню изберете Модули/Разширения > Модули/Разширения.
2. В полето Изберете тип разширение изберете Плащане.
3. До названието на инсталирания модул натиснете (Редактиране).
   Ще се покаже следната страница.
   
4. Задайте настройките, ръководейки се от таблицата по-долу.

1. Натиснете (Запазване) в горния десен ъгъл на страницата.
   

CS-Cart

С този плъгин за CS-Cart вашите клиенти ще могат да правят покупки чрез нашата платежна страница.

Инсталация

За да инсталирате платежния плъгин, изпълнете следните действия:

1. Поставете съдържанието на папката upload в директорията на вашия сайт.
2. Влезте в сайта си като администратор и изберете Модули > Управление на модулите. Ще се покаже следната страница.
   
3. Натиснете Прегледайте всички налични модули. В списъка с налични плъгини намерете DSK и натиснете бутона Инсталирай.

4. Преминете към настройката на плъгина.

Настройка

За да настроите платежния плъгин, изпълнете следните действия:

1. Влезте в сайта си като администратор и изберете Администриране > Начини на плащане.

2. На страницата Начини на плащане натиснете (Добавете начин на плащане).

3. На таба Общи задайте настройките, ръководейки се от таблицата по-долу.
   

След избиране на процесора в полето Процесор до таба Общи се появява таба Конфигурирай.

Отворете таба Конфигурирай и задайте параметрите.

След това натиснете Запазване.

PrestaShop

С този плъгин за PrestaShop вашите клиенти ще могат да извършват покупки чрез нашата платежна страница.

Инсталиране

За да инсталирате платежния плъгин, изпълнете следните действия:

1. Влезте в административния панел на PrestaShop и в страничното меню изберете Модули > Модули и Услуги.
2. На отворилата се страница натиснете бутона Добави модул в горния десен ъгъл.

2. Преместете изтегления архив в указаната област от екрана (или натиснете Избери файл и преминете към него в стандартния диалог за избор на файл). Натиснете Качи този модул.
3. Изчакайте завършването на процеса на инсталиране.
4. За да преминете директно към настройката на модула, натиснете Настройка. Можете също да направите това по-късно. Процедурата за настройка е описана в следващия раздел.

Настройка

За да настроите платежния плъгин, изпълнете следните действия:

1. Влезте в административния панел на PrestaShop и в страничното меню изберете Модули > Модули и услуги.
2. Намерете модула radar-DSK и натиснете бутона Настройка до него.

Ще се покаже страницата за настройка на модула.

4. Задайте настройките, ръководейки се от таблицата по-долу.

Shopify

Shopify - платформа за електронна търговия, която позволява на потребителите да създават и настройват онлайн магазини, а също така и да ги управляват. Тя предоставя инструменти за създаване на списък от продукти, обработка на плащания и т.н. По същество, това е универсално решение за водене на онлайн бизнес.

С помощта на този плъгин за Shopify вашите клиенти ще могат да правят покупки чрез нашата платежна страница.

Инсталация

За да инсталирате плъгина за плащане Shopify, обърнете се по [връзката}(https://accounts.shopify.com/store-login?no_redirect=true&redirect=%2Fadmin%2Fsettings%2Fpayments%2Falternative-providers%2F116129793) или, като алтернатива, отидете в маркетплейса. Пример за това как ще изглежда екранът за инсталация:

За активиране на разширението изпълнете следните стъпки:

1. Отидете в настройките на вашия магазин
2. След това влезте в раздел Payments
3. След това в блока Additional payment methods натиснете бутона Add payment method
4. В реда за търсене изберете Search by provider
5. Намерете vPOS by DSK Bank

Настройка

За да настроите плъгина Shopify, изпълнете следните стъпки:

1. Регистрация на домейн в Портала за търговци (UAT)

1. Влезте в личния кабинет на Портала за продавачи. Вижте подробно тук.
2. Отидете в раздел Настройки/Интеграция Shopify.
3. Уверете се, че в полето Текущ магазин Shopify се показва името на домейна на магазина Shopify. Например, ако вашият магазин се намира на адрес example-store.myshopify.com, в полето трябва да се показва стойността example-store.

Ако това поле е празно:

1. Не попълвайте това поле ръчно!
2. В конзолата на администратора Shopify отидете в настройките на инсталирания плъгин, натиснете Повече > Управление, а след това влезте в нужния акаунт на Портала за продавачи.

Ако впоследствие, когато купувачът избира за плащане разширението на банката в Shopify и натиска бутона Плащане, възникват грешки, необходимо е да направите следното:

1. Влезте в личния кабинет на Портала за продавачи. Вижте подробно тук.
2. Отидете в раздел Настройки/Интеграция Shopify.
3. Ръчно изтрийте стойността, показана в полето Текущ магазин Shopify, като натиснете бутона Изтриване.
4. В конзолата на администратора Shopify отидете в настройките на инсталирания плъгин, натиснете Повече > Управление, а след това влезте в нужния акаунт на Портала за продавачи.

2. Превключване в тестов режим и тестване

1. В конзолата на администратора Shopify отидете в настройките на инсталирания плъгин.
2. Изберете Тестов режим, за да включите тестов режим за плъгина.
3. Направете няколко тестови плащания и възстановявания на суми. Те ще преминат през тестовата среда (UAT).

3. Достъп до продуктивната среда

Свържете се с Банката и поискайте достъп до продуктивната среда. Връзка за онбординг: [TODO]

4. Регистрация на домейн в Портала за търговци (продуктивна среда)

1. Влезте в продуктивния личен кабинет на Портала за търговци. Можете да влезете в продуктивния личен кабинет чрез бутона Управление в настройките на плъгина в административната конзола Shopify.
2. Отидете в раздел Настройки/Интеграция Shopify.
3. Уверете се, че в полето Текущ магазин Shopify се показва името на домейна на магазина Shopify. Например, ако вашият магазин се намира на адрес example-store.myshopify.com, в полето трябва да се показва стойността example-store.

Ако това поле е празно:

1. Не попълвайте това поле ръчно!
2. В конзолата на администратора Shopify отидете в настройките на инсталирания плъгин, натиснете Повече > Управление, а след това влезте в нужния акаунт на Портала за продавачи.

Ако впоследствие, когато купувачът избира за плащане разширението на банката в Shopify и натиска бутона Плащане, възникват грешки, необходимо е да направите следното:

1. Влезте в продуктивния личен кабинет на Портала за търговци. Можете да влезете в продуктивния личен кабинет чрез бутона Управление в настройките на плъгина в административната конзола Shopify.
2. Отидете в раздел Настройки/Интеграция Shopify.
3. Ръчно изтрийте стойността, показана в полето Текущ магазин Shopify, като натиснете бутона Изтриване.
4. В конзолата на администратора Shopify отидете в настройките на инсталирания плъгин, натиснете Повече > Управление, а след това влезте в нужния акаунт на Портала за продавачи.

5. Започване на приемането на реални плащания

1. В конзолата на администратора Shopify отидете в настройките на инсталирания плъгин.
2. Изключете Тестов режим, за да преминете в продуктивната среда.
3. Започнете да приемате реални плащания.