Упълномощаване
За да влезете в личния си кабинет, изпълнете следните действия.
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 метод
Изберете един от двата предложени начина: GET или POST.
Връзка
Въведете URL адреса, на който ще се изпращат известията, например: https://test.com. Разрешава се да се посочват няколко връзки (чрез запетая и без интервали).
Допълнителни параметри
Изберете параметрите, които ще пристигат в callback известието.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Могат да се зареждат два вида файлове, които съдържат:
- само кошница (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-код, както и ще можете да изтеглите неговото изображение в избрания формат (PNG/SVG/JPEG).
Освен това са налични следните действия:
-
Деактивация/активация и изтриване — налични при натискане на иконата с три точки в реда на връзката.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Бързи бутони
Разделът Бързи бутони позволява бързо да свържете бутони за плащане чрез 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. В раздела е достъпен предварителен преглед на бутона.
- Код за вмъкване на вашата страница - този раздел съдържа предварителен преглед на кода за инициализация на скрипта в съответствие с указаните параметри. Този код е необходимо да вмъкнете на вашата страница.