Описание
Плащане с карта. Ясна отстъпка. Повече контрол върху вашия WooCommerce магазин.
Webselo FiBank Pay свързва вашия WooCommerce магазин с виртуален ПОС терминал на FiBank. Клиентът избира плащане с карта и въвежда картовите данни на банковата страница. Вие управлявате достъпността на метода, картовата отстъпка и проследяването на платежните операции от WordPress.

- Карта с отстъпка: фиксирана сума в евро или процент, с ваши правила и лимити.
- Контрол на достъпността: минимална и максимална поръчка и разрешени държави за фактуриране.
- Сървърна проверка: поръчката се отбелязва като платена след потвърждение на резултата от банката.
- Възстановявания: частична сума или пълен остатък през стандартния WooCommerce процес.
- Отделни среди: тестови и продукционни сертификатни профили.
- Съвместимост: стандартна WooCommerce каса, Checkout Blocks и HPOS.
- Лиценз и обновления: активация и управление от WordPress.
Насърчете плащането с карта
Предложете конкретна полза на клиента — например 3 € отстъпка или 5% върху допустимите стоки. Промяната в сумата се показва преди завършване на поръчката.
Отстъпката се добавя при избор на FiBank и се премахва при смяна към друг платежен метод. Можете да използвате картовото плащане и без отстъпка.
- Фиксирана сума в EUR или процент.
- Минимална стойност на допустимите стоки.
- Максимален размер на отстъпката в евро.
- Разрешаване или забраняване на комбинирането с купони.
- Изключване на намалени продукти или конкретни продукти.
Базата включва допустимите стоки след останалите купони, с приложимия за клиента данък. Доставката и таксите не участват. Купон с индивидуална употреба изключва картовата отстъпка.
Пример: стоки за 100 € с приложимия данък, доставка 5 € и картова отстъпка 5% дават крайна сума 100 €. Отстъпката е 5 € върху стоките; доставката остава 5 €.
Отстъпката използва WooCommerce купонния механизъм и се разпределя по продуктовите и данъчните редове. При данъчни настройки, които не позволяват точния размер след закръгляване, по подразбиране методът не се предлага за съответната кошница. По избор можете да разрешите най-близката по-малка отстъпка.

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

Управлявайте сертификатите от WordPress
Импортирайте P12/PFX или комбиниран PEM и въведете паролата от административния панел. Обработката се извършва на вашия сървър, без изпращане на частния ключ към онлайн конвертор.
- Проверка на съответствието между сертификата и частния ключ.
- Проверка на валидността и минималната дължина на RSA ключа.
- Шифровано съхранение в частна директория извън публичната директория на сайта.
- Видим срок на валидност и напомняне при оставащи под 30 дни.
- Подновяване на съществуващ профил при допустима подмяна за същата среда и сертификатна идентичност.
При стар P12, който хостингът не може да прочете, следвайте ръководството за локално преобразуване към PEM. При архивиране пазете заедно базата данни, частните сертификатни файлове и ключа за шифроване.

Потвърждение на плащането чрез банката
Връщането на клиента от банковата страница не е достатъчно доказателство за успешно плащане. Webselo FiBank Pay проверява резултата чрез сървърна заявка към банката и след потвърждение завършва платежния процес на поръчката.
- Повторното отваряне на регистриран платежен опит използва същия банков идентификатор и запазената сума.
- Повторните банкови отговори не изпълняват повторно поръчката и намаляването на наличността.
- Забавените резултати се проверяват с ограничени автоматични задачи.
- Закъсняло успешно плащане по променена или отменена поръчка се отбелязва за преглед.
- Второ успешно плащане се отбелязва за проверка, без автоматично възстановяване.
Всеки платежен опит запазва своята среда и сертификатен профил. Промяната на текущите настройки не пренасочва проверките на старите плащания към друг терминал.
Частични и пълни възстановявания
Възстановявайте средства през стандартния WooCommerce процес. Посочете точна сума — включително 0,01 € — или целия оставащ размер на потвърденото плащане.
Плъгинът контролира наличния остатък и записва операцията преди банковото искане. Повторното изпращане със същия идентификатор се обработва с проверки срещу дублиране.
При частично връщане се използват платените редове с първоначалната отстъпка. Не се изчислява нова отстъпка върху останалите стоки. Данъчните редове и връщането в наличност се управляват през WooCommerce.

Проследяване на непотвърдени операции
Прекъснатата връзка не се приема автоматично за банков отказ. Ако регистрация или възстановяване остане с непотвърден резултат, нова парична операция се блокира до сверяване.
След независима проверка в банката можете да прикачите намерен банков идентификатор, да приключите потвърден нерегистриран опит или да запишете резултата от възстановяване локално, без ново банково искане.
Банково сторниране, закъсняло плащане и надплащане изискват преглед от търговеца. При възстановяване на липсващ WooCommerce запис данъчните документи и наличностите се сверяват отделно.

