_images/webgriffe-professional-certified.jpg

Modulo di Pagamento Key Client/CartaSì per Magento2

Questa è la documentazione del modulo di pagamento QuiPago per Magento2 che integra la piattaforma con l’omonimo portale di pagamento.

Installazione

Come per tutti i moduli Magento2 l’installazione avviene tramite Composer.

Configurazione

La configurazione generale del modulo è possibile da Stores -> Configuration -> Sales -> Payment Methods -> Portale di Pagamento QuiPago. Le voci di configurazione sono le seguenti:

  • Titolo: permette di specificare il nome del metodo di pagamento che visualizzerà l’utente durante il checkout

  • Abilitato: permette di abilitare o disabilitare il metodo di pagamento.

  • Modalità di Test Abilitata: permette di abilitare la modalità di test. Questa modalità è utile per testare il flusso di pagamento prima di metterlo in produzione in quanto il modulo si interfaccerà con l’ambiente di test di QuiPago. In questo ambiente tutte le transazioni effettuate sono finte e non c’è alcun trasferimento reale di fondi. Quando la modalità di test è attiva verranno utilizzati i seguenti parametri:

    • URL della Pagina di Pagamento (test): è l’URL della pagina di pagamento QuiPago in modalità di test. A meno di cambiamenti di specifiche da parte del gateway questo valore dovrebbe essere impostato su https://coll-ecommerce.keyclient.it/ecomm/ecomm/DispatcherServlet
    • Alias/Insegna Negozio (test): è il codice identificativo del negozio da usare in modalità di test. A meno di cambiamenti di specifiche da parte di QuiPago, dovrebbe essere sempre impostato su payment_3444153
    • Chiave segreta per il calcolo del MAC (test): è la chiave segreta per il calcolo del MAC da utilizzare in ambiente di test. A meno di cambiamenti di specifiche da parte di QuiPago, dovrebbe essere sempre impostata su TLGHTOWIZXQPTIZRALWKG

    Quando invece la modalità di test non è attiva il modulo si interfaccerà con l’ambiente di produzione di QuiPago in cui le transazioni vengono realmente effettuate. In questo caso verranno visualizzate le voci:

    • URL della Pagina di Pagamento (produzione): è l’URL della pagina del portale di pagamento in ambiente di produzione. A meno di cambiamenti di specifiche, dovrebbe essere impostato su https://ecommerce.keyclient.it/ecomm/ecomm/DispatcherServlet
    • Alias/Insegna Negozio (produzione): è il codice identificativo del negozio da usare in modalità di produzione. Questo valore viene comunicato da QuiPago in fase di attivazione del contratto.
    • Chiave segreta per il calcolo del MAC (produzione): è la chiave segreta per il calcolo del MAC da utilizzare in ambiente di produzione. Questo valore viene comunicato da QuiPago in fase di attivazione del contratto.
  • Lingua della Pagina di Pagamento: permette di scegliere in quale lingua deve essere visualizzata la pagina di pagamento in cui l’utente inserisce le informazioni della carta di credito

  • Azione di Pagamento: permette di scegliere se i pagamenti fatti con questo metodo di pagamento devono essere considerati come solo autorizzati o come autorizzati e catturati. Questa opzione dovrebbe essere impostata in accordo con la modalità di contabilizzazione scelta durante l’attivazione del contratto QuiPago.

  • Metodo di cifratura per il calcolo del codice MAC: permette di impostare quale metodo di cifratura utilizzare per il calcolo del codice MAC. Nelle più recenti attivazioni viene sempre utilizzato il metodo SHA1 ma alcuni vecchi contratti necessitano invece del metodo MD5. Se si è in dubbio su quale valore utilizzare fare riferimento al supporto tecnico QuiPago.

  • Debug: permette di attivare la modalità di debug che memorizza maggiori informazioni durante il funzionamento del modulo. E’ utile attivare questa modalità in caso di problemi tecnici per capire meglio cosa non sta funzionando.

  • Payment From Applicable Countries e Payment From Specific Countries: permette di specificare se il metodo di pagamento QuiPago è utilizzabile per tutte le nazioni del mondo o solo da nazioni specifiche

  • Minimum Order Total e Maximum Order Total: permette di specificare quali sono i valori minimi e massimi dell’ordine per cui il metodo di pagamento QuiPago è utilizzabile.

  • Sort Order: permette di impostare un numero di ordinamento che determinerà in quale ordine, nel checkout, il metodo di pagamento QuiPago verrà visualizzato rispetto agli altri metodi attivi

Modalità di Test

La modalità di test è utile per verificare il flusso di pagamento prima di metterlo in produzione in quanto il modulo si interfaccerà con l’ambiente di test di QuiPago. In questo ambiente tutte le transazioni effettuate sono finte e non c’è alcun trasferimento reale di fondi. Quando la modalità di test il modulo di pagamento QuiPago invierà come importo della transazione 1,00 EUR, sempre e comunque. Per simulare una transazione con esito negativo basta utilizzare i dati di una qualsiasi carta di credito reale. Invece, per simulare una transazione con esito positivo, vanno utilizzati i dati della seguente carta di credito:

  • Numero carta: 4000000000000002
  • Scadenza: qualsiasi data futura
  • CVV2: qualsiasi numero a 3 cifre
  • Titolare: qualsiasi nome e cognome

Utilizzo e gestione dell’esito del pagamento

Quando un cliente completa il checkout di un ordine scegliendo come metodo di pagamento QuiPago, viene redirezionato sulla pagina di pagamento esterna. In questo momento Magento imposta lo stato dell’ordine in Pending Payment (o Attesa Pagamento). Dopo che il cliente completa il pagamento inserendo i dati della carta di credito, viene inviato da QuiPago un messaggio server-to-server che comunica l’esito della transazione appena avvenuta. Il modulo di pagamento riceve questa notifica ed effettua, automaticamente, alcune operazioni di gestione del pagamento sull’ordine. Nel caso in cui la transazione non sia stata autorizzata non viene effettuata alcuna operazione e l’ordine rimane in stato Pending Payment. Invece, nel caso in cui la transazione sia andata a buon fine, l’ordine passa automaticamente in stato Processing (o In elaborazione). Sempre in caso di esito positivo, vengono effettuate ulteriori operazioni che variano a seconda dell’Azione di pagamento impostata:

  • Nel caso di Sola Autorizzazione sull’ordine viene creato una Transazione di tipo Autorizzazione che indica a Magento che l’importo di pagamento è stato autorizzato. Per Magento però l’ordine non è ancora pagato e infatti non esiste alcuna Fattura legata all’ordine.
  • Nel caso di Autorizzazione e Cattura invece, sull’ordine viene creata una Transazione di tipo Cattura e viene generata, automaticamente, la Fattura. In questo modo, per Magento, l’ordine è completamente pagato.

Internazionalizzazione

Il modulo di pagamento QuiPago è sviluppato con una interfaccia utente nativa in lingua inglese (en_US). Nel modulo però è anche compresa la traduzione in lingua italiana (it_IT). E’ possibile tradurre l’interfaccia in altre lingua utilizzando il sistema di traduzione nativo di Magento2. Per maggiori informazioni su questo sistema fare riferimento alla documentazione ufficiale di Magento2.