Magento
Интегрирайте Cost+ с вашия Magento магазин (2.x и 1.9 / OpenMage LTS)

Интегрирайте Cost+ като метод на плащане във вашия Magento магазин. Разширението Cost+ е налично за Magento 2 (2.4.6 – 2.4.8) и Magento 1.9 (включително OpenMage LTS 20+).
Предварителни изисквания
- Активен търговски акаунт в Cost+
- Инсталация на Magento 2.4.6 – 2.4.8
- PHP 8.2 – 8.4
- Администраторски достъп до административния панел на Magento
- SSH достъп до сървъра (за инсталация чрез Composer)
- Активен търговски акаунт в Cost+
- Magento 1.9.x или OpenMage LTS 20+
- PHP 7.4 или по-нова версия
- Администраторски достъп до административния панел на Magento
- SSH или FTP достъп до сървъра
1. Инсталиране на разширението
Метод A: Инсталация чрез Composer (Препоръчително)
Свържете се с Magento сървъра чрез SSH и навигирайте до основната директория на Magento.
Инсталирайте плъгина:
composer require nopayn/nopayn-magento-2Изпълнете командите за настройка на Magento:
php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:cleanАко сте в продукционен режим, изпълнете също:
php bin/magento setup:static-content:deployМетод B: Ръчна инсталация
- Навигирайте до директорията
app/code - Изтеглете и разархивирайте версията на Cost+ от GitHub
- Изпълнете командите за настройка:
php bin/magento setup:upgrade
php bin/magento cache:cleanАко сте в продукционен режим:
php bin/magento setup:static-content:deployИзтеглете или клонирайте модула от GitHub.
Копирайте съдържанието на app/ в основната директория app/ на Magento:
cp -r app/* /path/to/magento/app/Изчистете кеша на Magento:
rm -rf var/cache/*Влезте в административния панел на Magento и навигирайте до System → Configuration → Sales → Payment Methods, за да проверите дали секцията NoPayn Payment Gateway се появява.
Модулът създава таблица nopayn_transactions във вашата база данни за проследяване на транзакциите за плащане. Тя се създава автоматично при първо използване.
2. Конфигуриране на плъгина
- Отидете на Stores → Configuration → Sales → Payment Methods → Cost+ Payments
- Въведете вашия API ключ (вижте стъпка 3 по-долу)
- Активирайте методите на плащане, за които сте одобрени
- Запазете промените
- Отидете на System → Configuration → Sales → Payment Methods
- Намерете секцията NoPayn Payment Gateway
- Въведете вашия API ключ (вижте стъпка 3 по-долу)
- Активирайте отделните методи на плащане (кредитна / дебитна карта, Apple Pay, Google Pay, Vipps MobilePay)
- По желание ограничете по държава
- Запазете конфигурацията
3. Въвеждане на API идентификационни данни
Влезте в портала на търговеца и навигирайте до Уебсайтове, след което кликнете върху уебсайта, който искате да свържете. Кликнете върху Интеграция, където ще намерите вашия API ключ.

Поставете API ключа в полето за конфигурация и запазете.
Активирайте само методите на плащане, за които сте одобрени и сте получили потвърждение.
Поддържани методи на плащане
| Име при плащане | NoPayn идентификатор |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Поток на плащане
- Клиентът избира метод на плащане при касата и потвърждава поръчката
- Клиентът се пренасочва към хостваната страница за плащане на NoPayn
- След плащане клиентът се връща и статусът на поръчката се актуализира автоматично
- NoPayn изпраща уебхук за асинхронно потвърждение на статуса
- Клиентът избира метод на плащане при касата и потвърждава поръчката
- Поръчката се създава със статус Pending Payment
- Клиентът се пренасочва към защитената страница за плащане на NoPayn
- След плащане:
- Успех — клиентът се връща, статусът се проверява чрез API, поръчката се задава на Processing
- Отказано — клиентът се връща, поръчката се задава на Canceled
- Изтекло (5-минутен таймаут) — уебхукът се активира, поръчката се задава на Canceled
- NoPayn изпраща уебхук за асинхронно потвърждение на статуса
Съпоставяне на статуси на поръчки
| NoPayn статус | Magento състояние на поръчка | Magento статус на поръчка |
|---|---|---|
new | pending_payment | Pending Payment |
processing | pending_payment | Pending Payment |
completed | processing | Processing |
cancelled | canceled | Canceled |
expired | canceled | Canceled |
error | canceled | Canceled |
Уебхукове
Модулът регистрира крайна точка за уебхукове на /nopayn/payment/webhook. Този URL автоматично се изпраща на NoPayn при създаване на поръчки. Уебхукът винаги проверява статуса на поръчката чрез NoPayn API, преди да актуализира поръчката в Magento.
Не е необходима ръчна конфигурация на уебхукове — модулът обработва регистрацията автоматично.
4. Тестване на настройката
- Направете няколко тестови транзакции — както успешни, така и неуспешни
- Проверете дали всички активирани методи на плащане се появяват при касата
- Конфигурирайте поведението на улавяне (автоматично или ръчно) въз основа на процеса на изпълнение
Поддръжка
Нуждаете се от помощ? Свържете се с нашия екип за поддръжка на support@costplus.io.