Magento

• Account commerciante Cost+ attivo
• Installazione Magento 2.4.6 – 2.4.8
• PHP 8.2 – 8.4
• Accesso amministratore al tuo pannello di amministrazione Magento
• Accesso SSH al tuo server (per l'installazione tramite Composer)

• Account commerciante Cost+ attivo
• Magento 1.9.x o OpenMage LTS 20+
• PHP 7.4 o successivo
• Accesso amministratore al tuo pannello di amministrazione Magento
• Accesso SSH o FTP al tuo server

Metodo A: Installazione tramite Composer (Consigliato)

Connettiti al tuo server Magento tramite SSH e naviga alla directory root di Magento.

Installa il plugin:

composer require nopayn/nopayn-magento-2

Esegui i comandi di setup di Magento:

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

Se sei in modalità produzione, esegui anche:

php bin/magento setup:static-content:deploy

Metodo B: Installazione Manuale

1. Naviga alla directory app/code
2. Scarica e decomprimi la release Cost+ da GitHub
3. Esegui i comandi di setup:

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

Se in modalità produzione:

php bin/magento setup:static-content:deploy

Scarica o clona il modulo da GitHub.

Copia il contenuto di app/ nella directory root app/ del tuo Magento:

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

Svuota la cache di Magento:

rm -rf var/cache/*

Accedi al pannello di amministrazione Magento e vai a Sistema → Configurazione → Vendite → Metodi di Pagamento per verificare che la sezione NoPayn Payment Gateway sia visibile.

1. Vai a Negozi → Configurazione → Vendite → Metodi di Pagamento → Cost+ Payments
2. Inserisci la tua chiave API (vedi passaggio 3 sotto)
3. Abilita i metodi di pagamento per cui sei stato approvato
4. Salva le modifiche

1. Vai a Sistema → Configurazione → Vendite → Metodi di Pagamento
2. Trova la sezione NoPayn Payment Gateway
3. Inserisci la tua chiave API (vedi passaggio 3 sotto)
4. Abilita i singoli metodi di pagamento (Carta di Credito / Debito, Apple Pay, Google Pay, Vipps MobilePay)
5. Opzionalmente limita per paese
6. Salva la configurazione

1. Il cliente seleziona un metodo di pagamento al checkout e conferma l'ordine
2. Il cliente viene reindirizzato alla Pagina di Pagamento Ospitata NoPayn
3. Dopo il pagamento, il cliente ritorna e lo stato dell'ordine viene aggiornato automaticamente
4. NoPayn invia un webhook per la conferma asincrona dello stato

1. Il cliente seleziona un metodo di pagamento al checkout e conferma l'ordine
2. L'ordine viene creato con stato Pagamento in Attesa
3. Il cliente viene reindirizzato alla pagina di pagamento sicura NoPayn
4. Dopo il pagamento:
   • Successo — il cliente ritorna, lo stato viene verificato tramite API, ordine impostato a In Elaborazione
   • Annullato — il cliente ritorna, ordine impostato a Annullato
   • Scaduto (timeout di 5 minuti) — il webhook si attiva, ordine impostato a Annullato
5. NoPayn invia un webhook per la conferma asincrona dello stato

Mappatura degli Stati dell'Ordine

Webhook

Il modulo registra un endpoint webhook a /nopayn/payment/webhook. Questo URL viene inviato automaticamente a NoPayn durante la creazione degli ordini. Il webhook verifica sempre lo stato dell'ordine tramite l'API NoPayn prima di aggiornare l'ordine Magento.