Стандартна каса, Checkout Blocks и HPOS
Webselo FiBank Pay поддържа стандартната WooCommerce каса и Checkout Blocks. При Blocks смяната на метода обновява сумите на сървъра, а завършването на поръчката изчаква актуалния резултат.
Работата с поръчките използва WooCommerce API с поддръжка на HPOS и традиционното съхранение. Съвместимостта с конкретната тема, данъчни разширения и други модули за отстъпки се проверява на тестово копие.


История и диагностика
От „WooCommerce → FiBank операции“ намирате поръчката по нейния идентификатор и преглеждате платежните опити, средата, сертификатния профил, сумите, състоянията и възстановяванията.
По избор включвате WooCommerce журналите за диагностични събития. В тях не се записват пароли, частни ключове, клиентски IP адреси или необработени банкови заявки и отговори.
Лиценз и обновления
Активирайте своя лицензионен ключ от „WooCommerce → FiBank лиценз“. В същия екран виждате състоянието на активацията и правото на обновления.
Безсрочното ползване и срокът за обновления са отделни права. При валидна активация изтичането само на срока за обновления не спира работата на инсталираната версия. Достъпът до нови версии следва закупения срок, а обновяването се извършва през WordPress.
Новите плащания изискват валидна активация. Временна липса на връзка с лицензионната услуга запазва вече валидната активация.
При неактивен лиценз вече регистрираните банкови операции продължават да се обслужват. Обработката на банковите отговори, проверките на резултата, сверяването и възстановяванията по потвърдени плащания остават достъпни. Достъпни остават и историята и подновяването на сертификатите.
За обслужване на тези операции самият WordPress плъгин трябва да остане включен, а банковата връзка и фоновите задачи да работят.
Как да започнете
- Осигурете виртуален ПОС терминал на FiBank и потвърден интеграционен пакет за ECOMM v2.
- Инсталирайте плъгина и активирайте лиценза от „WooCommerce → FiBank лиценз“.
- Импортирайте сертификата за тестовата среда.
- Настройте платежния метод, ограниченията и желаната отстъпка.
- Съгласувайте адреса за връщане с банката и изпълнете приемателните тестове на копие на магазина.
- След успешно приемане настройте продукционния профил и включете метода за клиентите.
Какво получавате
- Инсталационен ZIP за WordPress.
- WooCommerce платежен метод и административни екрани.
- Настройки за картовата отстъпка и достъпността на метода.
- Управление на сертификатните профили.
- История на операциите и инструменти за сверяване.
- Лицензионна активация и обновления според закупения срок.
- Българско ръководство за инсталиране, настройване и работа.
Необходими са отделен договор и виртуален ПОС терминал на FiBank. Банковите такси, активирането на терминала и банковите сертификати не се предоставят от плъгина.
Изисквания
- WordPress: 6.6 или по-нова версия.
- WooCommerce: 9.9 или по-нова версия.
- PHP: 8.3 или по-нова версия, 64-битова платформа с cURL, OpenSSL и Sodium.
- Валута: EUR с два десетични знака.
- Банкова интеграция: FiBank ECOMM v2 с потвърдени параметри за конкретния терминал.
- Хостинг: HTTPS в продукционната среда, постоянни връзки с именувани адреси и частна директория извън публичната директория на сайта.
- Свързаност: достъп до банковите адреси и лицензионната услуга на Webselo.
- Фонови задачи: работещ Action Scheduler и WP-Cron или сървърен cron.
- Платежна заявка: валиден клиентски IPv4 и положителна сума.
Често задавани въпроси
Къде клиентът въвежда картовите данни?
На платежната страница на FiBank. Плъгинът не добавя форма за номер на карта, срок и CVV в магазина.
Задължителна ли е картовата отстъпка?
Не. Можете да използвате картовото плащане без отстъпка.
Мога ли да възстановя част от плащането?
Да, при потвърдено успешно плащане и достатъчен оставащ размер.
Спира ли плъгинът след изтичане на срока за обновления?
Не. При валидна активация ползването е безсрочно. Срокът за обновления определя достъпа до нови версии.
Прехвърлят ли се автоматично старите плащания от друг плъгин?
Не. Старите поръчки и възстановявания се обслужват чрез историческата интеграция. Преминаването и смяната на банковия адрес за връщане се планират отделно.
Поддържат ли се абонаменти и отложено прихващане?
Не в тази версия.