Cost+Docs

OpenCart

Integra Cost+ con il tuo negozio OpenCart (4.x e 3.x / ocStore 3)

OpenCart

Integra Cost+ come metodo di pagamento nel tuo negozio OpenCart. L'estensione ufficiale NoPayn Payment Gateway è disponibile per OpenCart 4 e OpenCart 3 / ocStore 3.

Prerequisiti

  • Account commerciante Cost+ attivo
  • OpenCart 4.0.0.0 o successivo
  • PHP 8.0 o successivo
  • Accesso amministratore alla tua dashboard OpenCart
  • Account commerciante Cost+ attivo
  • ocStore 3.0.x o OpenCart 3.0.3.x
  • PHP 7.4 o successivo
  • Accesso amministratore alla tua dashboard OpenCart

Metodi di Pagamento Supportati

  • Carta di Credito / Debito — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Carta di Credito / Debito — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Swish

1. Installa l'Estensione

Metodo A: Caricamento tramite Pannello di Amministrazione (Consigliato)

  1. Scarica l'ultima release .ocmod.zip da GitHub
  2. Nel tuo pannello di amministrazione OpenCart, vai a Estensioni → Installer
  3. Carica il file .ocmod.zip
  4. Vai a Estensioni → Estensioni → Pagamento
  5. Trova NoPayn Payment Gateway e clicca Installa, poi Modifica

Metodo B: Caricamento Manuale

  1. Scarica o clona il repository
  2. Copia il contenuto della cartella upload/ nella directory root del tuo OpenCart
  3. Vai a Estensioni → Estensioni → Pagamento
  4. Trova NoPayn Payment Gateway e clicca Installa, poi Modifica

Architettura

