Cost+Docs

PrestaShop

Integra Cost+ con il tuo negozio PrestaShop (9.x, 8.x, 1.7 e 1.6)

PrestaShop

Integra Cost+ come metodo di pagamento nel tuo negozio PrestaShop. Il modulo Cost+ è disponibile per PrestaShop 9.x, PrestaShop 8.x, PrestaShop 1.7 e PrestaShop 1.6.1.x.

Prerequisiti

  • Account commerciante Cost+ attivo
  • PrestaShop 9.1 o successivo
  • PHP 8.1 o successivo
  • SSL/HTTPS abilitato
  • Accesso amministratore al tuo back office PrestaShop
  • Account commerciante Cost+ attivo
  • Installazione PrestaShop 8.x
  • PHP 8.0 o successivo
  • Accesso amministratore al tuo back office PrestaShop
  • MySQL 5.4 o superiore
  • Account commerciante Cost+ attivo
  • Installazione PrestaShop 1.7.x
  • PHP 5.4 o successivo
  • Accesso amministratore al tuo back office PrestaShop
  • MySQL 5.4 o superiore
  • Account commerciante Cost+ attivo
  • Installazione PrestaShop 1.6.1.x
  • PHP 5.6 o successivo (con estensioni cURL e OpenSSL)
  • SSL/HTTPS abilitato sulla vetrina
  • Accesso amministratore al tuo back office PrestaShop

1. Installa il Modulo

Scarica il modulo da GitHub.

Metodo A: Caricamento tramite Pannello di Amministrazione (Consigliato)

  1. Vai a Moduli → Gestore Moduli nel tuo pannello di amministrazione
  2. Clicca Carica un modulo
  3. Trascina e rilascia il file ZIP o selezionalo manualmente
  4. Attendi il completamento dell'installazione
  5. Cerca "NoPayn" e clicca Configura

Metodo B: Caricamento Manuale

  1. Copia la cartella nopaynpayment/ nella directory modules/ del tuo PrestaShop
  2. Vai a Moduli → Gestore Moduli
  3. Cerca "NoPayn" e clicca Installa
  4. Clicca Configura per aprire le impostazioni

Scarica il modulo da GitHub.

Metodo A: Caricamento tramite Pannello di Amministrazione (Consigliato)

  1. Vai a Migliora > Gestore Moduli nel tuo pannello di amministrazione
  2. Clicca Carica un modulo
  3. Trascina e rilascia il file ZIP o selezionalo manualmente
  4. Attendi il completamento dell'installazione
  5. Scorri verso il basso alla sezione "Altro" e clicca Configura sotto Cost+

Gestore Moduli PrestaShop 8

Finestra di caricamento modulo

Metodo B: Caricamento Manuale tramite (S)FTP

  1. Estrai il file ZIP scaricato
  2. Utilizzando un client SFTP (es. FileZilla, WinSCP), carica tutte le cartelle nella directory /modules/ della tua installazione PrestaShop
  3. Vai a Migliora > Moduli > Catalogo Moduli
  4. Cerca "Cost+" -- controlla la scheda Moduli Non Installati se necessario
  5. Clicca Installa

Scarica il modulo da GitHub.

Metodo A: Caricamento tramite Pannello di Amministrazione (Consigliato)

  1. Vai a Migliora > Gestore Moduli nel tuo pannello di amministrazione
  2. Clicca Carica un modulo
  3. Trascina e rilascia il file ZIP o selezionalo manualmente
  4. Attendi il completamento dell'installazione
  5. Scorri verso il basso alla sezione "Altro" e clicca Configura sotto Cost+

Gestore Moduli PrestaShop 1.7

Finestra di caricamento modulo

Metodo B: Caricamento Manuale tramite (S)FTP

  1. Estrai il file ZIP scaricato
  2. Utilizzando un client SFTP (es. FileZilla, WinSCP), carica tutte le cartelle nella directory /modules/ della tua installazione PrestaShop
  3. Vai a Moduli > Gestore Moduli
  4. Cerca "Cost+" -- controlla la scheda Moduli Non Installati se necessario
  5. Clicca Installa

Scarica il modulo da GitHub.

Metodo A: Caricamento tramite Pannello di Amministrazione (Consigliato)

  1. Scarica costpluspayment.zip dalla pagina Releases di GitHub
  2. Vai a Modules and Services nel tuo back office PrestaShop
  3. Clicca Add a new module
  4. Carica il file ZIP
  5. Trova Cost+ Payment Gateway nell'elenco dei moduli e clicca Install

