Оторизация

За да влезете в личния си кабинет, изпълнете следните действия.
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. Попълнете необходимите полета, ръководейки се от таблицата по-долу.

   Поле	Описание
   Наименование	Наименование на стоката или услугата.
   Цена	Цена за единица стокова позиция.
   Кол-во	Количество стока по дадената стокова позиция.
   Ед. изм.	Единици за измерване, например: л — литри, бр. — броя.
   Сума	Обща сума за всички единици от една стокова позиция. Изчислява се автоматично при попълване на полетата Цена и Кол-во.
   Артикул	Артикул на стоковата позиция.
   Признак предмета расчёта	Признак на предмета на разчета, достъпни стойности: 1 - стока; 2 - подакцизна стока; 3 - работа; 4 - услуга; 5 - залог на хазартна игра; 6 - печалба от хазартна игра; 7 - лотариен билет; 8 - печалба от лотария; 9 - предоставяне на рид; 10 - плащане; 11 - агентско възнаграждение; 12 - съставен предмет на разчета; 13 - друг предмет на разчета; 14 - имуществено право; 15 - извънреализационен доход; 16 - осигурителни вноски; 17 - търговски сбор; 18 - курортен сбор; 19 - залог. .
   Признак способа расчёта	Тип плащане. Възможни стойности: Предплащане 100%; Частично предплащане; Аванс; Пълен разчет
   Тип налога	Ставка ДДС, достъпни са следните стойности: 0 – без ДДС; 1 – ДДС по ставка 0%; 2 – ДДС на касовата бележка по ставка 10%; 4 – ДДС на касовата бележка по изчислителна ставка 10/110; 6 – ДДС на касовата бележка по ставка 20%; 7 – ДДС на касовата бележка по изчислителна ставка 20/120. .
   Сума налога	Сума на данъка, изчислена от продавача. Посочва се в минимални единици валута.
   Акциз	Сума на акциза.

   След това натиснете Добавяне.

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

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

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

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

   

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

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

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

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

Експорт на обработен файл

За да експортирате обработен файл, отидете в детайлите на файла и натиснете бутон Експорт. Файлът ще бъде експортиран във формат 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. В раздела е достъпен предварителен преглед на бутона.
• Код за вмъкване на вашата страница - този раздел съдържа предварителен преглед на кода за инициализация на скрипта в съответствие с указаните параметри. Този код е необходимо да вмъкнете на вашата страница.