Оторизация

За да влезете в личния си кабинет, изпълнете следните действия.
1. Отворете страницата на личния кабинет.

TEST: https://vpostest.dskbank.bg/auth/login
PROD: https://vpos.dskbank.bg/auth/login

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


2. В полетата Логин и Парола въведете съответно своя логин и парола на оператора.
3. Натиснете бутона Вход.
Ако данните са въведени правилно, ще бъде осъществен вход в личния кабинет.

Изход от системата

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

Промяна на езика на интерфейса

За да промените езика, на който се показва интерфейсът на личния кабинет, изпълнете следните действия.

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

Работа с API

С помощта на API можете да създавате уникални платежни интеграции. Например, да свържете плащане със специално създадена платежна страница. Допълнителна информация за API е достъпна тук. При създаването на Търговец получавате писмо с потребителско име и еднократна парола. След това можете самостоятелно да генерирате парола за API на страницата Работа с API в портала на продавача.

За да се покаже страницата Работа с API, натиснете в лявата странична панел.

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

Достъпни са следните действия:

• Създаване на парола за API. За това натиснете Създаване на парола за API.
  

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

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

Настройки

За да влезете в раздел Настройки, в лявото навигационно меню на личния кабинет изберете пункт Настройки (икона ).

Разделът Настройки позволява

• да зададете основни настройки
• да включите уведомления за обратно повикване
• да промените паролата за достъп до личния кабинет
• да укажете адрес на електронна поща за възможност за възстановяване на паролата към личния кабинет
• да зададете параметри за работа на личния кабинет (недостъпно в демонстрационната версия)

Основни настройки

Разделът Основни настройки позволява на служителя на магазина да настройва определени параметри на потребителския акаунт и разрешения.

За да преминете към раздел Основни настройки, изберете Настройки в страничното меню, а след това изберете Основни настройки в блока Продавач. Ще се покаже страница с настройки на акаунта, както е показано по-долу.

Описанието на настройките е приведено в таблицата по-долу:

Натиснете бутона Запази.

Callback-известия

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

Допълнителна информация за известията за обратно повикване е достъпна тук. Разделът Callback-известия е достъпен тук: Настройки → Продавач → Callback-известия.

Ако потребителят има афилирани продавачи, изборът на продавач става достъпен в падащото меню Продавач. За да включите настройките за известия за обратно повикване, кликнете върху превключвателя Callback-известията са изключени:

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

Тип callback

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

HTTP-метод

Изберете един от двата предложени начина: GET или POST.

Връзка

Въведете URL, към който ще се изпращат известията, например: https://test.com. Позволено е да се посочват няколко връзки (разделени със запетая и без интервали).

Допълнителни параметри

Въведете реда на параметрите, които ще бъдат предадени в callback-а, разделени със запетая.

Тип подпис

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

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

Операции

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

Смяна на парола

За да промените паролата за достъп до личния кабинет, изпълнете следните действия.

1. Влезте в личния кабинет.
2. В панела за управление отляво отидете в раздел Настройки, като натиснете иконата .
3. На показаната страница изберете раздел Смяна на парола. Страницата ще приеме следния вид.
   
4. В полето Текуща парола въведете текущата си парола.

