Cost+Docs

Magento

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

Magento

Интегрирайте 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: Ръчна инсталация

  1. Навигирайте до директорията app/code
  2. Изтеглете и разархивирайте версията на Cost+ от GitHub
  3. Изпълнете командите за настройка:
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. Конфигуриране на плъгина

  1. Отидете на Stores → Configuration → Sales → Payment Methods → Cost+ Payments
  2. Въведете вашия API ключ (вижте стъпка 3 по-долу)
  3. Активирайте методите на плащане, за които сте одобрени
  4. Запазете промените
  1. Отидете на System → Configuration → Sales → Payment Methods
  2. Намерете секцията NoPayn Payment Gateway
  3. Въведете вашия API ключ (вижте стъпка 3 по-долу)
  4. Активирайте отделните методи на плащане (кредитна / дебитна карта, Apple Pay, Google Pay, Vipps MobilePay)
  5. По желание ограничете по държава
  6. Запазете конфигурацията

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

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

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

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

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

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

Име при плащанеNoPayn идентификатор
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

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

  1. Клиентът избира метод на плащане при касата и потвърждава поръчката
  2. Клиентът се пренасочва към хостваната страница за плащане на NoPayn
  3. След плащане клиентът се връща и статусът на поръчката се актуализира автоматично
  4. NoPayn изпраща уебхук за асинхронно потвърждение на статуса
  1. Клиентът избира метод на плащане при касата и потвърждава поръчката
  2. Поръчката се създава със статус Pending Payment
  3. Клиентът се пренасочва към защитената страница за плащане на NoPayn
  4. След плащане:
    • Успех — клиентът се връща, статусът се проверява чрез API, поръчката се задава на Processing
    • Отказано — клиентът се връща, поръчката се задава на Canceled
    • Изтекло (5-минутен таймаут) — уебхукът се активира, поръчката се задава на Canceled
  5. NoPayn изпраща уебхук за асинхронно потвърждение на статуса

Съпоставяне на статуси на поръчки

NoPayn статусMagento състояние на поръчкаMagento статус на поръчка
newpending_paymentPending Payment
processingpending_paymentPending Payment
completedprocessingProcessing
cancelledcanceledCanceled
expiredcanceledCanceled
errorcanceledCanceled

Уебхукове

Модулът регистрира крайна точка за уебхукове на /nopayn/payment/webhook. Този URL автоматично се изпраща на NoPayn при създаване на поръчки. Уебхукът винаги проверява статуса на поръчката чрез NoPayn API, преди да актуализира поръчката в Magento.

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

4. Тестване на настройката

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

Поддръжка

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

On this page