Регистрация и интеграция с Paypercut

Какво е Paypercut?

Paypercut е платежна платформа, която позволява на клиентите ви да плащат с карта чрез хоствана касова страница (hosted checkout). При този метод на плащане, клиентът бива пренасочен към защитена страница на Paypercut, където въвежда данните на картата си.

Изисквания

За да използвате Paypercut, ви е необходим:
- Paypercut бизнес акаунт
- API ключ от Paypercut Dashboard

Стъпки за настройка

1. Регистрация в Paypercut

1. Посетете paypercut.io и създайте бизнес акаунт
2. Завършете верификацията на акаунта
3. Влезте в Paypercut Dashboard

2. Създаване на API ключове

В Paypercut Dashboard:
1. Отидете на Developers → API Keys
2. Създайте Production API Key за реални плащания
3. Създайте Test API Key за тестови плащания (препоръчително)

Важно! Запазете тези ключове на сигурно място - те се показват само веднъж!

3. Инсталиране в Creativiso Xpress

1. Влезте в Админ панел → Приложения (Apps)
2. Намерете Paypercut в списъка с приложения
3. Кликнете Инсталирай
4. Въведете следната информация:
   • API ключ — вашият production API ключ
   • API ключ (тест) — вашият тест API ключ (опционално)
   • Тестов режим — отметнете за тестови плащания
5. Кликнете Запази

След запазване системата автоматично:
- Регистрира webhook URL в Paypercut
- Запазва API ключовете във vault (криптирано хранилище)
- Добавя Paypercut като наличен платежен метод
- Рестартира приложението (може да отнеме няколко секунди)

4. Webhook конфигурация (автоматична)

https://{вашият-домейн}/api/fe/v1/cart/notify/paypercut

Този webhook известява системата при успешно плащане.

Режими на работа

Production режим (реални плащания)

• Използва production API ключ
• Реални карти, реални транзакции
• Парите се превеждат във Вашия Paypercut акаунт

Test режим (тестови плащания)

• Използва test API ключ
• Тестови карти, без реални транзакции
• Идеален за тестване на процеса преди пускане

За смяна на режима:
1. Отидете в Приложения → Paypercut → Конфигурация
2. Отметнете/премахнете Test Mode
3. Кликнете Запази

Активиране и деактивиране

Спиране (Suspend)

Ако искате временно да спрете Paypercut като опция за плащане, без да премахвате конфигурацията:

1. Отидете в Приложения → Paypercut → Конфигурация
2. Кликнете бутона Спри (Suspend)
3. Състоянието ще се промени на „Спряно“

Когато Paypercut е спрян:
- Клиентите не виждат опцията при плащане
- Конфигурацията се запазва
- API ключовете остават във vault

Възобновяване (Resume)

За да активирате отново Paypercut:

1. Отидете в Приложения → Paypercut → Конфигурация
2. Кликнете бутона Възобнови (Resume)
3. Състоянието ще се промени на „Активно“

Деинсталиране

За пълно премахване на Paypercut:

1. Отидете в Приложения → Paypercut → Конфигурация
2. Кликнете Деинсталирай
3. Потвърдете действието

При деинсталиране:
- Paypercut се премахва от списъка с платежни методи
- API ключовете се изтриват от vault
- Webhook-ът се изтрива автоматично от Paypercut
- Приложението се рестартира

Как работи плащането

Стъпки при плащане:

1. Клиентът избира Paypercut като опция за плащане в кошницата
2. Създава се checkout сесия - системата създава сесия в Paypercut с детайлите за поръчката
3. Пренасочване - клиентът се пренасочва към checkout.paypercut.io
4. Въвеждане на карта - клиентът въвежда данните на картата си на защитената страница на Paypercut
5. Завръщане - след плащане, клиентът се връща във Вашия магазин

Потвърждение на плащането

Paypercut изпраща webhook при успешно плащане.
Системата:
- Маркира поръчката като „платена“
- Изпраща имейл потвърждение
- Изпраща push нотификация
- Обновява статуса в реално време

Ако webhook-ът закъснее, страницата за успешно плащане автоматично проверява статуса на всеки 3 секунди.

Тестови карти

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

Номер на карта	CVC	Дата
5204 2477 5000 1471	123	Бъдеща дата

Често срещани проблеми

"Paypercut credentials not configured"

• API ключът не е запазен правилно. Проверете конфигурацията и запазете отново.

Webhook грешки

• Проверете дали вашият домейн е публично достъпен
• Уверете се, че SSL сертификатът е валиден

"Payment method not available"

• Проверете дали Paypercut не е в състояние „Спряно“
• Уверете се, че приложението е инсталирано

Сигурност

• API ключовете се съхраняват криптирано във vault
• Webhook подписите се проверяват за валидност
• Paypercut обработва чувствителните данни от картата - Вашият сървър никога не вижда номера на картата

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

За въпроси относно Paypercut акаунт и такси:
- Paypercut поддръжка
- Документация

За технически въпроси относно интеграцията с Creativiso Xpress:
- Свържете се с техническата ни поддръжка.