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

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

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

WordPress

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

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

Версия WordPress	Версия WooCommerce	Връзка за изтегляне
4.х и по-нови	3.x	Изтеглете плъгин WordPress 5.3.10 Окт 17, 2025

Препоръчителна версия 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. Задайте настройките, ръководейки се от таблицата по-долу.
   

Параметър	Описание
Включен/Изключен	Позволява включване или изключване на плъгина.
Title	Име на начина на плащане, например: Банкова карта.
Логин-API	Login на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовия login. Ако плъгинът работи в боен режим, въведете боевия login.
Парола	Парола на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовата парола. Ако плъгинът работи в боен режим, въведете боената парола.
Тип плащания	Включва/изключва двуетапни плащания.
Тестов режим	Определя режима на работа на плъгина: тестов или работен.
Описание	Въведете описание на плащането, което ще се показва на клиента.
Статус на платена поръчка	Изберете статуса на платената поръчка.
success_url	URL за пренасочване на клиента след успешно плащане.
fail_url	URL за пренасочване на клиента след неуспешно плащане.
Включи за начини на доставка	Изберете начините на доставка, ако са достъпни.

След раздела с основни настройки е представен раздел с настройки за Google Pay:

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

• Достъпно за плъгин версия 5.3.0 и по-нова;
• За правилна работа се изисква WooCommerce версия 9.0 и по-нова;
• Достъпно за търговци, преминали верификация на Google.

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

Параметър	Описание
Google merchant ID	ID на търговеца в системата на Google.
Google merchant Name	Име на търговеца в системата на Google.
Mode	Режим на работа за Google Pay: TEST или PRODUCTION.
Payment Sections	Място, където ще се показва бутонът. Възможни стойности: Product Page, Checkout Page.
Button Type	Тип на бутона. Възможни стойности: Buy Donate Checkout Book Order
Button Color	Цвят на бутона. Възможни стойности: Default Black White

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

Magento

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

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

Версия Magento	Връзка за изтегляне
2.3.x и по-нова	Изтеглете плъгин за Magento 1.6.7 Сеп 29, 2025

Инсталиране

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

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

VPS/VDS	Обикновен виртуален хостинг
Виртуален частен/отделен сървър. Командите се изпълняват под root. php bin/magento module:enable BPC_BPC php bin/magento setup:upgrade php bin/magento cache:clean php bin/magento setup:static-content:deploy -f	Използвайте версията на PHP като префикс, например: php-7.1, php-7.2 и така нататък. php-7.2 bin/magento module:enable BPC_BPC php-7.2 bin/magento setup:upgrade php-7.2 bin/magento cache:clean php-7.2 bin/magento setup:static-content:deploy -f

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

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

Настройка

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

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

Параметър	Описание
Активиран	Позволява включване или изключване на плъгина.
Заглавие на платежния метод	Име на начина на плащане, например: Банкова карта.
Потребителско име	Login на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовия login. Ако плъгинът работи в боен режим, въведете боевия login.
Парола	Парола на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовата парола. Ако плъгинът работи в боен режим, въведете боената парола.
Тестов режим	Определя режима на работа на плъгина: тестов или работен.
Включване на двуетапно плащане	Включва/изключва двуетапни плащания.
Статус на успешна поръчка	Изберете статус в CMS, който ще бъде присвоен на платената поръчка.
Достъпни методи за доставка	Начини на доставка, за които може да се използва този начин на плащане.

Отметката "Use System Value" (настройка на Magento) се използва основно за връщане към настройките по подразбиране. Кликнете върху Save Config.

Премахване

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

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

VPS/VDS	Обичаен виртуален хостинг
Виртуален частен/изключителен сървър. Командите се изпълняват под root. php bin/magento module:disable BPC_BPC php bin/magento setup:upgrade php bin/magento cache:clean php bin/magento setup:static-content:deploy -f	Използвайте версията на PHP като префикс, например: php-7.1, php-7.2 и така нататък. php-7.2 bin/magento module:disable BPC_BPC php-7.2 bin/magento setup:upgrade php-7.2 bin/magento cache:clean php-7.2 bin/magento setup:static-content:deploy -f

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

Joomla!

Joomla! и JoomShopping

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

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

Версия Joomla	Версия JShopping	Връзка за изтегляне
3.x, 4.x, 5.x	4.x	Изтегли плъгин за Joomla! 1.5.12 Окт 16, 2025

Инсталиране

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

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

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

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

Настройка

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

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

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

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

   
   

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

   
   

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

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

Параметър	Описание
Статус	Позволява активиране на модула.
Логин на продавача	Login на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовия login. Ако плъгинът работи в боен режим, въведете боевия login.
Парола на продавача	Парола на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовата парола. Ако плъгинът работи в боен режим, въведете боената парола.
Режим на работа на модула	Определя режима на работа на плъгина: тестов или работен.
Стадийност на плащането	Включва/изключва двуетапни плащания.
Статус на поръчката при завършване на плащането	Статус на поръчката в Joomla за успешно плащане.
Логиране	Позволява включване или изключване на водене на журнал на събитията.
Валута	Валута на плащането.

Joomla! и VirtueMart

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

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

Версия на Joomla	Версия на VirtueMart	Връзка за изтегляне
4.x	3.8.x	Изтеглете плъгин за Joomla! 2.4.3 Окт 16, 2025

Инсталация

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 . Ще се отвори страницата за конфигурация.

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

Параметър	Описание
LOGIN-API	Login на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовия login. Ако плъгинът работи в боен режим, въведете боевия login.
Парола	Парола на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовата парола. Ако плъгинът работи в боен режим, въведете боената парола.
Тестов режим	Определя режима на работа на плъгина: тестов или работен.
Двуетапни плащания	Включва/изключва двуетапни плащания.

