Magento

• Aktivní obchodní účet Cost+
• Instalace Magento 2.4.6 – 2.4.8
• PHP 8.2 – 8.4
• Administrátorský přístup k panelu správy Magento
• SSH přístup k vašemu serveru (pro instalaci přes Composer)

• Aktivní obchodní účet Cost+
• Magento 1.9.x nebo OpenMage LTS 20+
• PHP 7.4 nebo novější
• Administrátorský přístup k panelu správy Magento
• SSH nebo FTP přístup k vašemu serveru

Metoda A: Instalace přes Composer (doporučeno)

Připojte se k serveru Magento přes SSH a přejděte do kořenového adresáře Magento.

Nainstalujte plugin:

composer require nopayn/nopayn-magento-2

Spusťte příkazy pro nastavení Magento:

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

Pokud jste v produkčním režimu, spusťte také:

php bin/magento setup:static-content:deploy

Metoda B: Ruční instalace

1. Přejděte do adresáře app/code
2. Stáhněte a rozbalte Cost+ release z GitHubu
3. Spusťte příkazy pro nastavení:

php bin/magento setup:upgrade
php bin/magento cache:clean

Pokud jste v produkčním režimu:

php bin/magento setup:static-content:deploy

Stáhněte nebo naklonujte modul z GitHubu.

Zkopírujte obsah app/ do kořenového adresáře app/ Magento:

cp -r app/* /path/to/magento/app/

Vymažte cache Magento:

rm -rf var/cache/*

Přihlaste se do panelu správy Magento a přejděte na System → Configuration → Sales → Payment Methods pro ověření, že se zobrazí sekce NoPayn Payment Gateway.

1. Přejděte na Stores → Configuration → Sales → Payment Methods → Cost+ Payments
2. Zadejte svůj API klíč (viz krok 3 níže)
3. Povolte platební metody, pro které jste byli schváleni
4. Uložte změny

1. Přejděte na System → Configuration → Sales → Payment Methods
2. Najděte sekci NoPayn Payment Gateway
3. Zadejte svůj API klíč (viz krok 3 níže)
4. Povolte jednotlivé platební metody (Credit / Debit Card, Apple Pay, Google Pay, Vipps MobilePay)
5. Volitelně omezte podle země
6. Uložte konfiguraci

1. Zákazník vybere platební metodu při checkoutu a potvrdí objednávku
2. Zákazník je přesměrován na hostovanou platební stránku NoPayn
3. Po platbě se zákazník vrátí a stav objednávky je automaticky aktualizován
4. NoPayn odešle webhook pro asynchronní potvrzení stavu

1. Zákazník vybere platební metodu při checkoutu a potvrdí objednávku
2. Objednávka je vytvořena se stavem Pending Payment
3. Zákazník je přesměrován na bezpečnou platební stránku NoPayn
4. Po platbě:
   • Úspěch — zákazník se vrátí, stav je ověřen přes API, objednávka nastavena na Processing
   • Zrušeno — zákazník se vrátí, objednávka nastavena na Canceled
   • Vypršelo (5minutový timeout) — webhook se aktivuje, objednávka nastavena na Canceled
5. NoPayn odešle webhook pro asynchronní potvrzení stavu

Mapování stavů objednávek

Webhooky

Modul registruje webhook endpoint na /nopayn/payment/webhook. Tato URL je automaticky odeslána NoPayn při vytváření objednávek. Webhook vždy ověří stav objednávky prostřednictvím API NoPayn před aktualizací objednávky Magento.