Cost+Docs

Magento

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

Magento

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-2

Spustite Magento setup prikazy:

php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:clean

Ak ste v produkcnom rezime, spustite tiez:

php bin/magento setup:static-content:deploy

Metoda B: Manualna instalacia

  1. Prejdite do adresara app/code
  2. Stiahnite a rozbalte Cost+ vydanie z GitHub
  3. Spustite setup prikazy:
php bin/magento setup:upgrade
php bin/magento cache:clean

Ak ste v produkcnom rezime:

php bin/magento setup:static-content:deploy

Stiahnite 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

  1. Prejdite na Stores -> Configuration -> Sales -> Payment Methods -> Cost+ Payments
  2. Zadajte svoj API kluc (pozrite krok 3 nizsie)
  3. Aktivujte platobne metody, pre ktore ste boli schvaleni
  4. Ulozte zmeny
  1. Prejdite na System -> Configuration -> Sales -> Payment Methods
  2. Najdite sekciu NoPayn Payment Gateway
  3. Zadajte svoj API kluc (pozrite krok 3 nizsie)
  4. Aktivujte jednotlive platobne metody (Credit / Debit Card, Apple Pay, Google Pay, Vipps MobilePay)
  5. Volitelne obmedzte podla krajiny
  6. 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.

Obchodny portal Cost+ zobrazujuci 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 pokladniNoPayn identifikator
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

Platobny proces

  1. Zakaznik si vyberie platobnu metodu pri pokladni a zada objednavku
  2. Zakaznik je presmerovany na hostovanu platobnu stranku NoPayn
  3. Po platbe sa zakaznik vrati a stav objednavky sa automaticky aktualizuje
  4. NoPayn posle webhook pre asynchronne potvrdenie stavu
  1. Zakaznik si vyberie platobnu metodu pri pokladni a zada objednavku
  2. Objednavka sa vytvori so stavom Pending Payment
  3. Zakaznik je presmerovany na bezpecnu platobnu stranku NoPayn
  4. 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
  5. NoPayn posle webhook pre asynchronne potvrdenie stavu

Mapovanie stavov objednavok

Stav NoPaynStav objednavky MagentoStatus objednavky Magento
newpending_paymentPending Payment
processingpending_paymentPending Payment
completedprocessingProcessing
cancelledcanceledCanceled
expiredcanceledCanceled
errorcanceledCanceled

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

  1. Vykonajte niekolko testovacich transakcii -- uspesnych aj neuspesnych
  2. Overte, ze vsetky aktivovane platobne metody sa zobrazuju pri pokladni
  3. Nakonfigurujte spravanie zachytenia (automaticke zachytenie vs. manualne) na zaklade vasho procesu plnenia

Podpora

Potrebujete pomoc? Kontaktujte nas tym podpory na support@costplus.io.

On this page