Готови модули за CMS
Ако за сайта си използвате една от изброените по-долу системи за управление на съдържанието (CMS), то предлагаме да разгледате възможността за
използване на специални платежни плъгини, които са подготвени специално, за да започнете да приемате плащания възможно най-бързо.
Просто изберете плъгин за нужната CMS и следвайте инструкцията за инсталация.
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:
WooCommerce не е съвместим с всички теми на WordPress. В този документ използваме темата Storefront (външна връзка), създадена от разработчиците на WooCommerce.
Инсталация
- Влезте в своя административен панел.
- В лявата панел изберете Плъгини > Добави нов (вж. фигурата по-долу).

Ще се отвори страницата Добави плъгини. - Натиснете Качи плъгин в горната част на страницата.
- Изберете файла с плъгина, който сте изтеглили по-рано, и натиснете Инсталирай.
- След завършване на инсталацията, в лявата панел изберете Плъгини > Инсталирани (вж. фигурата по-долу).

- В раздела WooCommerce натиснете Активирай.
Настройка
За да настроите платежния плъгин за WordPress, направете следното.
- Влезте в своя административен панел.
- В лявата панел изберете Плъгини > Инсталирани (вж. фигурата по-долу).

- В раздела WooCommerce натиснете Настройки.
Ще се покаже следната страница.
- Задайте настройките, ръководейки се от таблицата по-долу.
| Параметър | Описание |
|---|---|
| Включен/Изключен | Позволява включване или изключване на плъгина. |
| Title | Име на начина на плащане, например: Банкова карта. |
| Логин-API | Login на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовия login. Ако плъгинът работи в боен режим, въведете боевия login. |
| Парола | Парола на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовата парола. Ако плъгинът работи в боен режим, въведете боената парола. |
| Тип плащания | Включва/изключва двуетапни плащания. |
| Тестов режим | Определя режима на работа на плъгина: тестов или работен. |
| Описание | Въведете описание на плащането, което ще се показва на клиента. |
| Статус на платена поръчка | Изберете статус на платена поръчка. |
| success_url | URL за пренасочване на клиента след успешно плащане. |
| fail_url | URL за пренасочване на клиента след неуспешно плащане. |
| Включи за начини на доставка | Изберете начините на доставка, ако са налични. |
Настройка на бързи методи на плащане
След раздела с основни настройки е представен разделът Payment Widget settings с настройки за плащания Google Pay и Apple Pay:
Ограничения:
- Достъпно за плъгин версия 5.5.0 и по-висока;
- За правилна работа се изисква WooCommerce версия 9.0 и по-висока;
- За работа с Apple Pay е необходимо да регистрирате домейна в Платежния шлюз с верификация в Apple Services. Това може да се направи в раздел Бързи бутони в Портала на продавача.
Задайте настройките, ръководейки се от таблицата по-долу
| Параметър | Описание |
|---|---|
| Payment Widget merchant token | Токен Open ID на продавача. Можете да намерите стойността на токена в полето Открит ключ в раздел Основни настройки в Портала на продавача. |
| Payment Sections | Страници, на които ще се показват бутоните. Допустими стойности: Product Page, Checkout Page. |
| Payment Buttons | Типове бутони (Apple Pay или Google Pay). Допустими стойности: applePay, googlePay. |
| Environment | Режим на работа на Apple Pay или Google Pay: TEST (тестов) или PRODUCTION (продуктивен). |
Можете да стилизирате показването на бутоните в зависимост от вашата тема, използвайки следния код:
apple-pay-button {
// styles for Apple Pay button
}
.gpay-button {
// styles for Google Pay button
}
Натиснете Запазване на промените.
В областта за известия ще се показва Вашите настройки са запазени. Сега можете да приемате плащания.
Magento
С този плугин за Magento вашите клиенти ще могат да правят покупки чрез нашата платежна страница.
Стабилната работа на плугина е гарантирана за следните версии на Magento. Ако използвате други версии (например, след актуализация), плугинът може да работи некоректно.
| Версия Magento | Връзка за изтегляне |
|---|---|
| 2.3.x и по-високи |
Изтегли плугин за Magento 1.6.7
Сеп 29, 2025
|
Инсталация
За да инсталирате платежния плугин за Magento, изпълнете следните действия.
- Разархивирайте архива на плугина и качете съдържанието на папката
uploadна вашия сайт. Получаващият се път ще бъде:<your site>/app/code/BPC/BPC/<plugin files and folders>. - Свържете се към вашия сайт с помощта на интерфейса на командния простор, например, чрез утилитата PuTTY.
- В зависимост от типа на вашия хостинг изпълнете следните команди (вж. таблицата по-долу).
| VPS/VDS | Обичаен виртуален хостинг |
|---|---|
Виртуален частен/обособен сървър. Командите се стартират под root.
|
Използвайте версията на PHP като префикс, например: php-7.1, php-7.2 и така нататък.
|
Инсталацията е завършена — преминете към настройка на плугина.
За да премахнете плугина, изпълнете процедурата за премахване.
Настройка
За да настроите платежния плугин за Magento, изпълнете следните действия.
- Влезте в своя административен панел на Magento.
- В менюто отляво изберете Stores > Configuration (вж. фиг. по-долу).

