Compatibilità:
WebSite X5 Pro e Agency
Per permettere ai clienti di pagare con carta nel tuo negozio online, puoi utilizzare Stancer, il provider di servizi di pagamento del gruppo Iliad integrato direttamente in WebSite X5.
Per iniziare, devi creare un account Stancer, completare l'attivazione del servizio e inserire le chiavi di collegamento nel tuo progetto.
In questa guida vedremo:
- Come attivare un account Stancer
- Dove trovare le chiavi per collegare il servizio
- Come configurare Stancer in WebSite X5
- Come provare il pagamento prima di utilizzare il servizio
1. Come attivare un account Stancer
Prima di configurare il metodo di pagamento, devi registrarti presso Stancer e completare la procedura di attivazione:
- Accedi al sito Stancer e avvia la creazione di un account.
- Inserisci i dati richiesti e conferma il tuo indirizzo e-mail attraverso il link ricevuto.
- Completa la registrazione con le informazioni sulla tua attività e i documenti richiesti.
- Segui la procedura di sottoscrizione del contratto e attendi l'approvazione da parte di Stancer.
Puoi avviare la registrazione anche da WebSite X5: nella finestra di configurazione del metodo di pagamento, seleziona Stancer by Iliad Group e clicca sul logo Stancer.
#tip - Prima di attivare il servizio, consulta sul sito Stancer le condizioni, le tariffe e i requisiti previsti per la tua attività.
2. Dove trovare le chiavi di collegamento
WebSite X5 richiede due chiavi per collegare il tuo negozio all'account Stancer:
- Public Key, la chiave pubblica;
- Private Key, la chiave privata.
Le chiavi sono disponibili nella sezione Developers dell'area riservata Stancer. Il servizio distingue tra chiavi di test, utilizzate per simulare i pagamenti, e chiavi di produzione, necessarie per ricevere pagamenti reali.
Le chiavi di produzione vengono rese disponibili dopo il completamento della registrazione e l'approvazione dell'account.
#tip - Conserva con attenzione le chiavi di collegamento. In particolare, non condividere la chiave privata e non inserirla nei contenuti delle pagine del sito.
3. Come configurare Stancer in WebSite X5
Per aggiungere Stancer ai metodi di pagamento del tuo store:
- Vai al Passo 1 - Impostazioni e apri E-commerce > Gestione Ordine.
- Clicca su Aggiungi nell'elenco dei metodi di pagamento.
- Nella scheda Generale, imposta il nome e la descrizione del metodo di pagamento da mostrare ai clienti.
- Apri la scheda Tipo e seleziona Pagamento immediato.
- Nel menu Tipo di Pagamento, scegli Stancer by Iliad Group.
- Inserisci le chiavi fornite da Stancer nei campi Public Key e Private Key.
Nella stessa scheda, specifica le pagine del sito da mostrare al termine del pagamento:
- Avvenuto Pagamento: la pagina da visualizzare quando il pagamento va a buon fine;
- Errore Pagamento: la pagina da visualizzare in caso di errore nel pagamento.
Puoi preparare queste pagine nella Mappa del sito, inserendo un messaggio che aiuti il cliente a capire l'esito dell'operazione e come proseguire.
Completa le altre impostazioni del metodo di pagamento e conferma con OK.
#tip - Per informazioni sulle impostazioni comuni ai diversi metodi, consulta la guida Metodi di pagamento. Come configurare quelli disponibili nel tuo store?
4. Come provare il pagamento
Prima di iniziare a ricevere pagamenti reali, verifica la configurazione utilizzando l'ambiente di test:
- Inserisci nei campi Public Key e Private Key le chiavi di test del tuo account Stancer.
- Attiva Sandbox enabled (Test mode).
- Conferma le modifiche e pubblica il progetto su uno spazio di prova.
- Esegui un ordine scegliendo Stancer e utilizza i dati di pagamento di test indicati nella documentazione del provider.
- Verifica il funzionamento del pagamento e la visualizzazione delle pagine di conferma e di errore.
Al termine delle verifiche:
- sostituisci le chiavi di test con le chiavi di produzione;
- disattiva Sandbox enabled (Test mode);
- conferma le modifiche e pubblica il progetto aggiornato.
#tip - Le chiavi inserite devono corrispondere all'ambiente utilizzato: chiavi di test per le prove in Sandbox, chiavi di produzione per i pagamenti reali.