osCommerce

Integra Cost+ come metodo di pagamento nel tuo negozio osCommerce 4. Il modulo ufficiale NoPayn Payments utilizza il flusso della Pagina di Pagamento Ospitata, quindi nessun dato della carta passa attraverso il tuo server — completamente conforme PCI DSS.

Prerequisiti

• Account commerciante Cost+ attivo
• osCommerce 4.x
• PHP 8.1 o successivo
• Estensione cURL abilitata
• Certificato SSL (HTTPS obbligatorio)
• Accesso amministratore al tuo pannello di amministrazione osCommerce

Metodi di Pagamento Supportati

Ogni metodo può essere abilitato o disabilitato individualmente dal pannello di amministrazione.

1. Installa il Modulo

Scarica o clona il modulo da GitHub.

Copia la directory lib/ nella root del tuo osCommerce 4:

cp -r lib/ /path/to/oscommerce/

Questo posiziona i file del modulo in:

lib/common/modules/orderPayment/nopayn.php
lib/common/modules/orderPayment/nopayn/NoPaynApiClient.php
lib/common/modules/orderPayment/nopayn/NoPaynLogger.php
lib/common/modules/orderPayment/nopayn/NoPaynWebhookHandler.php

Nel tuo pannello di amministrazione osCommerce:

1. Vai a Moduli → Pagamento → Online
2. Abilita i filtri "Mostra inattivi" e "Mostra non installati" se necessario
3. Trova NoPayn Payments e clicca Installa

2. Configura il Modulo

Accedi al Portale Commerciante e vai a Siti Web, poi clicca sul sito web che vuoi collegare. Clicca su Integrazione dove troverai la tua chiave API.

Inserisci la tua chiave API e configura le seguenti impostazioni:

3. Aggiorna le Etichette del Checkout (Consigliato)

Le etichette predefinite dei pulsanti di checkout di osCommerce presuppongono un flusso a passaggio singolo. Per una migliore esperienza con il reindirizzamento al pagamento esterno, aggiorna queste traduzioni in Admin → Localizzazione → Lingue → Italiano → Definisci:

4. Flusso di Pagamento

Una volta configurato, il flusso di pagamento funziona come segue:

1. Il cliente seleziona un metodo di pagamento Cost+ al checkout
2. Il cliente conferma l'ordine
3. Il modulo crea un ordine in attesa e chiama l'API Cost+
4. Il cliente viene reindirizzato alla Pagina di Pagamento Ospitata (HPP) Cost+
5. Il cliente completa il pagamento sull'HPP sicura
6. Il cliente viene reindirizzato al negozio
7. Il modulo verifica lo stato del pagamento tramite l'API Cost+
8. Lo stato dell'ordine viene aggiornato di conseguenza

5. Webhook

Il modulo registra un URL webhook con Cost+ per gli aggiornamenti di stato server-to-server. Quando lo stato di un pagamento cambia, Cost+ invia una notifica e il modulo:

1. Riceve il POST del webhook
2. Verifica lo stato del pagamento tramite API (non si fida mai del payload del webhook)
3. Aggiorna lo stato dell'ordine in osCommerce

Cattura Manuale

Quando abilitata per i pagamenti con carta di credito:

• Il pagamento viene autorizzato ma non catturato al checkout
• I fondi vengono catturati quando l'ordine passa allo stato completato
• Se l'ordine viene annullato, l'autorizzazione viene automaticamente annullata

Logging di Debug

Quando il Logging di Debug è abilitato, il modulo scrive in nopayn_debug.log nella directory dei log di osCommerce. Le voci del log includono:

• Tutte le richieste e risposte API
• Eventi webhook e risultati dell'elaborazione
• Operazioni di cattura e annullamento
• Errori (registrati sempre, indipendentemente dall'impostazione di debug)

Tutte le voci sono precedute dal prefisso NoPayn_ per un filtraggio semplice.

Disinstallazione

1. Vai a Moduli → Pagamento → Online nel pannello di amministrazione
2. Seleziona NoPayn Payments
3. Clicca Rimuovi

Testa e Lancia

Effettua alcune transazioni di test per assicurarti che tutto funzioni correttamente. Ti consigliamo di testare sia i pagamenti riusciti che quelli falliti per confermare che tutti gli scenari vengano gestiti correttamente.

Supporto

Hai bisogno di aiuto? Contatta il nostro team di supporto a support@costplus.io.