Metodo B: Caricamento Manuale tramite (S)FTP

  1. Estrai il file ZIP scaricato
  2. Utilizzando un client SFTP, carica la cartella costpluspayment/ in /modules/costpluspayment/ nella tua installazione PrestaShop
  3. Vai a Modules and Services nel back office
  4. Trova Cost+ Payment Gateway e clicca Install

2. Inserisci le Credenziali API

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.

Portale Commerciante Cost+ che mostra la chiave API

Nella configurazione del modulo NoPayn, inserisci la tua chiave API e configura le seguenti impostazioni:

ImpostazioneDescrizione
API KeyLa tua chiave API NoPayn
Credit / Debit CardAbilita/disabilita i pagamenti con carta di credito
Apple PayAbilita/disabilita Apple Pay
Google PayAbilita/disabilita Google Pay
Vipps MobilePayAbilita/disabilita Vipps MobilePay
Manual CaptureAutorizza solo i pagamenti con carta di credito — cattura alla spedizione
Debug LoggingAbilita il logging dettagliato in var/logs/nopayn_debug.log

Incolla la chiave nel campo API Key nella pagina di configurazione della libreria Cost+ e clicca Salva.

Pagina di configurazione Cost+ in PrestaShop 8

Incolla la chiave nel campo API Key nella pagina di configurazione della libreria Cost+ e clicca Salva.

Pagina di configurazione Cost+ in PrestaShop 1.7

Dopo l'installazione, clicca su Configure sul modulo Cost+ Payment Gateway e imposta quanto segue:

ImpostazioneDescrizione
API KeyLa tua chiave API Cost+ dal portale commerciante
Credit / Debit CardAbilita/disabilita i pagamenti con carta di credito
Apple PayAbilita/disabilita Apple Pay
Google PayAbilita/disabilita Google Pay
Vipps MobilePayAbilita/disabilita Vipps MobilePay
Manual CaptureAutorizza solo i pagamenti con carta di credito — cattura alla spedizione
Checkout ExpiryTimeout degli ordini in sospeso in minuti (predefinito 5)
Debug LoggingAbilita il logging dettagliato in log/costplus_debug.log

Dopo aver salvato, apri Payment > Restrictions e abilita il modulo Cost+ Payment Gateway per ogni valuta che accetti.

Per gli ambienti di hosting PrestaShop 8.x, 1.7 e 1.6, abilita l'opzione pacchetto CA cURL durante la configurazione per evitare problemi con i certificati SSL.

3. Abilita i Metodi di Pagamento

I metodi di pagamento vengono configurati direttamente nelle impostazioni del modulo (vedi passaggio 2 sopra). Attiva o disattiva ciascun metodo secondo necessità.

Attiva solo i metodi di pagamento per cui sei stato approvato e hai ricevuto conferma.

Dopo aver salvato la tua chiave API, carica ciascun modulo del metodo di pagamento separatamente tramite Carica un modulo.

Torna a Migliora > Gestore Moduli, clicca Carica un modulo di nuovo e carica ciascun file ZIP per i metodi di pagamento che vuoi abilitare (es. Carta di Credito, MobilePay, Swish).

Attiva solo i metodi di pagamento per cui sei stato approvato e hai ricevuto conferma.

I moduli di pagamento avranno un'opzione Configura (se è necessaria una configurazione aggiuntiva) o semplicemente un interruttore Abilita/Disabilita.

Dopo aver salvato la tua chiave API, carica ciascun modulo del metodo di pagamento separatamente tramite Carica un modulo.

Torna a Migliora > Gestore Moduli, clicca Carica un modulo di nuovo e carica ciascun file ZIP per i metodi di pagamento che vuoi abilitare (es. Carta di Credito, MobilePay, Swish).

Attiva solo i metodi di pagamento per cui sei stato approvato e hai ricevuto conferma.

I moduli di pagamento avranno un'opzione Configura (se è necessaria una configurazione aggiuntiva) o semplicemente un interruttore Abilita/Disabilita.

I metodi di pagamento vengono attivati direttamente nella pagina di configurazione del modulo (vedi passaggio 2 sopra). Abilita ciascun metodo che vuoi rendere disponibile al checkout.

Attiva solo i metodi di pagamento per cui sei stato approvato e hai ricevuto conferma.