5. В полетата Нова парола и Нова парола отново въведете новата парола.

   Паролата трябва да отговаря на следните изисквания:

   1. Паролата не трябва да съдържа името на магазина или потребителското име на един от потребителите, свързани с търговеца, към който принадлежи потребителят, променящ паролата (включително промяна на регистъра).
   2. Въвежданата от потребителя парола задължително трябва да съдържа символи от изброените по-долу групи:
      • главни букви от латинската азбука (A-Z)
      • малки букви от латинската азбука (a-z)
      • цифри (0-9)
      • специални символи (! "#;:? * () + = < > , . { } )
   3. Дължината на паролата трябва да бъде не по-малко от 8 символа.

6. Кликнете на бутона Смени парола.

Адрес на електронна поща

Задайте адрес на електронна поща, който ще се използва за възстановяване на достъпа до личния кабинет.

1. Влезте в личния кабинет.
2. В панела за управление отляво отидете в раздел Настройки, като натиснете иконата .
3. В раздела Адрес на електронна поща въведете адреса, който ще се използва за възстановяване на достъпа.
4. Натиснете Запази.

На посочения адрес на електронна поща ще бъде изпратено писмо за потвърждение. След като адресът на електронната поща бъде потвърден, редактирането на адреса на тази страница няма да бъде достъпно. Ако трябва да промените адреса на електронната поща отново, обърнете се към екипа за поддръжка.

Двуфакторна автентикация

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

За настройка на двуфакторна автентикация в панела за управление отляво отидете в раздел Настройки > Двуфакторна автентикация. На избор се предлагат два начина на автентикация:

Google Authenticator (препоръчително)

1. В приведения списък изберете Google Authenticator (препоръчително) и натиснете бутона Включи.
2. Появява се форма, където трябва да потвърдите паролата си за влизане в Личния кабинет:
   
3. Изтеглете/отворете приложението Google Authenticator на вашето устройство. Въведете тайния ключ или сканирайте QR-кода, за да добавите вашия акаунт в приложението Google Authenticator. Приложението ще генерира код. Въведете генерирания код в полето Въведете 6-цифрения код.
   
4. След като настроите двуфакторната автентикация чрез Google Authenticator, при следващите влизания във вашия Личен кабинет ще се изисква код от Google Authenticator:
   

E-mail код за потвърждение

1. В приведения списък изберете E-mail код за потвърждение и натиснете бутона Включи.
2. Ако вашият адрес на електронна поща не е посочен в настройките и не е потвърден, моля, първо направете това. Ако всичко е настроено, тогава следвайте следващите стъпки по-долу.
3. Появява се форма, където трябва да потвърдите паролата си за влизане в Личния кабинет:
   
4. За завършване на настройката на двуфакторната автентификация, моля, въведете 4-цифрения код, изпратен ви на вашия адрес на електронна поща:
   
5. След като настроите двуфакторната автентификация чрез E-mail, при следващите влизания във вашия Личен кабинет ще се изисква код, който ще бъде изпратен на вашата електронна поща.

Аналитика

За да покажете страницата Аналитика, натиснете иконата в лявата странична панел.

На страницата ще се покажат сведения за транзакциите:

Горното меню позволява да изберете период, за който ще се показва информация за транзакциите. Достъпни са следните стойности:

• Денонощие;
• Седмица;
• Месец;
• Година.

Графиката Конверсия показва процентното съотношение на успешните транзакции към общия брой транзакции.

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

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

При това на графиката се показват следните полета:

• Общо транзакции — общ брой транзакции;
• Успешни — брой успешни транзакции;
• Неуспешни — брой транзакции, при обработката на които е възникнала грешка.

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

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

Издаване на фактура за плащане

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

Изпращане на връзка към платежната форма по email

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

1. Преминете в раздела Фактура за плащане на личния кабинет, като изберете Фактура за плащане в лявото меню. Можете също да отворите този раздел, като натиснете в горната част на личния кабинет бутона Създай и изберете Фактура.
   

2. Ще се покаже страницата за въвеждане на параметри за изпращане:

   

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

   Параметър	Описание
   Имена на клиента	Фамилия, име и бащино име на клиента. Въведените в това поле данни се показват в писмото, съдържащо връзката към платежната страница
   Id на клиента	Идентификатор на клиента в системата на магазина
   Телефон	Номер на телефона. Винаги трябва да се посочва кодът на страната, като може да се посочва или да не се посочва знакът +. По този начин са допустими следните варианти: +449998887766; 449998887766. Допустим брой цифри: от 7 до 15.
   E-mail	Адрес на електронна поща, на който ще бъде изпратена връзката за плащане
   Тип плащане	Изберете един от двата варианта. Едностадийно — след извършване на плащането не се изискват допълнителни действия от ваша страна. Двустадийно — след като клиентът потвърди плащането, трябва да завършите платежа в личния кабинет. Докато не направите това, парите ще бъдат задържани по сметката на клиента (холдирани) до момента на потвърждението от вас на плащането или до момента на изтичане на срока за очакване на потвърждението. В случай на потвърждение от вас на плащането парите се преведават по вашата сметка. В случай на изтичане на срока за очакване на потвърждението блокирането на средствата по сметката на клиента се премахва.
   Валута	Изберете валутата на платежа от падащия списък
   Език	Изберете езика на фактурата от падащия списък. Достъпни стойности - BG и EN
   Плати до	Посочете датата и времето, до които може да се плати фактурата. След изтичане на този срок плащането на издадената фактура ще бъде невъзможно
   Описание на платежа	Описание на платежа в свободна форма
   Въведете сума	Посочете сумата на платежа. Ако поръчката съдържа предварително попълнена кошница със стоки, това поле се попълва автоматично

4. Натиснете бутона Създай връзка.

   При успешно изпращане по-долу ще се покаже връзката към платежната форма:

   

   Можете да прегледате изпратената на клиента платежна страница, като натиснете бутона Отвори връзка за плащане.

Формиране на кошница със стоки при издаване на фактура за плащане

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

1. За да добавите стока в кошницата, натиснете бутона Добави стока и изберете Нов продукт. Ще се покаже форма с параметрите на добавяната стока.
   

2. Попълнете необходимите полета, ръководейки се от таблицата по-долу.

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

3. Натиснете Добави стока.

4. Повторете необходимите действия за всяка позиция от стоковата кошница. При необходимост да изтриете добавена позиция натиснете на бутона и потвърдете действието. За да изтриете всички стоки, натиснете на бутона Изтрий всички стоки и потвърдете действието.
   

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

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

След запълване на стоковата кошница, издайте фактура на клиента.

Импорт файл 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

Провеждане на пробно плащане

Можете самостоятелно да тествате процеса на плащане от името на клиента. За това:

1. Формирайте сметка за клиента.
   

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

3. Изберете начин на плащане. При плащане с карта, въведете данните на една от тестовите карти.

4. Отбележете Запазете моята карта ако искате да създадете запазени платежни данни: в този случай следващия път няма да е необходимо да въвеждате данните на картата.
   

5. Натиснете на бутона Плащане. За потвърждение на операцията използвайте посочения за тестовата карта код 3-D Secure.

Финална страница

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

В таблицата по-долу са описани данните, показвани на финалната страница.

За да се върне в магазина, клиентът трябва да натисне връзката Върнете се в магазина.

Можете да включите или изключите показването на финалната страница, като поставите отметката Покажете финалната страница на страницата Общи настройки на вашия личен кабинет. Прочетете повече подробности тук.

Масово изпращане на сметки за плащане

Ако имате съответното разрешение, можете да изпратите на клиентите няколко сметки за плащане наведнъж, като качите файл във формат CSV с данните на сметките и адресите на електронната поща. Форматът на файла се определя от шаблон, който се настройва от екипа за поддръжка.

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

Качване на файл за разпращане

За да качите файл за разпращане:

1. Отидете в раздела Сметка за плащане и отворете раздела Няколко. Страницата показва списък с качените по-рано файлове (ако ги има).

   

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

   

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

   

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

   

Преглед на детайлите на обработен файл

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

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

• Транзакция — връзка към транзакцията по дадената сметка
• Статус — статус на изпращането на сметката на клиента
• Сума — сума на транзакцията
• Ел. поща - адрес на електронната поща за изпращане на сметката
• Връзка — връзка към страницата за плащане

Export на обработен файл

За да експортирате обработен файл, отидете в детайлите на файла и натиснете бутон Export. Файлът ще бъде експортиран в формат CSV със следните полета:

• itemId — задължително поле, пореден номер на обработения ред от файла
• successful — задължително поле, успешност на обработката на реда (true / false)
• reason — задължително поле, описание на грешката (ако няма грешки, това поле е празно)
• link — задължително поле, формирана връзка за плащане
• email — адрес на електронна поща, който е бил указан при качването (ако този параметър е бил зададен в шаблона)

В изходния файл може да има и други полета, ако са били зададени в шаблона.

Отчети

Разделът Отчети позволява генериране на отчети по транзакции, базирайки се на множество параметри за избор. За да покажете страницата Отчети, натиснете на иконата в лявата странична лента.

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

На страницата са представени няколко филтъра за генериране. Можете да изберете транзакции по дата:

• Дата на създаване
• Дата на възстановяване
• Дата на завършване
• Дата на плащане
• Дата на отмяна

Задайте необходимия период за разглеждане (Денонощие, Седмица, Месец, Тримесечие, Година) или изберете конкретен период с дати с помощта на календара.

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

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

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

• Валута: автоматично се отбелязва при избор на всяка сума (включително сума на възстановяване, сума за потвърждение, сума на комисионна, сума на потвърждение, сума на предавторизация).
• Статус: автоматично се отбелязва при избор на някои дати (отмяна, последно възстановяване, списване).

След избор на колоните кликнете Създаване на шаблон.

Запазеният шаблон ще бъде достъпен за избор в списъка Шаблон колони.

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

Платежни връзки

Можете да създавате шаблони на платежни връзки, които ще пренасочват клиента към страницата за плащане.

Създаване на платежна връзка

За да създадете връзка към страницата за плащане, влезте в личния кабинет, в левия страничен панел изберете Връзки за плащане, а след това натиснете Създай:

Можете също да създадете връзка за плащане, като натиснете в горната част на личния кабинет бутона Създай и изберете Връзка за плащане.

Ще се появи форма за попълване:

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

При необходимост попълнете допълнителните параметри в раздела Допълнителни параметри.

Има също възможност да добавите свои параметри. За това натиснете Добави параметър и попълнете полетата:

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

Възможни действия с шаблона на платежна връзка

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

• Споделяне на връзката — натиснете Сподели.

  

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

  

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

  

Освен това са достъпни следните действия:

• Деактивиране/активиране и изтриване — достъпни при натискане на иконата с три точки в реда на връзката.

  

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

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

  

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

Можете да търсите по следните параметри:

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

Предплатежна страница / Страница за плащане

Ако при създаването на връзката са били указани допълнителни параметри (E-mail/Име/Телефон/Адрес) или полето за сума на плащането е било оставено празно, след отварянето на платежната връзка клиентът трябва да попълни задължителните полета на предплатежната страница и едва тогава да премине към плащането на поръчката.
Пример за предплатежна страница с допълнителни параметри:

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

Работа с транзакции

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

В горната част на страницата Транзакции се намира област за търсене, позволяваща да зададете критерии за показване на транзакциите. Списъкът на страницата съдържа транзакции, отговарящи на критериите за търсене.

Търсене на транзакции с помощта на филтър

За работа с транзакции е необходимо първо да зададете и приложите критерии за търсене.

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

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

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

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

За нулиране на филтрите натиснете Нулирай.

Параметри на филтъра за транзакции

Филтърът позволява да зададете критерии за отбор на проведени транзакции.

• Диапазон от дати — В първия падащ списък посочете по коя дата да се прави изборът. Например, Дата на създаване. Във втория падащ списък посочете типа задаване на временски интервал:
  
  • Диапазон от дати — позволява да зададете временски интервал, избирайки в календара начална и крайна дати;
    
  • Период — позволява да изберете за какъв текущ период ще бъдат показани транзакциите: денонощие, седмица, месец или година.
    
• Сума — Сума на поръчката. Посочете горната и долната граница на диапазона.
• Статус — Статус на поръчката. Налични са следните статуси (множествен избор):
  
  • Създаден. Сметката е издадена, но все още не е платена.
    
  • Потвърден. Сметката е платена. Средствата се резервират по сметката на платеца.
    
  • Завършен. Средствата се списват от сметката на платеца.
    
  • Отменен. Всички средства се връщат на платеца.
    
  • Отхвърлен. Сметката е издадена, но не е платена навреме.
    
  • Връщане. Извършено е частично връщане.
• Номер на поръчка — Номер, автоматично присвоен на поръчката в магазина. Ако трябва да намерите определена поръчка, посочете тук нейния номер.
• Логин на продавача — Логин на продавача в системата на платежния шлюз. Посочете своя логин (показва се в горния десен ъгъл).
• Последни 4 цифри от картата — Четирите последни цифри от номера на картата на платеца, използвана за плащане на поръчката. Ако търсите транзакции по конкретна карта и знаете номера ѝ, посочете тук последните ѝ четири цифри.

Описание на други критерии за търсене вж. тук.

Таблица на транзакциите

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

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

• Сума — Сума на поръчката.

• Статус — Статус на поръчката.

• Код на отговора — Цифров код на резултата, получен от процесинга на банката (action code). Вж. списъка на кодовете на отговора тук.

• Номер на поръчката — Номер на поръчката в системата на магазина.

• Платежно средство — Платежно средство, което е било използвано за плащане на поръчката.

• Дата на регистрация — Дата, когато транзакцията е била регистрирана.

• Описание на поръчката — Произволно описание на стоките и услугите.

Експорт на списъка на транзакциите

В някои случаи може да се наложи да експортирате вашите транзакции. Налични са три формата: XLS, CSV и XML. За това:

1. Намерете нужните поръчки, като укажете необходимите критерии за търсене с помощта на филтъра.
2. Натиснете бутона Експорт, изберете един от трите формата, предложени за запазване: XLS, CSV и XML.
   
3. Ще започне формирането на отчета в зададения формат. В зависимост от настройките на вашия браузър файлът на отчета ще бъде запазен или ще се появи диалогов прозорец за запазване на готовия файл.

Подробни сведения за транзакцията

В личния кабинет е достъпна подробна информация за всяко плащане.

За да научите повече за плащането, намирайки се на страницата Транзакции, натиснете на реда на интересуващата транзакция в таблицата.

Ще се отвори страницата Детайли за транзакцията. Тя винаги съдържа табовете Детайли за операцията и Активност.

За транзакции от определен тип може допълнително да се показва табът Възстановяване на средства.

Също в зависимост от статуса и типа на транзакцията, могат да се показват бутоните Завърши и Възстановяване.

Бутонът Завърши позволява потвърждаване на двустадийно плащане от клиента. Този бутон е активен само когато поръчката получи статус Потвърдена.

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

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

Детайли за операцията

Табът Детайли за операцията съдържа следните секции:

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

Секцията Детайли за операцията съдържа следните полета:

Секцията Информация за клиента съдържа следните полета:

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

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

Активност

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

Връщане на средства

Разделът Връщане съдържа информация за стоковите позиции в поръчката и позволява осъществяването на връщане на средства на плащащия.

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

Пълно връщане по транзакцията

За да направите пълно връщане на средства на плащащия по поръчката, изпълнете следните действия:

Намирайки се на раздел Възстановяване на средства, натиснете на бутона Пълно възстановяване. Поръчката ще премине в статус Отменена или Възстановяване, в зависимост от етапността на плащането и датата на изпълнение на възстановяването.

Възстановяване по стокови позиции

За възстановяване на средства по стокови позиции изпълнете следните действия:

1. Намирайки се на раздел Възстановяване, използвайте таблицата със състава на количката.

   Колона	Описание
   Код	Номер на стоковата позиция в количката.
   Наименование	Наименование на стоковата позиция.
   Артикул	Цифрово или буквено обозначение, предназначено за класификация на стоковата позиция.
   Цена	Цена за единица стокова позиция.
   К-во	Количество единици стокова позиция.
   Сума	Обща сума за всички единици от една стокова позиция (изчислява се автоматично).
   К-во за възстановяване	Количество единици стока, което трябва да се върне.
   Сума за възстановяване	Сума, която ще бъде възстановена. Полето се изчислява автоматично.

2. В поле К-во за възстановяване укажете количеството отменяни единици стока. Възстановяваната сума ще се покаже в поле Сума за възстановяване.

3. Натиснете на бутона Възстановяване.

Ако сумата за възстановяване е по-малка от сумата на поръчката, поръчката ще премине в статус Възстановяване. Ако е възстановена пълната сума на поръчката, поръчката ще премине в статус Отменена.

Достъпни действия на страницата за транзакция

Основни действия с транзакциите в личния кабинет:

• Отказ на поръчката

• Завършване на двуетапно плащане

• Отказ на двуетапно плащане

• Възстановяване на средства на клиента

Тези операции се извикват със съответните бутони на страницата информация за транзакцията. Подробно описание на всяка операция вижте по-долу.

Отказ на поръчката

Обикновено поръчката, която не е била платена или предаторизирана, автоматично се отказва след определено време, зададено в системата, например, след 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

За да регистрирате домейн, натиснете бутона Добавяне на домейн. Ще се отвори прозорецът Добавяне на домейн.

1. В полето Име на домейн въведете името на домейна от високо ниво (например, example.com) или от трето ниво (например, shop.example.com), който искате да използвате за плащания Apple Pay.
2. Свалете файла за проверка Apple Pay.
3. Поставете файла по указания път на вашия уеб сървър: https://<DOMAIN NAME>/.well-known/apple-developer-merchantid-domain-association.
4. Натиснете бутона Добавяне на домейн.

Домейнът на магазина ще бъде регистриран в Платежната врата с възможност за приемане на плащания Apple Pay.

Името на домейна ще се показва в списъка с домейни в раздела Домейни.

Генератор на код

Този раздел съдържа конструктор за генериране на код на скрипт Payment Widget, който се използва за бързо свързване на бутони Apple Pay и Google Pay на страницата на магазина. Вижте подробно тук.

Разделът включва следните секции за задаване на параметри за инициализация на скрипта:

• Общи настройки - укажете обща информация за регистрация на поръчка в Платежната врата:
  • Включване на плащане чрез Apple Pay и/или Google Pay,
  • Номер на поръчка,
  • Сума (задължително),
  • Валута (изберете от списъка),
  • Език (изберете от списъка),
  • Среда (тестова или работна)
  • Страница за успешно плащане и Страница за неуспешно плащане (укажете URL или изберете стандартен URL).
• Заявка за потребителски данни - укажете данни, които ще бъдат задължителни по време на плащането чрез PaymentRequest API за Google Pay. Задайте съответните отметки: Име, E-mail, Номер на телефон, Пощенски адрес.
• Настройки на платежни бутони - укажете типа на външния вид и стила на бутоните Apple Pay и Google Pay. В раздела е достъпен предварителен преглед на бутона.
• Код за вмъкване на вашата страница - този раздел съдържа предварителен преглед на кода за инициализация на скрипта в съответствие с указаните параметри. Този код е необходимо да вмъкнете на вашата страница.