Упълномощаване

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

Изберете един от двата предложени начина: 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:
   

Код за потвърждение по електронна поща

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

Аналитика

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

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

Горното меню позволява да изберете валута и период, за който ще се показва информация за транзакциите. Можете да изберете период (например, "Днес", "Тази седмица") или да зададете времеви интервал, като изберете в календара начална и крайна дата.

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

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

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

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

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

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

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

Сметки за плащане

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

На тази страница можете да направите следното:

• изпратите сметка на клиента
• изпълните пробно плащане
• намерите сметки по филтър
• прегледате информация за сметката
• отмените сметка
• дублирате сметка
• преизпратите сметка

Изпращане на сметка

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

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

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

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

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

Натиснете Продължаване, за да отворите страницата с информация за сметката.

Формиране на количка за пазаруване

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

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

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

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

3. Натиснете Добавяне продукт.

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

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

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

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

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

Извършване на тестово плащане

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

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

2. Натиснете Продължи, за да отворите детайлите на сметката. Отворете платежната страница, като следвате връзката в горната част на страницата.
   

   

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

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

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

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

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

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

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

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

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

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

Налични са следните критерии:

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

Действия със сметката

Преглед на информацията за сметката

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

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

• Дата на създаване, статус и сума на сметката
• Връзка към изпратената на клиента платежна страница
• Транзакция — връзка към страницата с детайли на транзакцията, свързана с тази сметка
• Номер на поръчката — номер на поръчката в системата на магазина
• Изпратена — дата и час на изпращане на сметката до клиента
• Плати до — дата, до която трябва да се плати сметката
• Клиент — име, фамилия и бащино име на клиента
• Електронна поща - електронна поща на клиента за изпращане на сметката

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

Отмяна на сметката

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

Дублиране на сметката

Можете да дублирате сметка, за да създадете такава же или аналогична сметка, без да въвеждате всички данни отново. За това:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Отчети

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

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

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

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

Задайте необходимия диапазон от дати или изберете конкретен период с дати с помощта на календара.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Споделяне — натискайки този бутон, ще можете да споделите връзката в други приложения.
• Копиране — след натискане на съответната икона ще се появи известие, че връзката е успешно копирана.
• Изтегляне QR-код — ще видите генерираният QR-код, както и ще можете да изтеглите неговото изображение в избрания формат (PNG/SVG/JPEG).

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

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

  

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

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

  

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Подробна информация за транзакцията

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

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

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

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

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

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

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

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

Детайли

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

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

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

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

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

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

Активност

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

Възстановяване на сума

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

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

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

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

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

Възстановяване по артикули

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

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