Flusso di Pagamento

  1. Il cliente seleziona un metodo di pagamento Cost+ al checkout
  2. Il cliente viene reindirizzato alla Pagina di Pagamento Ospitata (HPP) di Cost+
  3. Dopo aver completato il pagamento, il cliente viene reindirizzato al negozio
  4. Un webhook conferma lo stato del pagamento server-to-server

Webhook

L'URL del webhook viene configurato automaticamente per ogni ordine:

https://your-shop.com/module/nopaynpayment/webhook

Non è richiesta alcuna configurazione manuale del webhook — il modulo gestisce la registrazione automaticamente.

Cattura Manuale

Quando abilitata per i pagamenti con carta di credito:

  • Il pagamento viene autorizzato ma non catturato al checkout
  • La cattura avviene quando l'ordine viene spedito / contrassegnato come completato
  • Se l'ordine viene annullato, l'autorizzazione viene automaticamente annullata

Rimborso Automatico

Se un ordine con pagamento catturato viene annullato, il modulo emette automaticamente un rimborso totale. I rimborsi parziali possono essere elaborati tramite le note di credito di PrestaShop.

Etichette dei Pulsanti al Checkout

Per una migliore esperienza utente con i flussi di reindirizzamento esterno, considera di aggiornare l'etichetta del pulsante di checkout a "Rivedi ordine" invece di "Conferma e paga", poiché il pagamento effettivo avviene sulla pagina ospitata Cost+. Questa è un'impostazione globale di PrestaShop, non specifica del modulo.

Webhook

Il webhook viene configurato automaticamente dal modulo. Non è richiesta alcuna configurazione manuale.

Webhook

Il webhook viene configurato automaticamente dal modulo. Non è richiesta alcuna configurazione manuale.

Webhook

La pagina di configurazione del modulo mostra un URL di webhook. Copialo nella tua dashboard Cost+ se il tuo account Cost+ richiede una registrazione statica del webhook.

L'endpoint del webhook riceve gli eventi di Cost+, quindi richiama Cost+ con GET /orders/{id} prima di aggiornare l'ordine PrestaShop — questo rende idempotente la gestione dell'URL di ritorno e del webhook.

Cron di Scadenza

La pagina di configurazione del modulo mostra un URL di cron di scadenza. Programmalo per essere eseguito ogni minuto:

* * * * * curl -fsS "https://your-shop.example/index.php?fc=module&module=costpluspayment&controller=cron&token=..." >/dev/null

Utilizza l'URL esatto mostrato nel tuo back office PrestaShop — il token viene generato durante l'installazione ed è diverso per ogni negozio. L'endpoint cron annulla gli ordini Cost+ in sospeso obsoleti dopo il Checkout Expiry configurato.

Cattura Manuale e Rimborsi

  • Con Manual Capture abilitato, i pagamenti vengono autorizzati al checkout e catturati quando l'ordine viene spedito / contrassegnato come completato
  • Se un ordine catturato viene annullato, il modulo emette automaticamente un rimborso totale
  • I rimborsi parziali vengono elaborati tramite le note di credito di PrestaShop

4. Passaggi Finali e Test

  1. Verifica tutti i metodi di pagamento abilitati
  2. Effettua alcune transazioni di test — sia riuscite che fallite — per assicurarti che tutto funzioni correttamente
  3. Configura il comportamento avanzato come cattura manuale vs. automatica in base al tuo processo di evasione

Supporto

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

WooCommerce

Integra Cost+ con il tuo negozio WooCommerce utilizzando il plugin ufficiale WordPress

Magento

Integra Cost+ con il tuo negozio Magento (2.x e 1.9 / OpenMage LTS)

On this page

Prerequisiti1. Installa il ModuloMetodo A: Caricamento tramite Pannello di Amministrazione (Consigliato)Metodo B: Caricamento ManualeMetodo A: Caricamento tramite Pannello di Amministrazione (Consigliato)Metodo B: Caricamento Manuale tramite (S)FTPMetodo A: Caricamento tramite Pannello di Amministrazione (Consigliato)Metodo B: Caricamento Manuale tramite (S)FTPMetodo A: Caricamento tramite Pannello di Amministrazione (Consigliato)Metodo B: Caricamento Manuale tramite (S)FTP2. Inserisci le Credenziali API3. Abilita i Metodi di PagamentoFlusso di PagamentoWebhookCattura ManualeRimborso AutomaticoEtichette dei Pulsanti al CheckoutWebhookWebhookWebhookCron di ScadenzaCattura Manuale e Rimborsi4. Passaggi Finali e TestSupporto