Guida all'integrazione con Prestashop

Requisiti preliminari

Prima di iniziare, assicurati di avere:

• Accesso al Backoffice di PrestaShop con permessi di amministratore.

• Accesso al tuo account Omniwallet (e conoscere il tuo sottodominio).

• Il modulo di Omniwallet per PrestaShop scaricato in formato .zip.

1) Scarica il modulo di Omniwallet

1. Accedi alla guida/area download di Omniwallet.

2. Scarica il modulo di Omniwallet per PrestaShop (file .zip) e salvalo sul tuo computer.

2) Installa il modulo in PrestaShop

1. Accedi al Backoffice di PrestaShop.

2. Vai a Moduli (in alcune versioni appare come “Moduli e Servizi” o “Module Manager”).

3. Clicca su Carica un modulo (o “Aggiungi nuovo modulo”).

4. Trascina il file .zip del modulo di Omniwallet o selezionalo dal tuo computer.

5. Aspetta che l'installazione sia completata e conferma che il modulo appare come installato.

Se il caricamento del ZIP fallisce, di solito è a causa di limiti di dimensione o permessi. In tal caso, prova a caricarlo via FTP nella directory dei moduli e poi installalo dal backoffice.

3) Accedi alla configurazione del modulo

1. All'interno di Moduli, cerca Omniwallet.

2. Clicca su Configura.

Lì vedrai i campi di configurazione che collegano PrestaShop con il tuo account Omniwallet.

4) Ottieni il tuo Sottodominio di Omniwallet

Il tuo sottodominio è l'identificatore del tuo account.

• Se il tuo URL è: https://esempio.omniwallet.net o https://esempio.omniwallet.tools

• Il tuo sottodominio è: esempio

Dove metterlo: nel campo “Nome del sottodominio del negozio”.

5) Crea un API Token in Omniwallet

1. Accedi a Omniwallet.

2. Vai a Integrazioni → API (o sezione equivalente).

3. Crea un nuovo API Token.

4. Copia il token.

Dove metterlo: nel campo “Token di Omniwallet” all'interno del modulo in PrestaShop.

Consiglio: conserva questo token in un luogo sicuro. È la “chiave” di connessione.

6) Configura la regola di riscatto (Punti → €)

Nella configurazione del modulo, individua il campo:

“Riscattare punti in euro”

Qui definisci la conversione che vedrà l'utente al momento del riscatto:

• Esempio: 100 punti = 1€

• Oppure: 1 punto = 0,01€

Questo determina quanti punti vengono detratti quando il cliente utilizza punti nel carrello/checkout.

7) Definisci limiti e condizioni (minimi)

Configura questi campi secondo la tua politica di fidelizzazione:

“Acquisto minimo”

Importo minimo per consentire il riscatto dei punti.

• Esempio: il cliente può riscattare solo se l'acquisto è ≥ 20€.

“Acquisto minimo con spedizione”

Attiva questa opzione se desideri che il minimo includa o non includa le spese di spedizione.

• Se attivato: la spedizione conta per raggiungere il minimo.

• Se disattivato: conta solo il subtotale dei prodotti.

8) Collega termini e condizioni del programma

“Punti del programma Omniwallet CMS”

Seleziona la pagina (nel tuo CMS) dove si trovano i termini del programma.

Questo è utile per:

• informare il cliente

• avere il programma ben documentato

• rafforzare trasparenza e conformità

9) Definisci il nome del programma

“Nome del programma di fidelizzazione”

È il nome commerciale del programma che vedrà il cliente (a seconda di come lo mostra la tua configurazione).

Esempio:

• “Club Punti”

• “Rewards”

• “VIP Club”

10) Attiva il modulo

“Omniwallet attivo”

• Attivalo per avviare l'integrazione.

• Se lo disattivi, PrestaShop smette di inviare dati e il riscatto non appare.

11) Configura gli stati dell'ordine (molto importante)

Questo determina quando vengono accreditati i punti e quando vengono revocati.

“Stato di successo dell'ordine”

Seleziona lo stato in cui desideri che i punti vengano confermati.

• Raccomandazione tipica: Consegnato / Spedito / Pagato / Completato (dipende dalla tua operatività)

“Stato di revoca dell'ordine”

Seleziona lo stato che deve annullare i punti.

• Normalmente: Annullato / Rimborsato

Questo evita che qualcuno accumuli punti per un ordine che poi viene annullato.

12) Salva la configurazione

Clicca su Salva.

13) Prova l'integrazione (checklist veloce)

Fai un test reale con un cliente di prova:

Prova A — Acquisto che accumula punti

1. Fai un ordine di prova nel negozio.

2. Cambia l'ordine allo stato di successo (quello che hai configurato).

3. Accedi a Omniwallet e verifica che:

   • la transazione appare

   • i punti sono stati accreditati al cliente

Prova B — Cancellazione che revoca punti

1. Crea un altro ordine.

2. Questo articolo ti è stato utile?

   Sì No