OpenCart 3 utilizza una configurazione multi-estensione:

  • NoPayn - Global Settings — configurazione condivisa (chiave API, stati degli ordini, disponibilità dei metodi, cattura manuale, logging di debug)
  • NoPayn - Card Payments — checkout con carta di credito/debito
  • NoPayn - Apple Pay / Google Pay — checkout con wallet (se è abilitato un solo wallet, l'etichetta si adatta automaticamente)
  • NoPayn - Vipps MobilePay — checkout Vipps/MobilePay
  • NoPayn - Swish — checkout Swish

Metodo A: Caricamento tramite Pannello di Amministrazione (Consigliato)

  1. Scarica l'asset .ocmod.zip dall'ultima release GitHub

Usa l'asset .ocmod.zip dalla release — non i download "Source code" generati automaticamente da GitHub, che contengono il layout del repository, non il layout dell'installer.

  1. Nel pannello di amministrazione, vai a Estensioni → Installer
  2. Carica il file .ocmod.zip
  3. Vai a Estensioni → Estensioni → Pagamenti
  4. Installa prima NoPayn - Global Settings
  5. Apri NoPayn - Global Settings e configura:
    • Chiave API
    • Stati degli ordini completati, in attesa e annullati
    • Metodi di pagamento disponibili per cui il tuo account commerciante è approvato
    • Opzionale: cattura manuale per carta
    • Opzionale: logging di debug
  6. Installa i moduli di checkout che vuoi esporre:
    • NoPayn - Card Payments
    • NoPayn - Apple Pay / Google Pay
    • NoPayn - Vipps MobilePay
    • NoPayn - Swish
  7. Per ciascun modulo di checkout, imposta: Stato, Zona Geografica e Ordine di Visualizzazione

Metodo B: Caricamento Manuale

  1. Scarica o clona il repository
  2. Copia il contenuto della cartella upload/ nella root del tuo negozio
  3. Vai a Estensioni → Estensioni → Pagamenti
  4. Segui lo stesso ordine di installazione del Metodo A (prima Global Settings, poi i moduli di checkout)

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

Nelle impostazioni di NoPayn Payment Gateway, inserisci la tua chiave API nel campo corrispondente.

In NoPayn - Global Settings, inserisci la tua chiave API nel campo corrispondente. La chiave API è condivisa tra tutti i moduli di checkout — devi inserirla una sola volta.

3. Configura le Impostazioni di Pagamento

  1. Abilita i metodi di pagamento per cui sei stato approvato
  2. Imposta gli stati dell'ordine preferiti per pagamenti completati, in attesa e annullati
  3. Opzionalmente limita i pagamenti per Zona Geografica
  4. Imposta Stato su Abilitato
  5. Clicca Salva

Impostazioni Globali

NoPayn - Global Settings contiene tutta la configurazione condivisa:

ImpostazioneDescrizione
API KeyLa tua chiave API NoPayn
Order StatusesMappatura degli stati completato, in attesa e annullato
Method AvailabilityQuali metodi di pagamento sono approvati per il tuo account commerciante
Manual CaptureAutorizza solo i pagamenti con carta di credito — cattura dopo
Debug LoggingAbilita il logging dettagliato per la risoluzione dei problemi

Impostazioni dei Moduli di Checkout

Ogni modulo di checkout ha le proprie impostazioni per la vetrina:

ImpostazioneDescrizione
StatusAbilita o disabilita questo metodo di pagamento al checkout
Geo ZoneLimita a zone geografiche specifiche
Sort OrderOrdine di visualizzazione nella pagina di 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 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

L'estensione utilizza la Pagina di Pagamento Ospitata Cost+, il che significa che i clienti vengono reindirizzati a un modulo di pagamento sicuro. Nessun dato sensibile della carta viene gestito dal tuo server.

Ogni modulo di checkout è un'estensione di pagamento OpenCart separata, offrendo ai clienti opzioni radio distinte al checkout (es. "Pagamenti con Carta", "Apple Pay & Google Pay").

  1. Il cliente seleziona un'etichetta di metodo di pagamento al checkout (es. Pagamenti con Carta)
  2. L'estensione crea un ordine di pagamento ospitato NoPayn
  3. Il cliente viene reindirizzato alla pagina di pagamento sicura NoPayn
  4. Dopo il pagamento, il cliente ritorna e lo stato dell'ordine viene aggiornato automaticamente
  5. NoPayn invia un webhook per la conferma asincrona dello stato

Il modulo Apple Pay / Google Pay invia entrambi i metodi in un'unica transazione in modo che la pagina ospitata NoPayn possa offrire entrambe le opzioni wallet in un unico flusso.

Aggiornamento dalla v1.0.0 alla v2.0.0

La versione 1.0.0 utilizzava un singolo metodo di checkout chiamato "NoPayn Checkout". La versione 2.0.0 passa a moduli di checkout separati per metodo di pagamento. Durante l'aggiornamento:

  1. Carica il nuovo pacchetto
  2. La tua voce "NoPayn Checkout" esistente diventa NoPayn - Global Settings
  3. Rivedi e salva le impostazioni globali
  4. Installa e abilita i nuovi moduli di checkout che vuoi mostrare ai clienti

4. 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.

modified eCommerce

Integra Cost+ con il tuo negozio modified eCommerce utilizzando il modulo MMLC

Shopware

Integra Cost+ con il tuo negozio Shopware 6 utilizzando il plugin ufficiale di pagamento

On this page

PrerequisitiMetodi di Pagamento Supportati1. Installa l'EstensioneMetodo A: Caricamento tramite Pannello di Amministrazione (Consigliato)Metodo B: Caricamento ManualeArchitetturaMetodo A: Caricamento tramite Pannello di Amministrazione (Consigliato)Metodo B: Caricamento Manuale2. Inserisci le Credenziali API3. Configura le Impostazioni di PagamentoImpostazioni GlobaliImpostazioni dei Moduli di CheckoutFlusso di PagamentoAggiornamento dalla v1.0.0 alla v2.0.04. Testa e LanciaSupporto