Оторизация
За да влезете в личния си кабинет, изпълнете следните действия.
1. Отворете страницата на личния кабинет.
TEST: https://vpostest.dskbank.bg/auth/login
PROD: https://vpos.dskbank.bg/auth/login
Ако входът не е осъществен, ще се покаже форма за въвеждане на логин и парола (вж. изображението по-долу).

2. В полетата Логин и Парола въведете съответно своя логин и парола на оператора.
3. Натиснете бутона Вход.
Ако данните са въведени правилно, ще бъде осъществен вход в личния кабинет.
Изход от системата
За да излезете от личния кабинет, щракнете върху бутона
, разположен в горната дясна част на интерфейса на личния кабинет.
Промяна на езика на интерфейса
За да промените езика, на който се показва интерфейсът на личния кабинет, изпълнете следните действия.
- Влезте в личния кабинет.
- В горната част на контролния панел на личния кабинет щракнете върху иконката с изображение на глобус.
Ще се покаже списък с достъпните езици на интерфейса (вж. изображението по-долу).
- Щракнете върху иконката на нужния език. Страницата на личния кабинет автоматично ще се покаже на избрания език.
Работа с API
С помощта на API можете да създавате уникални платежни интеграции. Например, да свържете плащане със специално създадена платежна страница. Допълнителна информация за API е достъпна тук. При създаването на Търговец получавате писмо с логин и еднократна парола. След това можете самостоятелно да генерирате парола за API на страницата Работа с API на портала на продавача.
За да покажете страницата Работа с API, натиснете
в лявата странична лента.
Ще се покаже следната страница.
Достъпни са следните действия:
Създаване на парола за API. За това натиснете Създай парола за API.

Промяна на паролата за API. За това натиснете Промени парола за API и потвърдете действието в отворилия се прозорец:

След смяната на паролата можете да върнете предишната парола в рамките на 5 минути. Натиснете Върни предишна парола и потвърдете действието в отворилия се прозорец:

Настройки
За да влезете в секция Настройки, в лявото навигационно меню на личния кабинет изберете пункт Настройки (икона
).
Секция Настройки позволява
- да зададете основни настройки
- да включите известия за обратно повикване
- да промените паролата за достъп до личния кабинет
- да посочите адрес на електронна поща за възможност за възстановяване на паролата към личния кабинет
- да зададете параметри за работа на личния кабинет (недостъпно в демонстрационната версия)
Основни настройки
Секция Основни настройки позволява на служителя на магазина да настройва определени параметри на акаунта и разрешенията.
За да преминете в секция Основни настройки, изберете Настройки в страничното меню, а след това изберете Основни настройки в блок Продавач. Ще се покаже страница за настройки на акаунта, както е показано по-долу.
Описанието на настройките е приведено в таблицата по-долу:
| Поле | Описание |
|---|---|
| Показвай финална страница | Ако е включено, позволява да се показва финална страница след завършване на плащането. |
| Автозавършване включено | Ако е включено, позволява да се посочи в полето Време за завършване брой часове, след изтичането на които двустадийните плащания ще бъдат автоматично завършени. |
| Адрес на електронна поща на продавача, на който ще се изпращат известия. В това поле могат да се въведат няколко адреса на електронна поща (разделени със запетая). Тригерите за изпращане на известия се настройват. Могат да се настроят за събития като промяна на статуса на транзакция, създаване на запазени платежни данни и т.н. | |
| Продължителност на сесията (в минути) | Времето, отделено за въвеждане на данните на картата от момента на регистрацията на плащането. Ако плащането не бъде извършено в посочения срок, поръчката ще премине в статус ОТХВЪРЛЕНА. След това ще бъде изпратен callback, ако е настроен. Промяната на статуса на такива поръчки се извършва по график, поради което са възможни малки забавяния. Ако заявите статуса по такава поръчка и по нея е изтекло времето, поръчката ще бъде незабавно преведена в статус ОТХВЪРЛЕНА. |
| Изпращай известия за оформяне на поръчка | Ако е включено, продавачът ще получи известие по електронна поща за поставяне на поръчка |
| Двустадийно плащане | Разрешение за използване на двустадийна схема за плащане |
| Изпращане на известия до клиента по СМС | Ако е включено, клиентът ще получава СМС-известия |
| Разрешено плащане Google Pay в браузър | Разрешение за плащания Google Pay в браузър |
| Разрешено плащане Google Pay на мобилно устройство | Разрешение за плащания Google Pay на мобилно устройство |
| Разрешено плащане чрез Apple Pay | Разрешение за използване на Apple Pay |
| Открит ключ | Можете да генерирате открит ключ (токен Open ID). Също така е достъпно ръчно въвеждане на ключа. Подробности вижте тук |
Натиснете бутона Запазване.
Callback-уведомления
Порталът на продавача позволява настройване на уведомления за обратно повикване. Този раздел може да бъде скрит за някои Продавачи. Затова, ако не го виждате или имате въпроси, обърнете се към службата за поддръжка и ще се радваме да помогнем.
Допълнителна информация за уведомленията за обратно повикване е достъпна тук. Разделът Callback-уведомления е достъпен тук: Настройки → Продавач → Callback-уведомления.
Ако потребителят има свързани продавачи, изборът на продавач става достъпен в падащото меню Продавач.
За да включите настройките за уведомления за обратно повикване, щракнете върху превключвателя Callback-уведомленията са изключени:

Настройките за известия за обратно повикване са описани по-долу.

Тип на callback-а
Ако продавачът вече е настроил Динамичен тип известие, и двата варианта в областта Тип подпис ще бъдат недостъпни за избор.

HTTP-метод
Изберете един от двата предложени начина: GET или POST.
Връзка
Въведете URL, на който ще се изпращат известията, например: https://test.com. Позволява се да се указват няколко връзки (чрез запетая и без интервали).
Допълнителни параметри
Въведете реда на параметрите, които ще бъдат предадени в callback-а, чрез запетая.

Тип подпис
Изберете един от типовете подпис: Симетричен или Асимметричен. Ако е избран симетричен тип подпис, може да се генерира token на callback-а. Освен това, ако е избран Симетричен тип подпис, може да се въведе token ръчно.

