Magento
Integrujte Cost+ s vasim obchodom Magento (2.x a 1.9 / OpenMage LTS)

Integrujte Cost+ ako platobnu metodu vo vasom obchode Magento. Rozsirenie Cost+ je dostupne pre Magento 2 (2.4.6 -- 2.4.8) a Magento 1.9 (vratane OpenMage LTS 20+).
Predpoklady
- Aktivny ucet obchodnika Cost+
- Instalacia Magento 2.4.6 -- 2.4.8
- PHP 8.2 -- 8.4
- Administratorsky pristup k vasmu administratorskemu panelu Magento
- SSH pristup k vasmu serveru (pre instalaciu cez Composer)
- Aktivny ucet obchodnika Cost+
- Magento 1.9.x alebo OpenMage LTS 20+
- PHP 7.4 alebo novsi
- Administratorsky pristup k vasmu administratorskemu panelu Magento
- SSH alebo FTP pristup k vasmu serveru
1. Instalacia rozsirenia
Metoda A: Instalacia cez Composer (odporucane)
Pripojte sa k vasmu serveru Magento cez SSH a prejdite do korenovoho adresara Magento.
Nainštalujte plugin:
composer require nopayn/nopayn-magento-2Spustite Magento setup prikazy:
php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:cleanAk ste v produkcnom rezime, spustite tiez:
php bin/magento setup:static-content:deployMetoda B: Manualna instalacia
- Prejdite do adresara
app/code - Stiahnite a rozbalte Cost+ vydanie z GitHub
- Spustite setup prikazy:
php bin/magento setup:upgrade
php bin/magento cache:cleanAk ste v produkcnom rezime:
php bin/magento setup:static-content:deployStiahnite alebo klonujte modul z GitHub.
Skopiujte obsah app/ do korenovoho adresara app/ vasho Magento:
cp -r app/* /path/to/magento/app/Vycistite cache Magento:
rm -rf var/cache/*Prihlaste sa do administratorskeho panelu Magento a prejdite na System -> Configuration -> Sales -> Payment Methods, aby ste overili, ze sa zobrazuje sekcia NoPayn Payment Gateway.
Modul vytvori tabulku nopayn_transactions vo vasej databaze na sledovanie platobnych transakcii. Toto sa vytvori automaticky pri prvom pouziti.
2. Konfiguracia pluginu
- Prejdite na Stores -> Configuration -> Sales -> Payment Methods -> Cost+ Payments
- Zadajte svoj API kluc (pozrite krok 3 nizsie)
- Aktivujte platobne metody, pre ktore ste boli schvaleni
- Ulozte zmeny
- Prejdite na System -> Configuration -> Sales -> Payment Methods
- Najdite sekciu NoPayn Payment Gateway
- Zadajte svoj API kluc (pozrite krok 3 nizsie)
- Aktivujte jednotlive platobne metody (Credit / Debit Card, Apple Pay, Google Pay, Vipps MobilePay)
- Volitelne obmedzte podla krajiny
- Ulozte konfiguraciu
3. Zadanie API prihlaseni
Prihlaste sa do obchodneho portalu a prejdite na Webove stranky, potom kliknite na webovu stranku, ktoru chcete pripojit. Kliknite na Integracia, kde najdete svoj API kluc.

Vlozte API kluc do konfiguracneho pola a ulozte.
Aktivujte len tie platobne metody, pre ktore ste boli schvaleni a dostali potvrdenie.
Podporovane platobne metody
| Nazov pri pokladni | NoPayn identifikator |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Platobny proces
- Zakaznik si vyberie platobnu metodu pri pokladni a zada objednavku
- Zakaznik je presmerovany na hostovanu platobnu stranku NoPayn
- Po platbe sa zakaznik vrati a stav objednavky sa automaticky aktualizuje
- NoPayn posle webhook pre asynchronne potvrdenie stavu
- Zakaznik si vyberie platobnu metodu pri pokladni a zada objednavku
- Objednavka sa vytvori so stavom Pending Payment
- Zakaznik je presmerovany na bezpecnu platobnu stranku NoPayn
- Po platbe:
- Uspech -- zakaznik sa vrati, stav sa overi cez API, objednavka sa nastavi na Processing
- Zrusenie -- zakaznik sa vrati, objednavka sa nastavi na Canceled
- Exspiracia (5-minutovy casovy limit) -- webhook sa spusti, objednavka sa nastavi na Canceled
- NoPayn posle webhook pre asynchronne potvrdenie stavu
Mapovanie stavov objednavok
| Stav NoPayn | Stav objednavky Magento | Status objednavky Magento |
|---|---|---|
new | pending_payment | Pending Payment |
processing | pending_payment | Pending Payment |
completed | processing | Processing |
cancelled | canceled | Canceled |
expired | canceled | Canceled |
error | canceled | Canceled |
Webhooky
Modul registruje webhook endpoint na /nopayn/payment/webhook. Tato URL je automaticky odoslana na NoPayn pri vytvarani objednavok. Webhook vzdy overuje stav objednavky cez NoPayn API pred aktualizaciou objednavky Magento.
Ziadna manualna konfiguracia webhooku nie je potrebna -- modul spracuvava registraciu automaticky.
4. Testovanie vasho nastavenia
- Vykonajte niekolko testovacich transakcii -- uspesnych aj neuspesnych
- Overte, ze vsetky aktivovane platobne metody sa zobrazuju pri pokladni
- Nakonfigurujte spravanie zachytenia (automaticke zachytenie vs. manualne) na zaklade vasho procesu plnenia
Podpora
Potrebujete pomoc? Kontaktujte nas tym podpory na support@costplus.io.