- В менюто на страницата изберете Sales > Payment Methods (вж. фиг. по-долу).
- На показаната страница в раздел Other Payment Methods преминете към точка Direct payment with credit/debit card (BPC) (вж. фигурата по-долу).
- Натиснете
, за да видите списъка с настройки на плъгина (вж. фиг. по-долу).
- Задайте настройките, ръководейки се от таблицата по-долу.
| Параметър | Описание |
|---|---|
| Активиран | Позволява включване или изключване на плъгина. |
| Заглавие на платежния метод | Име на начина на плащане, например: Банкова карта. |
| Потребителско име | Login на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовия login. Ако плъгинът работи в боен режим, въведете боевия login. |
| Парола | Парола на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовата парола. Ако плъгинът работи в боен режим, въведете боената парола. |
| Тест-режим | Определя режима на работа на плъгина: тестов или работен. |
| Включване на двустепенно плащане | Включва/изключва двуетапни плащания. |
| Статус на успешна поръчка | Изберете статус в CMS, който ще бъде присвоен на платена поръчка. |
| Достъпни методи за доставка | Начини на доставка, за които може да се използва този начин на плащане. |
Отметката "Use System Value" (настройка на Magento) основно се използва за връщане към настройките по подразбиране. Кликнете Save Config.
Премахване
За да премахнете платежния плъгин за Magento, изпълнете следните стъпки.
- Свържете се към вашия сайт с помощта на интерфейс на командния ред, например чрез утилитата PuTTY.
- В зависимост от типа на вашия хостинг изпълнете следните команди (вж. таблицата по-долу).
| VPS/VDS | Обикновен виртуален хостинг |
|---|---|
Виртуален частен/отделен сървър. Командите се стартират под root.
|
Използвайте версията на PHP като префикс, например: php-7.1, php-7.2 и така нататък.
|
Премахнете файловете и папките на плъгините от вашия сайт: 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
|
Инсталация
За да инсталирате плъгина, изпълнете следните действия.
Влезте в административния панел на Joomla.
В менюто вляво изберете Компоненти > JoomShopping > Инсталация и обновяване.

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

Изчакайте завършването на качването и появата на съобщението "Операцията е завършена".
Настройка
За да настроите плъгина, изпълнете следните действия.
Влезте в административния панел на Joomla.
Отидете в Компоненти > JoomShopping > Опции и изберете Плащане.


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

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

- Настройте плъгина (вижте таблицата по-долу) и натиснете Запази и затвори отгоре.
| Параметър | Описание |
|---|---|
| Статус | Позволява активиране на модула. |
| Потребителско име на търговеца | 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
|
Инсталация
Влезте в административния панел на Joomla.
В горното меню изберете Разширения > Мениджър на разширения > Инсталация.

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

Изчакайте завършването на качването и появяването на съобщението "Инсталацията на плъгина е завършена успешно".В горното меню изберете Разширения > Мениджър на разширения > Управление.

В показания списък намерете в списъка пункта VM Payment - radar-DSK и натиснете Включи.
В горното меню изберете Virtuemart -> Payment Methods (Начини на плащане).

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

