Cost+Docs

PrestaShop

Интегрирайте Cost+ с вашия PrestaShop магазин (9.x, 8.x, 1.7 и 1.6)

PrestaShop

Интегрирайте Cost+ като метод на плащане във вашия PrestaShop магазин. Модулът Cost+ е наличен за PrestaShop 9.x, PrestaShop 8.x, PrestaShop 1.7 и PrestaShop 1.6.1.x.

Предварителни изисквания

  • Активен търговски акаунт в Cost+
  • PrestaShop 9.1 или по-нова версия
  • PHP 8.1 или по-нова версия
  • Активиран SSL/HTTPS
  • Администраторски достъп до бек офиса на PrestaShop
  • Активен търговски акаунт в Cost+
  • Инсталация на PrestaShop 8.x
  • PHP 8.0 или по-нова версия
  • Администраторски достъп до бек офиса на PrestaShop
  • MySQL 5.4 или по-нова версия
  • Активен търговски акаунт в Cost+
  • Инсталация на PrestaShop 1.7.x
  • PHP 5.4 или по-нова версия
  • Администраторски достъп до бек офиса на PrestaShop
  • MySQL 5.4 или по-нова версия
  • Активен търговски акаунт в Cost+
  • Инсталация на PrestaShop 1.6.1.x
  • PHP 5.6 или по-нова версия (с разширения cURL и OpenSSL)
  • Активиран SSL/HTTPS на фронтенд страницата
  • Администраторски достъп до бек офиса на PrestaShop

1. Инсталиране на модула

Изтеглете модула от GitHub.

Метод A: Качване чрез административния панел (Препоръчително)

  1. Отидете на Modules → Module Manager в административния панел
  2. Кликнете Upload a module
  3. Плъзнете и пуснете ZIP файла или го изберете ръчно
  4. Изчакайте инсталацията да завърши
  5. Потърсете "NoPayn" и кликнете Configure

Метод B: Ръчно качване

  1. Копирайте папката nopaynpayment/ в директорията modules/ на PrestaShop
  2. Отидете на Modules → Module Manager
  3. Потърсете "NoPayn" и кликнете Install
  4. Кликнете Configure, за да отворите настройките

Изтеглете модула от GitHub.

Метод A: Качване чрез административния панел (Препоръчително)

  1. Отидете на Improve > Module Manager в административния панел
  2. Кликнете Upload a module
  3. Плъзнете и пуснете ZIP файла или го изберете ръчно
  4. Изчакайте инсталацията да завърши
  5. Превъртете надолу до секцията "Other" и кликнете Configure под Cost+

PrestaShop 8 Module Manager

Диалогов прозорец за качване на модул

Метод B: Ръчно качване чрез (S)FTP

  1. Разархивирайте изтегления ZIP файл
  2. Чрез SFTP клиент (напр. FileZilla, WinSCP) качете всички папки в директорията /modules/ на вашата инсталация на PrestaShop
  3. Отидете на Improve > Modules > Module Catalog
  4. Потърсете "Cost+" -- проверете раздела Uninstalled Modules, ако е необходимо
  5. Кликнете Install

Изтеглете модула от GitHub.

Метод A: Качване чрез административния панел (Препоръчително)

  1. Отидете на Improve > Module Manager в административния панел
  2. Кликнете Upload a module
  3. Плъзнете и пуснете ZIP файла или го изберете ръчно
  4. Изчакайте инсталацията да завърши
  5. Превъртете надолу до секцията "Other" и кликнете Configure под Cost+

PrestaShop 1.7 Module Manager

Диалогов прозорец за качване на модул

Метод B: Ръчно качване чрез (S)FTP

  1. Разархивирайте изтегления ZIP файл
  2. Чрез SFTP клиент (напр. FileZilla, WinSCP) качете всички папки в директорията /modules/ на вашата инсталация на PrestaShop
  3. Отидете на Modules > Module Manager
  4. Потърсете "Cost+" -- проверете раздела Uninstalled Modules, ако е необходимо
  5. Кликнете Install

Изтеглете модула от GitHub.

Метод A: Качване чрез административния панел (Препоръчително)

  1. Изтеглете costpluspayment.zip от страницата с релийзи в GitHub
  2. Отидете на Modules and Services в бек офиса на PrestaShop
  3. Кликнете Add a new module
  4. Качете ZIP файла
  5. Намерете Cost+ Payment Gateway в списъка с модули и кликнете Install

Метод B: Ръчно качване чрез (S)FTP

  1. Разархивирайте изтегления ZIP файл
  2. Чрез SFTP клиент качете папката costpluspayment/ в /modules/costpluspayment/ на вашата инсталация на PrestaShop
  3. Отидете на Modules and Services в бек офиса
  4. Намерете Cost+ Payment Gateway и кликнете Install

2. Въвеждане на API идентификационни данни

Влезте в портала на търговеца и навигирайте до Уебсайтове, след което кликнете върху уебсайта, който искате да свържете. Кликнете върху Интеграция, където ще намерите вашия API ключ.

Портал на търговеца на Cost+, показващ API ключ

В конфигурацията на модула NoPayn въведете вашия API ключ и конфигурирайте следните настройки:

НастройкаОписание
API KeyВашият NoPayn API ключ
Credit / Debit CardАктивиране/деактивиране на плащания с карти
Apple PayАктивиране/деактивиране на Apple Pay
Google PayАктивиране/деактивиране на Google Pay
Vipps MobilePayАктивиране/деактивиране на Vipps MobilePay
Manual CaptureОторизирайте плащания с карти — уловете при доставка
Debug LoggingАктивирайте подробно логване в var/logs/nopayn_debug.log