Drupal

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

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

Версия Drupal	Версия Drupal Commerce	Връзка за сваляне
8.x/9.x/10.x	2.x	Свали плъгин Drupal 8.x/9.x/10.x 2.1.10 Сеп 30, 2025

Инсталация

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

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

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

Настройка

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

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

Параметър	Описание
Име за показване	Име на начина на плащане, например: Банкова карта.
Режим	Определя режима на работа на плъгина: тестов или работен.
Логин-API	Login на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовия login. Ако плъгинът работи в боен режим, въведете боевия login.
Парола	Парола на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовата парола. Ако плъгинът работи в боен режим, въведете боената парола.
Двуетапни плащания	Включва/изключва двуетапни плащания.
Условия	Блок настройки, добавен от Drupal Commerce. В настройките са посочени правилата и логиката на Drupal за показване на указания начин за получаване на средства.
Водене на логиране на заявки към платежния шлюз	Включено или изключено водене на журнал на събития.
Status	Позволява включване или изключване на плъгина.

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

OpenCart

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

Версия OpenCart	Връзка за изтегляне
4.x	Изтеглете плъгин за OpenCart 4.x 1.0.11 Окт 16, 2025
3.x	Изтеглете плъгин за OpenCart 3.x 3.2.10 Окт 16, 2025
2.3.x	Изтеглете плъгин за OpenCart 2.3.x 3.2.6 Окт 16, 2025

Инсталация

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

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

Настройка

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

1. Влезте в сайта си като администратор и в страничното меню изберете Модули/Разширения > Модули/Разширения.
2. В полето Изберете тип разширение изберете Плащане.

3. До името на инсталирания модул натиснете (Редактиране).
   Ще се покаже следната страница.
   

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

Параметър	Описание
Статус	Позволява включване или изключване на плъгина.
Потребителско име на продавача	Login на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовия login. Ако плъгинът работи в боен режим, въведете боевия login.
Парола на продавача	Парола на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовата парола. Ако плъгинът работи в боен режим, въведете боената парола.
Режим на работа на модула	Определя режима на работа на плъгина: тестов или работен.
Етапност на плащането	Включва/изключва двуетапни плащания.
Статус на поръчката при завършване на плащането	Позволява да се посочи какъв статус CMS ще присвои на поръчката след получаване на отговор за успешно плащане от платежния gateway.
Валута	Изберете валутата, която планирате да използвате, или оставете стойността по подразбиране.
Логиране	Включено или изключено водене на дневник на събитията.
Ред на сортиране	Позволява да се посочи позицията на показване в списъка на платежните системи при оформяне на поръчка от клиента.

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

CS-Cart

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

Инсталиране

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

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

Настройка

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

1. Влезте в сайта си като администратор и изберете Администриране > Начини на плащане.
   
2. На страницата Начини на плащане натиснете (Добави начин на плащане).
   
3. На раздела Общо задайте настройките, ръководейки се от таблицата по-долу.
   

Параметър	Описание
Наименование	Задайте име за начина на плащане.
Процесор	Изберете DSK от списъка.
Статус	Бутонът за превключване се намира в долната част на формата. Убедете се, че е поставена отметката Active.

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

Отворете раздела Настрой и задайте параметрите.

Параметър	Описание
Потребителско име	Login на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовия login. Ако плъгинът работи в боен режим, въведете боевия login.
Парола	Парола на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовата парола. Ако плъгинът работи в боен режим, въведете боената парола.
Тестов/Работен режим	Определя режима на работа на плъгина: тестов или работен.
Стадийност на плащанията	Включва/изключва двуетапни плащания.
Статус на успешна поръчка	Позволява да укажете какъв статус ще бъде присвоен на поръчката при нейното завършване от системата CS-Cart.
Логиране	Включено или изключено водене на дневник на събитията.

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

PrestaShop

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

Версия PrestaShop	Връзка за изтегляне
1.7.x, 8.x	Изтеглете плъгин за PrestaShop 2.9.4 Окт 17, 2025

Инсталация

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

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

Настройка

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

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

2. Намерете модула radar-DSK и натиснете бутона Конфигурация до него.

   
   

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

   
   
   

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

Параметър	Описание
Потребителско име	Потребителско име за API, предоставено от банката.
Парола	Парола за API, предоставена от банката.
Тестов режим	Определя дали плъгинът работи в тестов режим (ДА) или в работен режим (НЕ). Обърнете внимание, че потребителското име и паролата за тестов и работен режим могат да се различават.
Включване на двустадийност на плащането	Определя стадийността на плащанията: натиснете ДА за използване на двустадийни плащания.
Статус по подразбиране	Статус на поръчката за показване в PrestaShop и на купувачите по подразбиране.
Статус на платена поръчка	Статус на поръчката за показване в PrestaShop и на купувачите в случай на успешно плащане (за едностадиен режим) или удържане на средства (за двустадиен режим).
Статус на грешка	Статус на поръчката за показване в PrestaShop и на купувачите в случай на грешка в плащането.
Водене на логване на заявки и отговори от шлюза	Определя дали ще се запазва журнал на заявките (ДА) или не (НЕ). Журналите се запазват в папката за журнали на PrestaShop и са достъпни само за администратора.

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. Отидете в раздел Settings/Shopify integration.
3. Укажете вашия домейн на магазин Shopify. Например, ако вашият магазин се намира на адрес example-store.myshopify.com, укажете example-store.

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

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

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

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

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

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

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

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