-
В отворилия се прозорец Payment Method настройте параметрите на новия начин на плащане. В полето Payment Method изберете
VM Payment - radar-DSK Module.
Настройка
За да настроите плъгина, изпълнете следните действия.
Влезте в административния панел на Joomla.
Отидете в VirtueMart > Payment Methods.
В списъка с начини на плащане щракнете върху името на начина на плащане, в който се използва плъгинът
radar-DSK. Ще се отвори страница за конфигурация.
- Настройте плъгина (вж. таблицата по-долу) и натиснете 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
|
Инсталация
За да инсталирате плъгина, изпълнете следните действия.
- В горното меню изберете Управление > Разширения и натиснете Инсталирай нов модул.
- В областта Качи архив на модул или тема за инсталация натиснете Choose file и посочете пътя към архива на плъгина.

Изчакайте съобщение за успех.
- Изберете модул Commerce DSK и натиснете Инсталирай (виж фиг. по-долу).

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

| Параметър | Описание |
|---|---|
| Показвано име | Име на начина на плащане, например: Банкова карта. |
| Режим | Определя режима на работа на плъгина: тестов или работен. |
| Login-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
|
Инсталация
За да инсталирате платежния плъгин, изпълнете следните действия:
- Влезте във вашия сайт като администратор и изберете Модули/Разширения > Инсталация на разширения.
Ще се покаже следната страница.
- Натиснете Качи и изберете изтегления файл в стандартния диалогов прозорец за избор на файл.
- Изчакайте завършването на процеса на инсталация.
- В страничното меню изберете Модули/Разширения > Модули/Разширения. В полето Изберете тип разширение изберете Плащане. Страницата ще изглежда по следния начин.

- До името на инсталирания модул натиснете
(Инсталирай). - Преминете към настройка на плъгина.
Настройка
За да настроите платежния плъгин, изпълнете следните действия:
- Влезте във вашия сайт като администратор и в страничното меню изберете Модули/Разширения > Модули/Разширения.
- В полето Изберете тип разширение изберете Плащане.
До името на инсталирания модул натиснете
(Редактирай).
Ще се покаже следната страница.
Задайте настройките, ръководейки се от таблицата по-долу.
| Параметър | Описание |
|---|---|
| Статус | Позволява включване или изключване на плъгина. |
| Потребителско име на търговеца | Login на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовия login. Ако плъгинът работи в боен режим, въведете боевия login. |
| Парола на търговеца | Парола на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовата парола. Ако плъгинът работи в боен режим, въведете боената парола. |
| Режим на работа на модула | Определя режима на работа на плъгина: тестов или работен. |
| Стадийност на плащането | Включва/изключва двуетапни плащания. |
| Статус на поръчката при завършване на плащането | Позволява да се посочи какъв статус CMS ще присвои на поръчката след получаване на отговор за успешно плащане от платежния gateway. |
| Валута | Изберете валутата, която планирате да използвате, или оставете стойността по подразбиране. |
| Логиране | Включено или изключено водене на дневник на събитията. |
| Ред на сортиране | Позволява да се посочи позицията на показване в списъка на платежните системи при оформяне на поръчка от клиента. |
- Натиснете
(Запази) в горния десен ъгъл на страницата.
CS-Cart
С този плъгин за CS-Cart вашите клиенти ще могат да извършват покупки чрез нашата платежна страница.
Инсталиране
За да инсталирате платежния плъгин, изпълнете следните действия:
- Поставете съдържанието на папката upload в каталога на вашия сайт.
- Влезте в сайта си като администратор и изберете Модули > Управление на модули. Ще се покаже следната страница.
- Натиснете Преглед на всички налични модули. В списъка с налични плъгини намерете DSK и натиснете бутона Инсталирай.
- Преминете към настройката на плъгина.
Настройка
За да настроите платежния плъгин, изпълнете следните действия:
- Влезте в сайта си като администратор и изберете Администриране > Начини на плащане.
- На страницата Начини на плащане натиснете
(Добави начин на плащане).
- На раздела Общо задайте настройките, ръководейки се от таблицата по-долу.
| Параметър | Описание |
|---|---|
| Наименование | Задайте име за начина на плащане. |
| Процесор | Изберете DSK от списъка. |
| Статус | Бутонът за превключване се намира в долната част на формата. Убедете се, че е поставена отметката Active. |
След избора на процесор в полето Процесор до раздела Общо се появява раздел Настрой.