Поставете ключа в полето API Key на страницата за конфигурация на Cost+ Library и кликнете Save.

Страница за конфигурация на Cost+ в PrestaShop 8

Поставете ключа в полето API Key на страницата за конфигурация на Cost+ Library и кликнете Save.

Страница за конфигурация на Cost+ в PrestaShop 1.7

След инсталацията кликнете Configure на модула Cost+ Payment Gateway и задайте следното:

НастройкаОписание
API KeyВашият Cost+ API ключ от портала на търговеца
Credit / Debit CardАктивиране/деактивиране на плащания с карти
Apple PayАктивиране/деактивиране на Apple Pay
Google PayАктивиране/деактивиране на Google Pay
Vipps MobilePayАктивиране/деактивиране на Vipps MobilePay
Manual CaptureОторизирайте плащания с карти — уловете при доставка
Checkout ExpiryИзтичане на изчакваща поръчка в минути (по подразбиране 5)
Debug LoggingАктивирайте подробно логване в log/costplus_debug.log

След запазване отворете Payment > Restrictions и активирайте модула Cost+ Payment Gateway за всяка валута, която приемате.

За хостинг среди на PrestaShop 8.x, 1.7 и 1.6 активирайте опцията cURL CA bundle по време на конфигурацията, за да избегнете проблеми със SSL сертификати.

3. Активиране на методи на плащане

Методите на плащане се конфигурират директно в настройките на модула (вижте стъпка 2 по-горе). Превключете всеки метод включен или изключен по необходимост.

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

След запазване на вашия API ключ качете всеки модул за метод на плащане поотделно чрез Upload a module.

Върнете се на Improve > Module Manager, кликнете отново Upload a module и качете всеки ZIP файл за методите на плащане, които искате да активирате (напр. кредитна карта, MobilePay, Swish).

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

Модулите за плащане ще имат или опция Configure (ако е необходима допълнителна настройка), или просто превключвател за активиране/деактивиране.

След запазване на вашия API ключ качете всеки модул за метод на плащане поотделно чрез Upload a module.

Върнете се на Improve > Module Manager, кликнете отново Upload a module и качете всеки ZIP файл за методите на плащане, които искате да активирате (напр. кредитна карта, MobilePay, Swish).

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

Модулите за плащане ще имат или опция Configure (ако е необходима допълнителна настройка), или просто превключвател за активиране/деактивиране.

Методите на плащане се превключват директно от страницата за конфигурация на модула (вижте стъпка 2 по-горе). Активирайте всеки метод, който искате да е наличен на касата.

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

Поток на плащане

  1. Клиентът избира метод на плащане Cost+ на касата
  2. Клиентът се пренасочва към хостваната страница за плащане на Cost+ (HPP)
  3. След завършване на плащането клиентът се пренасочва обратно в магазина
  4. Уебхук потвърждава статуса на плащането между сървърите

Уебхук

URL адресът за уебхукове се конфигурира автоматично за всяка поръчка:

https://your-shop.com/module/nopaynpayment/webhook

Не е необходима ръчна конфигурация на уебхукове — модулът обработва регистрацията автоматично.

Ръчно улавяне

Когато е активирано за плащания с карти:

  • Плащането е оторизирано, но не е уловено при касата
  • Улавянето става при изпращане/маркиране на поръчката като завършена
  • Ако поръчката бъде отказана, оторизацията автоматично се анулира

Автоматично възстановяване

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

Етикети на бутоните на касата

За най-добро потребителско изживяване с пренасочващи потоци към външен сайт, помислете за актуализиране на етикета на бутона на касата на "Преглед на поръчката" вместо "Потвърди и плати", тъй като действителното плащане се извършва на хостваната страница на Cost+. Това е глобална настройка на PrestaShop, а не специфична за модула.

Уебхук

Уебхукът се конфигурира автоматично от модула. Не е необходима ръчна настройка.

Уебхук

Уебхукът се конфигурира автоматично от модула. Не е необходима ръчна настройка.

Уебхук

Страницата за конфигурация на модула показва URL адреса на уебхука. Копирайте го във вашия Cost+ дашборд ако вашият Cost+ акаунт изисква статична регистрация на уебхук.

Крайната точка на уебхука получава Cost+ събития, след което извиква Cost+ отново с GET /orders/{id}, преди да актуализира поръчката в PrestaShop — това прави обработката на URL за връщане и уебхука идемпотентна.

Cron за изтичане

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

* * * * * curl -fsS "https://your-shop.example/index.php?fc=module&module=costpluspayment&controller=cron&token=..." >/dev/null

Използвайте точния URL, показан в бек офиса на вашия PrestaShop — токенът се генерира по време на инсталацията и е различен за всеки магазин. Крайната точка на cron отказва остарели изчакващи Cost+ поръчки след конфигурирания Checkout Expiry.

Ръчно улавяне и възстановявания

  • При активирано Manual Capture плащанията се оторизират при касата и се улавят, когато поръчката бъде изпратена / маркирана като завършена
  • Ако уловена поръчка бъде отказана, модулът автоматично издава пълно възстановяване
  • Частичните възстановявания се обработват чрез кредитни бележки на PrestaShop

4. Финални стъпки и тестване

  1. Проверете отново всички активирани методи на плащане
  2. Направете няколко тестови транзакции -- както успешни, така и неуспешни -- за да се уверите, че всичко протича правилно
  3. Конфигурирайте разширено поведение като ръчно срещу автоматично улавяне в зависимост от процеса на изпълнение

Поддръжка

Нуждаете се от помощ? Свържете се с нашия екип за поддръжка на support@costplus.io.

On this page