Ако е избран тип асимметричен подпис, бутонът Генерирай ще бъде неактивен. Ключът за асимметричен подпис може да се получи в службата за поддръжка.

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

Смяна на парола
За да промените паролата за достъп в личния кабинет, изпълнете следните действия.
- Изпълнете вход в личния кабинет.
- В панела за управление отляво преминете в раздела Настройки, натискайки иконата
. - На показаната страница изберете таба Смяна на парола. Страницата ще придобие следния вид.
- В полето Текуща парола въведете вашата текуща парола.
-
В полетата Нова парола и Нова парола отново въведете новата парола.
Паролата трябва да отговаря на следните изисквания:
- Паролата не трябва да съдържа название на магазина или login на един от потребителите, свързани към мърчанта, към който се отнася потребителят, променящ паролата (включително промяна на регистъра).
- Въвежданата от потребителя парола задължително трябва да съдържа символи от изброените по-долу групи:
- главни буквы от латинската азбука (A-Z)
- малки буквы от латинската азбука (a-z)
- цифри (0-9)
- специални символи (! "#;:? * () + = < > , . { } )
- Дължината на паролата трябва да бъде не по-малко от 8 символа.
Щракнете на бутона Смени парола.
Адрес на електронна поща
Задайте адрес на електронна поща, който ще се използва за възстановяване на достъпа до личния кабинет.
- Влезте в личния кабинет.
- В панела за управление отляво преминете в раздела Настройки, натискайки иконата
. - В раздела Адрес на електронна поща въведете адреса, който ще се използва за възстановяване на достъпа.
- Натиснете Запази.

На указания адрес на електронна поща ще бъде изпратено писмо за потвърждение. След като адресът на електронната поща бъде потвърден, редактирането на адреса на тази страница ще бъде недостъпно. Ако трябва да промените адреса на електронната поща още веднъж, обърнете се към екипа за поддръжка.
Двуфакторна аутентификация
Можете да настроите двуфакторна аутентификация, за да осигурите допълнително ниво на сигурност, гарантиращо, че само вие ще можете да имате достъп до вашия Личен кабинет. В този случай при влизане в Личния кабинет е необходимо да въведете не само login и парола, но и код за аутентификация, генериран от приложението Google Authenticator, или изпратен на вашата електронна поща (в зависимост от включения начин на аутентификация).
За настройка на двуфакторна автентификация в контролния панел отлево отидете в раздела Настройки > Двуфакторна автентификация. На избор се предлагат два начина за автентификация:

Google Authenticator (препоръчано)
- В приведения списък изберете Google Authenticator (препоръчано) и натиснете бутона Включване.
- Появява се форма, където е необходимо да потвърдите паролата си за вход в Личния кабинет:
- Изтеглете/отворете приложението Google Authenticator на вашето устройство. Въведете секретния ключ или сканирайте QR-кода, за да добавите акаунта си в приложението Google Authenticator. Приложението ще генерира код. Въведете генерирания код в полето Въведете 6-цифрен код.
- След като настроите двуфакторната автентификация чрез Google Authenticator, при следващите входове във вашия Личен кабинет ще се изисква код от Google Authenticator:
E-mail код за потвърждение
- В приведения списък изберете E-mail код за потвърждение и натиснете бутона Включване.
- Ако вашият адрес на електронна поща не е посочен в настройките и не е потвърден, моля, първо направете това. Ако всичко е настроено, тогава следвайте следващите стъпки по-долу.
- Появява се форма, където е необходимо да потвърдите паролата си за вход в Личния кабинет:
- За завършване на настройката на двуфакторната автентификация, моля, въведете 4-цифрения код, изпратен ви на вашия адрес на електронна поща:
- След като настроите двуфакторната автентификация чрез E-mail, при следващите входове във вашия Личен кабинет ще се изисква код, който ще бъде изпратен на вашата електронна поща.
Аналитика
За да покажете страницата Аналитика, натиснете върху иконата
в лявата странична лента.
На страницата ще се покажат данни за транзакциите:
Горното меню позволява да изберете период, за който ще се показва информацията за транзакциите. Налични са следните стойности:
- Денонощие;
- Седмица;
- Месец;
- Година.
Графиката Конверсия показва процентното съотношение на успешните транзакции към общия брой транзакции.

Графиката Кодове за отказ (вж. изображението по-долу) показва основните причини за грешки при обработване на поръчките.

Графиката Брой транзакции показва данни за транзакциите за избрания период.

При това на графиката се показват следните полета:
- Общо транзакции — общия брой транзакции;
- Успешни — броя на успешните транзакции;
- Неуспешни — броя на транзакциите, при обработването на които е възникнала грешка.
На графиката Оборот се показва информация за сумите на успешните и отхвърлените транзакции.

На графиката Потвърден оборот се показва информация за потвърдените суми на успешните и върнатите/отхвърлените транзакции.

Издаване на сметка за плащане
Можете да издадете на купувача сметка за плащане на стоки или услуги по електронна поща. За това използвайте раздела Сметка за плащане на личния кабинет. След издаването на сметката купувачът получава писмо и преминава по връзката в него към страницата за плащане.
Изпращане на връзка към платежна форма по email
За да издадете сметка на клиент и да му изпратите връзка към платежната страница по електронна поща, отидете в раздела Сметка за плащане на личния кабинет. Можете също така да отворите този раздел, като натиснете в горната част на личния кабинет бутона Създаване и изберете Сметка.

Ще се покаже страницата за въвеждане на параметри за изпращане:
Задайте настройките, ръководейки се от таблицата по-долу.
| Параметър | Описание |
|---|---|
| Имена на клиента | Фамилия, име и бащино име на клиента. Въведените в това поле данни се показват в писмото, съдържащо връзката към платежната страница |
| Адрес на електронната поща, на който ще бъде изпратена връзката за плащане | |
| Тип плащане | Изберете един от двата варианта.
|
| Език | Изберете езика на сметката от падащия списък. Достъпни са стойностите - BG и EN |
| Плащане до | Укажете датата и времето, до които може да се плати сметката. След изтичането на този срок плащането на издадената сметка няма да бъде възможно |
| Описание на плащането | Описание на плащането в свободна форма |
| Въведете сума | Укажете сумата на плащането и изберете валутата. Ако поръчката съдържа предварително попълнена количка за стоки, това поле се попълва автоматично |
Натиснете бутона Създаване на връзка. При успешно изпращане по-долу ще се покаже връзката към платежната форма:
Можете да прегледате изпратената на клиента платежна страница, като натиснете бутона Отваряне на връзката за плащане.
Формиране на количка за стоки при издаване на сметка за плащане
При формирането на сметка за плащане може да се укаже количка за стоки по поръчката. Секцията Стоки се намира под формата за създаване на връзка за плащане:
- За да добавите стока в количката, натиснете бутона Добавяне на стока и изберете Нов продукт. Ще се покаже форма с параметрите на добавяната стока.
-
Попълнете необходимите полета, ръководейки се от таблицата по-долу.
Поле Описание Наименование Наименование на стоката или услугата. Задължително поле. Артикул Артикул на стоковата позиция. Задължително поле. Кол-во Количество стока по данната стокова позиция. Задължително поле. Ед. изм. Мерни единици, например: л — литри, бр. — броя. Задължително поле. Цена Цена за единица стокова позиция. Задължително поле. Сума Обща сума за всички единици от една стокова позиция. Изчислява се автоматично при попълване на полетата Цена и Кол-во. Натиснете Добавяне на стока.
Повторете необходимите действия за всяка позиция от стоковата кошница. При необходимост да изтриете добавена позиция натиснете бутона
и потвърдете действието. За да изтриете всички стоки, натиснете бутона Изтриване на всички стоки и потвърдете действието.

Можете да добавите стоки от каталога, за това натиснете Добавяне и изберете Стока от каталог, а след това изберете стоката в отвореният прозорец.

След добавяне на стоката можете да я редактирате. За това кликнете върху реда на стоката и променете стойностите във формата за редактиране.
След като попълните стоковата кошница, издайте сметка на клиента.
Импорт на файл CSV
Можете да регистрирате поръчка с кошница, и тази кошница може автоматично да се попълва от файл CSV. За да заредите кошницата автоматично, натиснете бутона Добавяне на стока и изберете Зареждане на CSV. В отворилия се прозорец изберете файла, който трябва да заредите на вашето устройство.

Могат да се заредят 2 вида файлове, които съдържат:
- само кошница (ORDER_BUNDLE)
- кошница (ORDER_BUNDLE) и данни за поръчката (ORDER_PARAMS).
Обърнете внимание, че нито едно поле не е задължително, и само някои от тях могат да бъдат използвани за попълване на кошницата.
Възможни полета на данни за кошницата:
-
ItemCode- код на стоката в системата на магазина. -
Price- цена за единица стокова позиция. -
Amount- сума на плащането в минимални единици валута (стотинки, центове и т. н.). Не повече от 12 символа. -
Measure- мерни единици, например: л — литри, бр. — броя -
Quantity- общо количество стокови позиции с един PositionId и тяхната мярка за измерване. Описанието на неговите атрибути е представено по-долу. -
Name- наименование или описание на стоката или услугата в свободна форма.
Възможни полета с данни за поръчката:
-
OrderNumber- номер на поръчката (ID) в системата на търговеца, трябва да бъде уникален за всеки търговец. -
TotalAmount- сума на поръчката плюс комисионната, ако такава има. -
Merchant- логин на продавача в системата на платежния шлюз. -
Currency- код на валутата на плащането ISO 4217. -
Language- Ключ на езика по ISO 639-1. Ако езикът не е указан, се използва езикът по подразбиране, указан в настройките на магазина. -
AuthType- тип автентификация, възможни стойности:0-PURCHASE,1-PRE_AUTH. -
Email- електронен адрес на клиента. -
Phone- Номер на телефона на купувача. Винаги трябва да се указва код на страната, при това може да се указва или да не се указва знакът +. -
Full name- пълно име на клиента. -
INN- ИНН. -
Passport- паспортни данни. -
Sender- адрес на електронната поща на изпращача. -
Description- описание на поръчката в произволен формат. -
ClientId- номер на клиента (ID) в системата на търговеца — до 255 символа. -
Payment period- задайте дата и час преди поръчката да бъде платена. Например, 5D– 5 дни, 22H – 22 часа, 10M – 10 минути.
Пример за файл с данни за кошницата:
ItemCode,Price,Amount,Measure,Quantity,Name
1,10,20,pieces,2,applesПример за файл с данни за поръчката и кошницата:
Важно: За да се осигури подходяща обработка на файла, стойностите на полетата във файла не трябва да съдържат запетаи. Запетаите могат да се използват само като разделители на полетата и техните стойности.
Пример за некоректно попълване на полета във файла:
ItemCode,Name,Amount,Quantity,Measure,Price
123,apples,golden,20000,1,kg,20000Пример за коректно попълване на полета във файла:
ItemCode,Name,Amount,Quantity,Measure,Price
123,apples golden,20000,1,kg,20000Провеждане на пробно плащане
Можете самостоятелно да тествате процеса на плащане от лицето на клиента. За това:
-
Формирайте сметка за клиента.
Преминете към платежната страница, натискайки на бутона Връзка за плащане в съобщението за успешно издаване на сметка.

Изберете начин на плащане. При плащане с карта, въведете данните на една от тестовите карти.
Отбележете Запази моята карта ако искате да създадете връзка: в този случай следващия път няма да се налага да въвеждате данните на картата.
Натиснете бутона Плати. За потвърждение на операцията използвайте указания за тестовата карта код 3-D Secure.
Финална страница
Може да се настроят приемането на плащания така, че след успешно плащане клиентът да бъде пренасочен към Финалната страница. На тази страница се намират данните за плащането и връзка обратно към магазина.

В таблицата по-долу са описани данните, показвани на финалната страница.
| Поле | Описание |
|---|---|
| Номер на поръчката | Автоматично генериран номер на поръчката в системата на продавача. |
| Код за авторизация | Код за авторизация на международната платежна система (6 символа). |
| Терминал ID | Идентификатор на терминала в системата, обработваща плащането. |
| Уникален код на операцията (RRN) | Уникален идентификатор на банковата транзакция. |
| Сума на плащането | Сума на плащането. |
| Комисионна за плащането | Сума на комисионната за плащането (ако има). |
| Обща сума на плащането | Сума на плащането с включена комисионна. |
| Номер на картата | Маскиран номер на картата, използвана за плащането. |
| Срок на валидност на картата | Срок на валидност на картата, използвана за плащането. |
За да се върне в магазина, клиентът трябва да натисне връзката Връщане в магазина.
Можете да включите или изключите показването на финалната страница, като поставите отметка в Показвай финална страница на страницата Общи настройки в личния ви кабинет. Подробно четете тук.
Масова рассылка на сметки за плащане
Ако имате съответното разрешение, можете да изпратите на клиентите няколко сметки за плащане наведнъж, като качите файл във формат CSV с данните на сметките и адресите на електронна поща. Форматът на файла се определя от шаблон, който се настройва от екипа за поддръжка.
Пример за съдържание на файла (сума на операцията, кодове на валутата, електронна поща):
Качване на файл за рассылка
За да качите файл за рассылка:
-
Отидете в раздел Сметка за плащане и отворете раздела Няколко. Страницата показва списъка на качените по-рано файлове (ако има такива).

-
Натиснете Създай. Ще се отвори диалог, където можете да свалите шаблон за създаване на файла. Свалете шаблона и го попълнете с нужните стойности.

-
Изберете или плъзнете в съответното поле файл за зареждане. Ако искате връзките за плащане веднага след зареждането да бъдат изпратени на клиентите, отбележете отметката Изпрати сметки на клиентите, а след това натиснете Създай и изпрати връзки. Ако искате просто да създадете връзки без изпращане, премахнете отметката Изпрати сметки на клиентите и натиснете Създай връзки.

-
В списъка с обработени файлове ще се появи нов ред със заредения файл. Докато файлът се формира, в колоната Завършено се показва статус "В процес". Когато файлът бъде обработен, в тази колона ще се показва датата и часът на завършване на обработката на файла. В колоната Изпратено се показва отметка, ако връзките за плащане са били изпратени на клиентите.

Преглед на детайли на обработения файл
За да прегледате съдържанието на обработения файл за разпращане, отидете в раздел Сметка за плащане, отворете раздел Няколко и щракнете върху реда на заредения файл. Ще се отвори страница с детайли за всяка сметка.

Таблицата съдържа следните колони с детайли за всяка сметка:
- Транзакция — връзка към транзакцията по дадената сметка
- Статус — статус на изпращане на сметката на клиента
- Сума — сума на транзакцията
- Ел. поща — адрес на електронната поща за изпращане на сметката
- Връзка — връзка към страницата за плащане
Експорт на обработения файл
За да експортирате обработения файл, отидете в детайлите на файла и натиснете бутон Експорт. Файлът ще бъде експортиран във формат CSV със следните полета:
-
itemId— задължително поле, пореден номер на обработения ред от файла -
successful— задължително поле, успешност на обработката на реда (true / false) -
reason— задължително поле, описание на грешката (ако няма грешки, това поле е празно) -
link— задължително поле, формирана връзка за плащане -
email— адрес на електронната поща, който е бил указан при зареждането (ако този параметър е бил зададен в шаблона)
В изходния файл могат да има и други полета, ако са били зададени в шаблона.
Отчети
Разделът Отчети позволява генериране на отчети по транзакции, основавайки се на множество параметри по избор. За да покажете страницата Отчети, натиснете на иконата
в лявата странична лента.
Изберете логин на търговеца, по транзакциите на когото искате да построите отчет. Няколко логина могат да бъдат достъпни, ако имате разрешение за преглед на транзакциите на други търговци или имате дъщерни търговци.
На страницата са представени няколко филтъра за генериране. Можете да изберете транзакции по дата:
- Дата на създаване
- Дата на връщане
- Дата на завършване
- Дата на плащане
- Дата на отмяна
Задайте необходимия диапазон от дати или изберете конкретен период с дати с помощта на календара.

Също така можете да филтрирате транзакциите по техния статус.

Отчетът може да бъде изтеглен във файл с формат .xls или .csv. Изберете формата с кликване върху съответните бутони.

Използвайки бутона Добави шаблон колони, можете да създадете шаблон на полета за по-нататъшно използване в отчетите. След натискане на бутона ще се появи форма за настройка на колоните. Въведете наименованието на шаблона и отбележете колоните, които трябва да бъдат показани в отчета. Някои колони са взаимосвързани за удобство на потребителя:
- Валута: автоматично се отбелязва при избор на каквато и да е сума (включително сума на връщане, сума за потвърждение, сума на комисионната, сума на потвърждението, сума на предавторизацията).
- Статус: автоматично се отбелязва при избор на някои дати (отмяна, последно връщане, списване).
След избора на колоните кликнете Създай шаблон.

Запазеният шаблон ще бъде достъпен за избор в списъка Шаблон колони.
Задавайки нужните параметри, натиснете бутона Генерирай отчет. Ще започне формирането на отчета в зададения формат. В зависимост от настройките на вашия браузър файлът с отчета ще бъде запазен или ще се появи диалогов прозорец за запазване на файла.
Платежни връзки
Можете да създавате шаблони на платежни връзки, които ще пренасочват клиента към страницата за плащане.
Създаване на платежна връзка
За да създадете връзка към страницата за плащане, влезте в личния кабинет, в левия страничен панел изберете Връзки за плащане, а след това натиснете Създаване:
Можете също да създадете връзка за плащане, като натиснете в горната част на личния кабинет бутона Създаване и изберете Връзка за плащане.

Ще се появи формуляр за попълване:
Попълнете необходимите полета, ръководейки се от таблицата по-долу.
| Задължителност | Поле | Описание |
|---|---|---|
| Задължително | Наименование на връзката | Название на връзката, която е достъпна само за продавача |
| Незадължително | Описание | Описание на поръчката, което е видимо само за продавача |
| По подразбиране | Тип плащане | Тип на операцията за плащане. Достъпни стойности: Едностепенно, Двустепенно. По подразбиране е избрано едностепенно плащане. За да се показва полето, двустепенното плащане трябва да бъде включено (обърнете се към службата за поддръжка) |
| По подразбиране | Език | Език на платежната страница. Достъпни стойности: BG/EN |
| Незадължително | Сума за плащане | Въведете сума за плащане. При избор на опцията "Произволна" купувачът може да посочи сума за плащане на платежната страница |
| По подразбиране | Валута | Зададена по подразбиране, стойността се задава в съответствие с настройките на търговеца |
| Незадължително | Действие | Посочете периода на действие на връзката: за това изберете Период и посочете нужните дати за начало и край на връзката от падащия календар. Можете също да ограничите броя на плащанията, като изберете съответната опция. Ако е избрана опцията Неограничено, то това поле не е достъпно за редактиране |
При необходимост попълнете допълнителните параметри в раздела Допълнителни параметри.
| Поле | Описание |
|---|---|
| Адрес | Дали да се показва полето за адрес на доставка на предплатежната страница |
| Електронна поща | Дали да се показва полето за въвеждане на e-mail на клиента на предплатежната страница |
| ЕГН | Дали да се показва полето за въвеждане на име и фамилия на клиента на предплатежната страница |
| Телефон | Дали да се показва полето за въвеждане на номер на телефон на клиента на предплатежната страница |
Има също възможност да добавите свои параметри. За това натиснете Добавяне на параметър и попълнете полетата:

| Поле | Описание |
|---|---|
| Име на параметъра | Изисква се за платежния шлюз. Допускат се само латински символи и символи за подчертаване. Например: size, items_count и т. н. |
| Заглавие на полето | Наименование на параметъра, което вижда клиентът на платежната страница. |
| Показване в PDF-разписката | Отметка, която трябва да се постави, ако новият параметър се показва в PDF-разписката. |
| Стойност | Стойност на параметъра. Ако е избрано Фиксирано, въведете стойност в полето Стойност на полето - клиентът няма да може да променя тази стойност. Ако е избрано Задава се от клиента, клиентът може да задава стойността на параметъра. В този случай въведете подсказка с пример за попълване в полето Текстова подсказка и задайте условие за проверка на стойността в полето Валидация (Без ограничения, Само цифри, Регулярен израз). |
| Задължително поле | Отметка, която трябва да се постави, ако новият параметър е задължителен за клиента |
След като попълните всички необходими полета, натиснете Създаване в долната част на формуляра. След това връзката ще се покаже на главната страница със статус Активна:

Възможни действия с шаблона на платежна връзка
При натискане на иконката
са достъпни следните действия с платежната връзка:
-
Споделяне на връзката — натиснете Споделяне.

-
Копиране на връзка - натиснете на иконата за копиране. Ще се появи уведомление, че връзката е успешно копирана.

-
Изтегляне на QR-код — ще видите генерирания QR-код, а също така ще можете да изтеглите изображението му в избрания формат, като натиснете Изтегляне на QR-код.

Освен това са налични следните действия:
-
Деактивиране/активиране и изтриване — достъпни при натискане на иконата с три точки в реда на връзката.

Редактиране — щракнете върху нужната връзка, за да видите подробности за създадената връзка и да я редактирате. За изпълнение на описаните по-горе действия можете също да използвате съответните бутони на тази страница.

-
Филтър — за да формирате друга извадка от платежни връзки, натиснете Повече филтри в горната част на страницата Връзки за плащане. Ще се отвори страница за избор на филтри:

Изберете необходимите критерии за търсене и натиснете Прилагане в прозореца на филтъра. За да изчистите всички полета на филтъра, натиснете бутона Нулиране на филтри.
Можете да търсите по следните параметри:
- Продавач — При необходимост изберете продавач от списъка с достъпни продавачи, чиито платежни връзки трябва да бъдат избрани
- Наименование — име на връзката, което сте посочили при създаване на връзката
- Идентификатор на връзка — идентификатор на шаблона на платежна връзка
- Статус — възможни са три статуса на връзката: "Активна"/"Неактивна"/"Изтрита". Обърнете внимание, че изтритите връзки не се показват в таблицата, ако в филтъра изрично не се избере статус "Изтрита"
- Сума от - Сума до — Сума на поръчката (тези полета не са достъпни за редактиране, ако е активирана опцията Всяка сума)
- Валута — изберете валута от падащото меню
- Всяка сума — активирайте опцията, ако сумата като критерий за търсене не е важна
- Период на действие — срок на действие, установен за връзката. Натиснете върху датите и изберете в календара дата на започване и дата на изтичане на срока на действие (полето не е достъпно за редактиране, ако е активирана опцията Безсрочна)
- Безсрочна — активирайте опцията, ако срокът на действие на връзката като критерий за търсене не е важен
Предплатежна страница / Страница за плащане
Ако при създаване на връзката са посочени допълнителни параметри (E-mail/ФИО/Телефон/Адрес) или полето за сума на платежа е оставено празно, след отваряне на платежната връзка клиентът трябва да попълни задължителните полета на предплатежната страница и едва тогава да премине към плащане на поръчката.
Пример за предплатежна страница с допълнителни параметри:

Пример за страница за плащане:

Работа с транзакции
Страница Транзакции съдържа подробни сведения за поръчките и плащанията. За да преминете към страницата, натиснете бутона
в лявата странична лента.
В горната част на страницата Транзакции се намира областта за търсене, позволяваща да зададете критерии за показване на транзакциите. Списъкът на страницата съдържа транзакции, отговарящи на критериите за търсене.
Търсене на транзакции с помощта на филтър
За работа с транзакции е необходимо първо да зададете и приложите критериите за търсене.
За да зададете критерии за търсене на транзакции, изпълнете следните действия.
- В личния кабинет преминете към страницата Транзакции.
- В областта за търсене отгоре задайте необходимите параметри. За да добавите повече критерии за търсене, натиснете Повече филтри, добавете нужните филтри и натиснете Приложи.

Подходящите по условията транзакции ще се покажат в списъка.
За да повторите търсенето на транзакции в бъдеще, можете да копирате връзката за търсене от адресния ред или да я добавите в отметките на браузъра.
За нулиране на филтрите натиснете Нулирай.
Параметри на филтъра за транзакции

Филтърът позволява да зададете критерии за отбор на проведените транзакции.
-
Диапазон от дати — В първия падащ списък посочете по коя дата да се прави извадката. Например, Дата на създаване. Във втория падащ списък посочете типа задаване на времеви интервал:
-
Диапазон от дати — позволява да зададете времеви интервал, като изберете в календара началната и крайната дати;
-
Период — позволява да изберете за какъв текущ период ще бъдат показани транзакциите: денонощие, седмица, месец или година.
-
Диапазон от дати — позволява да зададете времеви интервал, като изберете в календара началната и крайната дати;
- Сума — Сума на поръчката. Посочете горната и долната граница на диапазона.
-
Статус — Статус на поръчката. Достъпни са следните статуси (множествен избор):
-
Създадена. Сметката е издадена, но още не е платена.
-
Потвърдена. Сметката е платена. Средствата се резервират по сметката на платеца.
-
Завършена. Средствата се списват от сметката на платеца.
-
Отменена. Всички средства се връщат на платеца.
-
Отхвърлена. Сметката е издадена, но не е платена навреме.
- Възстановяване. Извършено е частично възстановяване.
-
Създадена. Сметката е издадена, но още не е платена.
- Номер на поръчката — Номер, автоматично присвоен на поръчката в магазина. Ако трябва да намерите определена поръчка, посочете тук нейния номер.
- Потребителско име на продавача — Потребителското име на продавача в системата на платежния шлюз. Посочете своето потребителско име (показва се в горния десен ъгъл).
- Последни 4 цифри от картата — Четирите последни цифри от номера на картата на платеца, използвана за плащане на поръчката. Ако търсите транзакции по конкретна карта и знаете нейния номер, посочете тук последните й четири цифри.
Описание на други критерии за търсене вж. тук.
Таблица на транзакциите
Таблицата на транзакциите се намира на страницата Транзакции. Транзакциите се появяват в таблицата след като е приложен филтърът.
По подразбиране таблицата съдържа следните колони с атрибути на транзакциите:
Сума — Сума на поръчката.
Статус — Статус на поръчката.
Код на отговора — Цифров код на резултата, получен от процесинга на банката (action code). Вж. списъка на кодовете на отговора тук.
Номер на поръчката — Номер на поръчката в системата на магазина.
Платежно средство — Платежно средство, което е било използвано за плащане на поръчката.
Дата на регистрация — Дата, когато транзакцията е била регистрирана.
Описание на поръчката — Произволно описание на стоките и услугите.
Експорт на списъка на транзакциите
В някои случаи може да се наложи да експортирате вашите транзакции. Налични са три формата: XLS, CSV и XML. За това:
- Намерете необходимите поръчки, като посочите необходимите критерии за търсене с помощта на филтъра.
- Натиснете бутона Експорт, изберете един от трите формата, предложени за запазване: XLS, CSV и XML.
- Ще започне формирането на отчета в зададения формат. В зависимост от настройките на вашия браузър файлът на отчета ще бъде запазен или ще се появи диалогов прозорец за запазване на готовия файл.
Подробни данни за транзакцията
В личния кабинет е достъпна подробна информация за всяко плащане.
За да научите повече за плащането, намирайки се на страницата Транзакции, щракнете върху реда на интересуващата транзакция в таблицата.
Ще се отвори страницата Детайли на транзакцията. Тя винаги съдържа разделите Детайли на операцията операция и Активност.
За транзакции от определен тип може допълнително да се показва разделът Връщане на средства.
Също така в зависимост от статуса и типа на транзакцията, могат да се показват бутоните Завърши и Връщане.
Бутонът Завърши позволява потвърждение на двуетапно плащане от клиента. Този бутон е активен само когато поръчката получи статус Потвърден.
Бутонът Връщане позволява пълно или частично връщане на средства на клиента. Функционалността на бутона зависи от статуса на поръчката и наличието в нея на кошница със стоки:
- В поръчки със стокова кошница в статус Потвърден щракването върху бутона Връщане отваря раздела Връщане на средства, където може да се изберат стокови позиции за връщане или да се върне цялата сума на поръчката.
- Във всички останали поръчки щракването върху бутона Връщане отваря прозореца за връщане на средства, където се указва само стойността на сумата.
Детайли на операцията
Разделът Детайли на операцията съдържа следните секции:
- Платежни данни. В тази секция са показани платежните атрибути на транзакцията.
- Информация за клиента. Тук е представена информация за платежното средство и неговия притежател.
- Метаданни. Допълнителни технически параметри.
- Стоки. Информация за това, кои стоки или услуги са платени в рамките на транзакцията (показва се, само ако в поръчката е присъствала кошница със стоки).
Секцията Детайли на операцията съдържа следните полета:
| Поле | Описание |
|---|---|
| Номер на поръчката | Номер на поръчката в системата на магазина. |
| Уникален номер на поръчката в системата | Идентификатор на поръчката в платежния шлюз. |
| Код на отговора | Цифров код на резултата, получен от процесинга на банката (action code). Вж. списъка с кодове на отговора тук. |
| Платежно средство | Платежното средство, което е било използвано за плащане на поръчката. |
| Комисионна | Сума на комисионната, ако се е взимала комисионна. |
| Сума на регистрацията | Сума на поръчката. |
| Потвърдена сума | Сума на блокирането (за двуетапни поръчки). |
| Сума на списването | Сумата, която в крайна сметка е била списана. |
| Сума за връщане | Сума на връщането, ако се е извършвало връщане. |
| Дата на създаване | Дата и час на създаване на поръчката. |
| ECI |
Electronic Commerce Indicator. Възможни стойности:
|
| Описание на поръчката | Произволно описание на стоките и услугите |
Секцията Информация за клиента съдържа следните полета:
| Поле | Описание |
|---|---|
| Номер на картата | Маскиран номер на картата, използвана за плащането. |
| IP адрес | IP-адресът на платеца. |
| Срок на валидност | Срок на валидност на картата на платеца. |
| Платежна система | Наименование на международната платежна система, към която принадлежи картата на платеца. |
| Име на притежателя на картата | Име на притежателя на картата, посочено при регистрацията на поръчката. |
| Адрес на електронната поща на платеца. |
Секцията Стоки съдържа информация за това, кои стоки или услуги са платени в рамките на транзакцията.
| Колона | Описание |
|---|---|
| ID | Номер на стоковата позиция в кошницата. |
| Наименование | Наименование на стоковата позиция. |
| Артикул | Цифрово или буквено обозначение, предназначено за класификация на стоковата позиция. |
| Цена | Цена за единица стокова позиция. |
| Кол-во | Количество единици стокова позиция. |
| Сума | Обща сума за всички единици от една стокова позиция (изчислява се автоматично). |
| Връщане | Сведения за връщането на средства. Показва се само ако е имало връщане. |
Активност
На раздела Активност се съдържа информация за всички събития по поръчката: постъпления на плащания, връщания и т.н.
| Колона | Описание |
|---|---|
| Тип | Операции, предприемани в процеса на работа с поръчката |
| Статус | Статус на операцията |
| Дата | Дата на провеждане на операцията |
| Описание | Сума на поръчката |
Възстановяване на средства
Разделът Възстановяване съдържа информация за стоковите позиции в поръчката и позволява да се осъществи възстановяване на средствата на платеца.
Можете да възстановите цялата сума изцяло или да осъществите възстановяване по някои стокови позиции.
Пълно възстановяване по транзакция
За да направите пълно възстановяване на средствата на платеца по поръчката, изпълнете следните действия:
Намирайки се на раздела Възстановяване на средства, натиснете бутона Пълно възстановяване. Поръчката ще премине в статус Отменена или Възстановяване, в зависимост от стадийността на плащането и датата на изпълнение на възстановяването.

Възстановяване по стокови позиции
За възстановяване на средства по стокови позиции изпълнете следните действия:
-
Намирайки се на раздела Възстановяване, използвайте таблицата със състава на кошницата.
Колона Описание Код Номер на стоковата позиция в кошницата. Наименование Наименование на стоковата позиция. Артикул Цифрово или буквено обозначение, предназначено за класификация на стоковата позиция. Цена Цена за единица стокова позиция. Кол-во Количество единици стокова позиция. Сума Обща сума за всички единици от една стокова позиция (изчислява се автоматично). Кол-во за възстановяване Количество единици стока, което трябва да бъде възстановено. Сума за възстановяване Сума, която ще бъде възстановена. Полето се изчислява автоматично. В полето Кол-во за възстановяване посочете количеството отменяеми единици стока. Възстановяваната сума ще се покаже в полето Сума за възстановяване.
Натиснете бутона Възстановяване.
Ако сумата на възстановяването е по-малка от сумата на поръчката, поръчката ще премине в статус Възстановяване. Ако е възстановена пълната сума на поръчката, поръчката ще премине в статус Отменена.
Налични действия на страницата на транзакцията
Основни действия с транзакции в личния кабинет:
Тези операции се извикват със съответните бутони на страницата информация за транзакцията. Подробно описание на всяка операция вижте по-долу.
Отмяна на поръчка
Обикновено поръчката, която не е била платена или предавторизирана, автоматично се отменя след определено време, зададено в системата, например, след 20 минути. Но тази операция може да се извърши и ръчно от личния кабинет на продавача.
Ако искате да отмените поръчката преди плащане или предварителна авторизация, можете да го направите, като натиснете бутона Отхвърли на страницата информация за транзакцията.

След отмяната поръчката получава статус Отхвърлена.
Завършване на поръчка
При двуетапно плащане средствата първо се замразяват в сметката на клиента (статус на поръчката — Потвърдена) и едва тогава се прехвърлят в сметката на продавача (статус на поръчката — Завършена). Възможна е настройка, така че окончателното превеждане да става автоматично след определено зададено в системата време, например, след 24 часа. Но тази операция може да се извърши ръчно от личния кабинет на продавача.
За да завършите транзакцията, на страницата Информация за транзакцията натиснете бутона Завърши.

Ще се отвори прозорец за потвърждение. Неговият вид е показан по-долу и зависи от това дали в поръчката е използвана кошница на стоки или не.
Ако кошницата НЕ е използвана, прозорецът за потвърждение изглежда така:

Проверете стойността в полето и натиснете бутона Потвърди.
Ако кошницата е използвана, прозорецът за потвърждение изглежда така:
Проверете данните, при необходимост ги променете и натиснете бутона Завърши. След завършването поръчката получава статус Завършена.
При наличие на съответното разрешение можете да направите промени в кошницата така, че сумата на завършване да надвишава сумата на предавторизацията. Процентът на превишаване на сумата на депозита може да бъде всякакъв — задава се с определена настройка. За свързване на такава възможност се обърнете към службата за техническа поддръжка.
Например, в настройките е зададен процент на превишаване на сумата на депозита — 100%. В платежната форма сте изложили сума 2700 руб. Тогава можете да промените кошницата така, че сумата на поръчката да не превишава 5400 руб. В случай на превишаване ще се покаже грешка и бутонът Завърши ще стане недостъпен:
Отмяна на потвърдена поръчка
В личния кабинет можете да отмените плащания по двуетапни транзакции в статус Потвърдена (когато средствата са резервирани в сметката на клиента, но още не са прехвърлени). Отмяната означава, че транзакцията се отменя и всички средства, резервирани в сметката на клиента, се разблокират.
За да отмените плащането, на страницата информация за транзакцията натиснете бутона Възвръщане.

Функционалността на бутона зависи от статуса на поръчката и наличието в нея на кошница на стоки: Ако статусът на поръчката е Потвърдена и няма кошница на стоки, то се отваря прозорец за потвърждение на възвръщането.

Ако въведете само част от сумата, указаната сума ще бъде върната, а поръчката ще остане в статус Потвърден. Ако въведете пълната сума, то поръчката ще премине в статус Отменен.
В прозореца за потвърждение натиснете Потвърди.
Възстановяване на средства
От личния кабинет може да се извърши възстановяване на средства по извършени транзакции (платени от клиенти поръчки, които се намират в статус Завършен). За двуетапните плащания статус Завършен означава, че средствата, намиращи се на картата на платеца, вече са списани.
Възстановяването се осъществява на страницата за информация за транзакцията с помощта на бутона Възстановяване.

Функционалността на бутона зависи от статуса на поръчката и наличието в нея на кошница със стоки:
- В поръчки със стокова кошница в статус Потвърден натискането на бутона Възстановяване отваря раздела Възстановяване на средства, където може да се изберат стокови позиции за връщане или да се върне цялата сума на поръчката. Процесът на възстановяване за такива поръчки е подробно описан тук.
- В поръчки без стокова кошница в статус Потвърден натискането на бутона Възстановяване отваря прозорец за потвърждение на възстановяването.

Проверете сумата за възстановяване. Можете да върнете цялата сума или да укажете по-малка сума. Натиснете Потвърди. Поръчката ще премине в статус Възстановяване. Ако на предишния етап сте решили да върнете по-малка сума, можете да правите възстановявания докато не бъде върната цялата сума
Тип възстановяване в зависимост от етапността, статуса на плащането и наличието на стокова кошница
В таблицата по-долу са показани всички варианти за възстановяване в зависимост от това в какъв статус се намира плащането, колко етапа има в него, и има ли в него кошница със стоки. Тази или онази функционалност може да не е достъпна, ако вашият потребител няма съответните права в системата. Общият принцип е такъв, че при възможност за отмяна на поръчката се прави отмяна, а ако няма такава възможност, то се осъществява възстановяване на средства.
| С кошница | Без кошница | |
| Едноетапен | Завършен - възстановяване по стокови позиции | Завършен - възстановяване по сума, възможно частично |
| Двуетапен |
Потвърден - отмяна, само пълна сума Завършен - възстановяване по стокови позиции |
Потвърден - отмяна, само пълна сума Завършен - възстановяване по сума, възможно частично |
Електронни портфейли и сертификати
Платежният шлюз поддържа токенизирано плащане с помощта на електронни портфейли Apple Pay и Google Pay.
Документацията е достъпна тук
Каталог на стоки
Разделът Каталог на стоки позволява бързо избиране на стоки при създаване на сметка за плащане. За да влезете в раздела Каталог на стоки, натиснете
в лявото меню.
Страницата на раздела изглежда по следния начин:
За започване на работа изберете мърчант от падащия списък, изтеглете шаблона на каталога, като натиснете бутона Изтегли шаблон на каталога, и попълнете параметрите на стоката:
След това качете готовия каталог на стоки във формат .CSV, използвайки бутона Импорт на файл с продукти:
Или добавете стока, използвайки бутона Ново.

Ще се отвори форма за попълване на информация за стоката.

Попълнете необходимите полета, ръководейки се от таблицата по-долу.
| Поле | Описание |
|---|---|
| Наименование | Наименование на стоката или услугата. |
| Цена | Цена за единица стокова позиция. |
| Мерна единица | Мерна единица, например: л — литри, бр. — броя. |
| Артикул | Артикул на стоковата позиция. |
След качването на каталога на стоки или стока/и поотделно ще можете да добавяте стоки от каталога при издаване на сметка за плащане. Подробно за това как да добавяте стоки от каталога, вижте в раздела Сметка за плащане.
Освен добавянето на стока в каталога, можете, в случай на необходимост, да внесете промени в параметрите на добавената стока, или изцяло да я изтриете от каталога. За това е необходимо да насочите курсора към реда на стоката в списъка и да натиснете съответния бутон:

При натискане на бутона за редактиране ще се отвори форма за промяна на стоката:

При натискане на бутона за изтриване на стоката ще се отвори прозорец за потвърждение или отмяна на действието:

Бързи бутони
Разделът Бързи бутони позволява бързо да свържете бутони за плащане чрез Apple Pay / Google Pay на вашия сайт. За да отворите раздела Бързи бутони, натиснете
в лявата навигационна панел.
Ще се отвори страница:
Страницата съдържа два раздела: Домейни и Генератор на код.
Домейни
Разделът Домейни позволява да регистрирате домейна на вашия магазин в Платежната врата с проверка от Apple Services. Това е необходимо, за да започнете да получавате плащания чрез Apple Pay.
Apple Pay генерира файл за проверка, който е необходимо да поставите в следната подпапка на вашия домейн преди регистрацията:
/.well-known/apple-developer-merchantid-domain-association
За да регистрирате домейн, натиснете бутона Добавяне на домейн. Ще се отвори прозорецът Добавяне на домейн.
- В полето Име на домейн въведете името на домейна от високо ниво (например, example.com) или от трето ниво (например, shop.example.com), който искате да използвате за плащания Apple Pay.
- Свалете файла за проверка Apple Pay.
- Поставете файла по указания път на вашия уеб сървър:
https://<DOMAIN NAME>/.well-known/apple-developer-merchantid-domain-association. - Натиснете бутона Добавяне на домейн.
Домейнът на магазина ще бъде регистриран в Платежната врата с възможност за приемане на плащания Apple Pay.
Името на домейна ще се показва в списъка с домейни в раздела Домейни.
Генератор на код
Този раздел съдържа конструктор за генериране на код на скрипт Payment Widget, който се използва за бързо свързване на бутони Apple Pay и Google Pay на страницата на магазина. Вижте подробно тук.
Разделът включва следните секции за задаване на параметри за инициализация на скрипта:
-
Общи настройки - укажете обща информация за регистрация на поръчка в Платежната врата:
- Включване на плащане чрез Apple Pay и/или Google Pay,
- Номер на поръчка,
- Сума (задължително),
- Валута (изберете от списъка),
- Език (изберете от списъка),
- Среда (тестова или работна)
- Страница за успешно плащане и Страница за неуспешно плащане (укажете URL или изберете стандартен URL).
- Заявка за потребителски данни - укажете данни, които ще бъдат задължителни по време на плащането чрез PaymentRequest API за Google Pay. Задайте съответните отметки: Име, E-mail, Номер на телефон, Пощенски адрес.
- Настройки на платежни бутони - укажете типа на външния вид и стила на бутоните Apple Pay и Google Pay. В раздела е достъпен предварителен преглед на бутона.
- Код за вмъкване на вашата страница - този раздел съдържа предварителен преглед на кода за инициализация на скрипта в съответствие с указаните параметри. Този код е необходимо да вмъкнете на вашата страница.