Отворете раздела Настрой и задайте параметрите.
| Параметър | Описание |
|---|---|
| Потребителско име | Login на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовия login. Ако плъгинът работи в боен режим, въведете боевия login. |
| Парола | Парола на API акаунта. Ако плъгинът работи в тестов режим, въведете тестовата парола. Ако плъгинът работи в боен режим, въведете боената парола. |
| Тестов/Работен режим | Определя режима на работа на плъгина: тестов или работен. |
| Стадийност на плащанията | Включва/изключва двуетапни плащания. |
| Статус на успешна поръчка | Позволява да укажете какъв статус ще бъде присвоен на поръчката при нейното завършване от системата CS-Cart. |
| Логиране | Включено или изключено водене на дневник на събитията. |
След това натиснете Запази.
PrestaShop
С този плъгин за PrestaShop вашите клиенти ще могат да правят покупки чрез нашата платежна страница.
| Версия PrestaShop | Връзка за изтегляне |
|---|---|
| 1.7.x, 8.x |
Изтеглете плъгин за PrestaShop 2.9.4
Окт 17, 2025
|
Инсталация
За да инсталирате платежния плъгин, изпълнете следните действия:
- Влезте в административния панел на PrestaShop и в страничното меню изберете Модули > Модули и Услуги.
- На отворилата се страница натиснете бутона Добавяне на модул в горния десен ъгъл.
- Преместете изтегления архив в указаната област на екрана (или натиснете Избор на файл и отидете до него в стандартния диалог за избор на файл). Натиснете Качване на този модул.
- Изчакайте приключването на процеса на инсталация.
- За да преминете веднага към настройка на модула, натиснете Настройка. Можете да направите това и по-късно. Процедурата за настройка е описана в следващия раздел.
Настройка
За да настроите платежния плъгин, изпълнете следните действия:
- Влезте в административния панел на PrestaShop и в страничното меню изберете Модули > Модули и услуги.
-
Намерете модула
radar-DSKи натиснете бутона Настройка до него.
Ще се покаже страницата за настройка на модула.
Задайте настройките, ръководейки се от таблицата по-долу.
| Параметър | Описание |
|---|---|
| Вход | Вход за 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). Пример за това как ще изглежда екранът за инсталация:

За активиране на разширението изпълнете следните стъпки:
- Отидете в настройките на вашия магазин
- След това влезте в раздел Payments
- След това в блок Additional payment methods натиснете на бутон Add payment method
- В реда за търсене изберете Search by provider
- Намерете vPOS by DSK Bank

Настройка
За да настроите плъгина Shopify, изпълнете следните стъпки:
1. Регистрация на домейн в Портала на продавача (UAT)
- Влезте в личния кабинет на Портала на продавача. Вижте подробно тук.
- Отидете в раздел Settings/Shopify integration.
- Посочете своя домейн на магазин Shopify. Например, ако вашият магазин се намира на адрес example-store.myshopify.com, посочете example-store.

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

3. Достъп в продуктивната среда
Свържете се с Банката и поискайте достъп в продуктивната среда. Връзка за онбординг: [TODO]
4. Регистрация на домейн в Портала на продавача (продуктивна среда)
- Влезте в продуктивния личен кабинет на Портала на продавача. Можете да попадне в продуктивния личен кабинет чрез бутона Управлявай в настройките на плъгина в административната конзола Shopify.
- Отидете в раздел Settings/Shopify integration.
- Посочете домейна на магазин Shopify. Например, ако вашият магазин се намира на адрес example-store.myshopify.com, посочете example-store.
5. Начало на приемане на реални плащания
- В конзолата на администратора Shopify отидете в настройките на инсталирания плъгин.
- Изключете Тестов режим, за да преминете в продуктивната среда.
- Започнете да приемате реални плащания.
