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

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

WordPress

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

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

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

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

Можете да изтеглите необходимата версия WooCommerce на github.com (връзка към историята на версиите на 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 за пренасочване на клиента след неуспешно плащане.
Включи за начини на доставка Изберете начините на доставка, ако са налични.

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

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

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

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

Параметър Описание
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. Разархивирайте архива на плугина и качете съдържанието на папката upload на вашия сайт. Получаващият се път ще бъде: <your site>/app/code/BPC/BPC/<plugin files and folders>.
  2. Свържете се към вашия сайт с помощта на интерфейса на командния простор, например, чрез утилитата PuTTY.
  3. В зависимост от типа на вашия хостинг изпълнете следните команди (вж. таблицата по-долу).
VPS/VDS Обичаен виртуален хостинг
Виртуален частен/обособен сървър. Командите се стартират под root.
  1. php bin/magento module:enable BPC_BPC
  2. php bin/magento setup:upgrade
  3. php bin/magento cache:clean
  4. php bin/magento setup:static-content:deploy -f
Използвайте версията на PHP като префикс, например: php-7.1, php-7.2 и така нататък.

  1. php-7.2 bin/magento module:enable BPC_BPC
  2. php-7.2 bin/magento setup:upgrade
  3. php-7.2 bin/magento cache:clean
  4. 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.
  1. php bin/magento module:disable BPC_BPC
  2. php bin/magento setup:upgrade
  3. php bin/magento cache:clean
  4. php bin/magento setup:static-content:deploy -f
Използвайте версията на PHP като префикс, например: php-7.1, php-7.2 и така нататък.

  1. php-7.2 bin/magento module:disable BPC_BPC
  2. php-7.2 bin/magento setup:upgrade
  3. php-7.2 bin/magento cache:clean
  4. 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

Инсталация

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

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

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

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

Настройка

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

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

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

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

    Configure

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


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


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

Login на API акаунта.
Ако плъгинът работи в тестов режим, въведете тестовия login. Ако плъгинът работи в боен режим, въведете боевия login.
Парола на търговеца

Парола на API акаунта.
Ако плъгинът работи в тестов режим, въведете тестовата парола. Ако плъгинът работи в боен режим, въведете боената парола.
Режим на работа на модула

Определя режима на работа на плъгина: тестов или работен.
Етапност на плащането

Включва/изключва двуетапни плащания.
Статус на поръчката при завършване на плащането Статус на поръчката в Joomla за успешно плащане.
Логиране Позволява включване или изключване на водене на журнал на събитията.
Валута Валута на плащането.

Joomla! и VirtueMart

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

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

Версия на Joomla Версия на VirtueMart Връзка за изтегляне
4.x 3.8.x

Инсталация

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

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

  3. На отворилата се страница натиснете Или изберете файл, за да намерите файла на плъгина, или плъзнете файла за качване. След това натиснете Качи и инсталирай.
    Prepare to upload
    Изчакайте завършването на качването и появяването на съобщението "Инсталацията на плъгина е завършена успешно".

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

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

  6. В горното меню изберете Virtuemart -> Payment Methods (Начини на плащане).
    Go to payment methods

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

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

    Create payment method

Настройка

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

  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

Инсталация

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

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

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


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

Настройка

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

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


Параметър Описание
Показвано име

Име на начина на плащане, например: Банкова карта.
Режим

Определя режима на работа на плъгина: тестов или работен.
Login-API

Login на API акаунта.
Ако плъгинът работи в тестов режим, въведете тестовия login. Ако плъгинът работи в боен режим, въведете боевия login.
Парола

Парола на API акаунта.
Ако плъгинът работи в тестов режим, въведете тестовата парола. Ако плъгинът работи в боен режим, въведете боената парола.
Двустепенни плащания

Включва/изключва двуетапни плащания.
Условия Блок настройки, добавен от Drupal Commerce. В настройките са указани правилата и логиката на Drupal за показване на указания начин за получаване на средства.
Водене на логиране на заявки към платежния шлюз Включено или изключено водене на журнал на събитията.
Status

Позволява включване или изключване на плъгина.

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

OpenCart

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

Версия OpenCart Връзка за изтегляне
4.x
3.x
2.3.x

Инсталация

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

  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. Влезте в сайта си като администратор и изберете Модули > Управление на модули. Ще се покаже следната страница.
    Choose file
  3. Натиснете Преглед на всички налични модули. В списъка с налични плъгини намерете DSK и натиснете бутона Инсталирай.
    List of modules
  4. Преминете към настройката на плъгина.

Настройка

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

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


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


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


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

Параметър Описание
Потребителско име

Login на API акаунта.
Ако плъгинът работи в тестов режим, въведете тестовия login. Ако плъгинът работи в боен режим, въведете боевия login.
Парола

Парола на API акаунта.
Ако плъгинът работи в тестов режим, въведете тестовата парола. Ако плъгинът работи в боен режим, въведете боената парола.
Тестов/Работен режим

Определя режима на работа на плъгина: тестов или работен.
Стадийност на плащанията

Включва/изключва двуетапни плащания.
Статус на успешна поръчка Позволява да укажете какъв статус ще бъде присвоен на поръчката при нейното завършване от системата CS-Cart.
Логиране

Включено или изключено водене на дневник на събитията.

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

PrestaShop

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

Версия PrestaShop Връзка за изтегляне
1.7.x, 8.x

Инсталация

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

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

Настройка

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

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


    PrestaShop Configure


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


    PrestaShop Configuration

  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. Започнете да приемате реални плащания.

:
eCommerce Плъгини CMS