Modulo Magento Banca Sella Unlimited (GestPayS2S - MyBank - Riskified - Multivaluta) v.1.2.x

Modulo Magento

Il modulo permette di connettere un negozio Magento a Banca Sella in modalità "Server to Server" per un profilo Unlimited. Il modulo presenta nella sezione pubblica del carrello un modulo di inserimento dei dati della carte di credito abilitate. La transazione viene eseguita senza essere reindirizzati nel sito della Banca Sella.

Cos'è un modulo Magento?

Un modulo Magento non è altro che un'estensione delle funzionalità del software ecommerce Magento.

AGGIORNAMENTO DOCUMENTAZIONE 

QUESTA DOCUMENTAZIONE SI RIFERISCE AL VECCHIO MODULO

La nuova documentazione si trova al link https://docs.bancasella.shinesoftware.it 

Requisiti del modulo

L’utilizzo di GestPay e quindi anche del webservice GestPayS2S è riservato alle aziende che abbiano stipulato gli appositi contratti con EasyNolo e Banca Sella, per la gestione delle transazioni con carta di credito online e siano quindi diventate “Esercenti convenzionati”. Un esercente convenzionato GestPay è riconosciuto da un codice identificativo detto “Shop Login” ed ha diritto ad utilizzare l’ambiente di Back Office tramite uno o più operatori registrati al portale Sella.it (almeno un operatore, con la qualifica di Amministratore, è necessario per l’attivazione del servizio). Per sottoscrivere il servizio di Banca Sella bisogna far click su https://www.gestpay.it/gestpay/form/gestpay-unlimited.jsp

Attenzione: bisogna attivare tutte le funzionalità del Server2Server richiedendone espressa attivazione a Banca Sella.

GestPay, inoltre, accetterà le chiamate solo se provenienti da un indirizzo IP associato allo Shop Login dell’esercente chiamante. E’ quindi necessario, sempre dal Back Office (sezione indirizzi IP), inserire l’indirizzo IP del server che eseguirà le chiamata al web service GestPayS2S.

Infine bisogna richiedere al proprio hosting provider un certificato SSL per poter proteggere le comunicazioni della propria clientela. Vedi nella sezione certificato SSL.

Quale versione il modulo supporta?

Il modulo supporta pienamente l'ultima versione del progetto Magento. I test effettuati ci dimostrano il suo funzionamento dalla versione 1.7.x fino all'ultima versione disponibile.

Installazione del modulo

Dopo aver installato Magento ed acquistato il modulo potrete scaricare il file compresso contenente il modulo.

Decomprimere il file nel vostro computer ed inviare la cartella app contenuta nel file compresso nella cartella di root del vostro sito internet via FTP.

Entrate nell'area amministrativa di Magento (se eravate già dentro l'area amministrativa scollegatevi e ricollegatevi).

- Svuotate la Cache di Magento

- Accedete all'area amministrativa di magento, nel menù troverete la voce Banca Sella.

Se si era già connessi nell'area amministrativa di magento disconnettersi e rieffettuare il login.

In ogni caso suggeriamo caldamente a tutti coloro che non sono tecnici di richiedere il servizio di installazione del modulo direttamente sottoscrivendo il seguente servizio di installazione moduli magento.

Accesso diretto alle funzionalità

Per poter accedere alle funzionalità del modulo basta far click nel menù amministrativo di Magento in alto sulla voce Vendite > Payment Methods > Banca Sella (ver. 1.2.6). 

Checkout Utente

Il checkout utente di Magento offre un menù a pannelli che permettono di gestire i passi durante la fase di acquisto. Nel pannello relativo ai metodi di pagamento disponibili, dopo l'installazione, sarà possibile visualizzare la seguente sezione:

Checkout

Configurazione del Modulo

Per configurare il modulo bisogna accedere nell'area amministrativa di magento e far click nel menù a tendina di magento con il nome: Banca Sella > Configurazione.

Configurazione

 

  • Final Order Status
    • Status finale dell'ordine a transazione avvenuta correttamente.
  • Enabled
    • Attivazione del modulo. Se il modulo non dovesse apparire nella sezione Chckout controllare sempre questo parametro.
  • New Order Status
    • Stato dell'ordine alla sua creazione
  • Sort Order
    • Ordinamento del metodo di pagamento rispetto gli altri metodi attivi nel negozio
  • Title
    • Nome pubblico associato al metodo di pagamento visibile nella pagina di checkout, ordini, email, fatture.
  • Payment to applicable countries
    • Filtro per nazioni. Se attivo, solamente le nazioni selezionate potranno usare il presente metodo di pagamento.
  • Payment to specific countries
    • Vedi parametro filtro precedente.
  • Shop Login
    • Codice identificativo del profilo Banca Sella Unlimited attivato.
  • Save Credit Card
    • Registrazione dei dati di carta di credito dell'acquirente.
  • Moneta
    • Set di valute offerte per i pagamenti con Banca Sella Unlimited. Per poter usare queste valute bisogna impostare i vari stores/view dal pannello di controllo di Magento: Sistema > Configurazione > Generale > Impostazioni Valuta > Valute Consentite. Selezionare tutte le valute desiderate. Successivamente impostare il presente campo affinche riconosca la valuta selezionata nelle impostazioni generali. Le valute devono essere attivate nel profilo esercente. Qualora una valuta non venisse trovata il sistema imposterà la valuta di default (EURO).
  • Template email di Fallimento
    • Tal funzionalità è stata realizzata per conoscere se uno dei cliente non è riuscito a completare l'ordine per via di un problema con il sistema di pagamento. Permette di sapere in anticipo e di non perdere il potenziale cliente ed il suo carrello attraverso un'email di sistema che avvisa l'amministratore del negozio inviando tutti i dettagli del carrello bloccato. Per abilitare tale funzionalità bisogna creare un email commerciale partendo dal template email standard di magento in Sistema > Email Commerciali. Impostare un nome all'Email Commerciale ed una lingua. Non modificare le variabili presenti nel corpo dell'email commerciale. Salvare il modello ed accedere nel pannello di configurazione del modulo Banca Sella Unlimited per impostare la nostra nuova Email Commerciale.
    • Salva il numero di carta di credito inserito dal cliente nascondendo alcune cifre. Ad es: 1234-xxxx-xxxx-4321. Attenzione, se la gestione dei LOG di Magento è attiva il numero di carta di credito verrà registrato nel file di testo in var/log/bancasella.log
  • Token
    • Abilita la gestione del Token di Banca Sella. Vedi in basso.
  • Social Security Number (v. 1.2)
    • Attributo nel quale viene registrato il codice fiscale del cliente, utile per la funzione Riskified.
  • MyBank (v.1.1.3)
    • Abilita la funzionalità di MyBank. Attenzione, se attiva tale funzione bisogna impostare il pannello di controllo di Banca Sella aggiungendo i seguenti parametri: [paymentTypeDetail, paymentTypes, languageId]
  • MyBank Cron Frequency (v.1.1.5)
    • Operazione pianificata impostata nel cron di magento per l'aggiornamento della cache delle banche aderenti al servizio. (cron syntax)
  • Update Cache Now (v.1.1.5)
    • Aggiornamento manuale della cache delle banche aderenti al servizio MyBank.
  • Force rounding of the total
    • Forza l'arrotondamento dell'importo da inviare a Banca Sella
  • Credit Card Types
    • Circuiti attivati e disponibili Banca Sella.
  • Currency
    • Moneta usata durante la transazione.
  • Riskified Fraud Prevention  (v.1.2)
    • Riskified permette di ricevere una conferma ed una garanzia oltre che una copertura alle transazioni effettuate on line. 
  • Riskified Cron Frequency  (v.1.2)
    • Il controllo della transazione avviene ogni 2 ore. Riskified controlla la transazione e notifica l'esercente dello status della transazione. Nelle note dell'ordine appariranno dei commenti che permetteranno di valutare se proseguire o annullare l'ordine. E' facoltà dell'esercente gestire il proprio ordine ma se dovesse farlo senza la conferma da parte di Riskified si prenderà tutte le responsabilità sulla natura della transazione.
  • IPN Cron Frequency (v.1.2)
    • Al termine dell'acquisto dei prodotti e dei servizi nel negozio, l'ordine rimane in attesa da parte del cron impostato ogni 5 minuti per il primo controllo formale della transazione da parte della banca. Se la transazione viene considerata affidabile da parte della banca, lo status dell'ordine verrà modificato in Elaborazione.
  • Timeout  (v.1.2)
    • Tempo massimo di controllo di ogni singolo ordine via IPN e Riskified. Se disabilitato, il modulo tenterà di chiamare i servizi della banca anche se l'ordine risultasse vecchio.
  • Status
    • Modalità d'uso del modulo

Le etichette potrebbero essere differenti poichè tradotte in italiano.

Configurazione Pannello Banca Sella

Il modulo per poter funzionare correttamente necessita di un profilo Banca Sella Unlimited di Test ed un profilo Banca Sella Unlimited ufficiale. Per creare un profilo di test basta far click nel presente link: https://www.sella.it/AuthenticationDelegatedServlet?delegated_service=208 e registrarsi.

I dati necessari per accedere all'area di test di Banca Sella (https://testecomm.sella.it/gestpay/backoffice/logingestpay.asp) devono essere:

  • Codice Esercente
  • Chiave(pin) - (Password amministrativa banca sella)

Questi parametri di accesso saranno inviati via email dopo la registrazione del profilo.

Se si desidera si può effettuare un test con il vostro account realizzato su Banca Sella Gestpay. Abbiamo già configurato tutti i parametri per far funzionare il modulo di pagamento con l'opzione Token inclusa correttamente.

L'Area Amministrativa di Banca Sella per i test è identica all'area amministrativa ufficiale. Prima di tutto bisogna accedere al pannello di controllo di Banca Sella:

Login Banca Sella

Dopo il login bisogna impostare gli indirizzi IP del proprio nome a dominio per poter essere riconosciuti dal server durante le richieste effettuate dai potenziali clienti. Se si utilizza il nostro account su Gestpay indicato precedentemente AGGIUNGERE il vostro indirizzo IP in questa lista. NON CANCELLARE gli IP indicati precedentemente, servono per permettere ad altri utenti di effettuare i loro test nei loro negozi.

Pannello Indirizzi IP

Inserire gli indirizzi IP dal quale proverranno le richieste inviate ai server di Banca Sella.

Impostare la modalità MOTO nel sito di Banca Sella, per una maggiore libertà di gestione con Magento durante le fasi amministrative di fatturazione.

Banca Sella MOTO

Le società emittenti, al fine di rendere più sicure le transazioni via web, utilizzano particolari codici di sicurezza che hanno la funzione attestare se l’utilizzatore è effettivamente in possesso della card, prevenendo così possibili frodi. Tale codice ha il nome di CVV oppure CVV2. Ecco come impostare la richiesta del campo CVV in Banca Sella.

Banca Sella CVV

Impostareil campo CVV come parametro ed al termine dell'impostazione fare click sul pulsante Pubblica.

Test Modulo

Il modulo può essere testato inserendo nel proprio negozio magento un prodotto da un centesimo ed utilizzando una carta di credito valida. Procedere all'acquisto del prodotto inserito precedentemente come normale utente ed inserire il proprio numero di carta di credito nella sezione di pagamento. Completare l'ordine.

 

Carte Visa

Carta Scadenza Note
4012001038443335 05/17 Autorizza sempre con qualsiasi importo
4775718800001028 05/17 Nega sempre con qualsiasi importo
4012001037141112 05/17 Trx full 3d: carta abilitata e autenticazione ok

 

Carte Mastercard

Carta Scadenza Note
5412388800001018 05/17 Autorizza sempre con qualsiasi importo
5412388800002016 05/17 Nega sempre con qualsiasi importo

I test effettuati con qualunque altra carta restituiranno un esito negativo.

 

Amministrazione delle Carte di Credito

Il modulo di pagamento Banca Sella Unlimited offre la possibilità di registrare le carte di credito della clientela nell'archivio di Magento. Tale funzionalità è attiva solamente se l'opzione Save Credit Card viene attivata nella sezione Configurazione. Per poter visualizzare e gestire le carte di credito è possibile accedere alla voce presente nel menù amministrativo Banca Sella > Manage Credit Cards

Amministrazione Carte di credito

Amministrazione Carte di Credito

Visualizzazione della Cache MyBank

Al fine di velocizzare il caricamento della pagina di Checkout di Magento è stata realizzata una cache della lista delle banche aderenti al servizio MyBank. Il modulo controllerà periodicamente se vi sarà una modifica alla lista delle banche rilasciata da Banca Sella. E' possibile impostare un'operazione pianificata Cron direttamente dal pannello di controllo utilizzando la sintassi cron. E' consigliabile aggiornare la lista almeno una volta al mese. La tabella nel database che mantiene la cache si chiama: "mybank". Se tale tabella non è presente nel vostro archivio magento il modulo non è stato installato e/o aggiornato correttamente ed in questo caso vi consigliamo di richiedere il nostro servizio di installazione Moduli Magento direttamente accedendo alla seguente pagina: http://www.shinesoftware.com/installazione-e-configurazione-moduli-magento.html 

MyBank Cache

Richiesta di Autorizzazione

Dopo l'inserimento dei dettagli della carta di credito da parte del potenziale cliente, il modulo Banca Sella trasmetterà a GestPay tutti i dati precedentemente assegnati; GestPay controllerà la corrispondenza tra i dati ricevuti e la configurazione impostata tramite Back Office di Banca Sella e, in caso positivo effettuerà l’operazione.

La configurazione M.O.T.O. (CONSIGLIATA)  prevede la separazione tra la fase di autorizzazione e quella di movimentazione, l’attività di GestPay. Se attivata la prima transazione sarà limitata alla richiesta di autorizzazione. Se, invece, la configurazione M.O.T.O. è disattivata, tale funzionalità prevede la contestualità tra la fase di autorizzazione e quella di movimentazione, allora GestPay effettuerà la richiesta di autorizzazione e, in caso di risposta positiva, provvederà di seguito ad effettuarne la movimentazione durante la fase di fatturazione.

Movimentazione

E’ l’operazione di conferma finanziaria che può seguire una autorizzazione positiva. Può esistere solo per esercenti con una configurazione M.O.T.O. che prevede la separazione tra la fase di autorizzazione e la fase di movimentazione. Se vi è una separazione delle operazioni di Autorizzazione e di Movimentazione, Magento effettuerà alla creazione dell'ordine, tramite la pagina di checkout una richiesta di blocco del denaro necessario per l'acquisto della merce (l'esercente riceverà una email di conferma da Banca Sella). L'amministratore del negozio Magento emetterà la fattura. Poco prima di emettere la fattura il sistema richiederà la movimentazione del denaro a Banca Sella (l'esercente riceverà una email di conferma da Banca Sella).

Fattura e Cattura On Line

Storno

E’ l’operazione di annullo (totale o parziale) di una movimentazione. Contabilmente consiste nell’addebito dell’esercente e conseguente riaccredito della somma sulla carta del compratore. Ovviamente, può essere effettuata solo su transazioni già movimentate. Una transazione movimentata può essere stornata anche più di una volta, per importi parziali, fino ad un totale pari alla somma per cui è stata movimentata. Tali operazioni vengono effettuate da Magento attraverso il pannello di controllo Vendite > Ordini e Vendite > Fatture > Nota di Credito.

Storno - Nota di Credito

Scheda Amministrazione Ordine

Nella sezione Ordini, selezionando un ordine saldato con il Metodo di Pagamento Banca Sella Unlimited, sarà visibile una sezione dedicata al metodo utilizzato dal cliente che apparirà nella seguente forma:

Banca Sella Unlimited Server to Server

Transazioni Magento

Magento sfrutta un sistema di registrazione delle transazioni di pagamento che avvengono via Banca Sella. Ecco un esempio di un insieme di transazioni che comprendono: Ordine, Autorizzazione, Cattura, e Storno.

Transazioni

Transazioni Commenti

Token

Il Token è un'opzione che consente di registrare in un archivio sicuro un codice esadecimale che corrisponde ad una carta di credito. Il cliente dopo aver acquistato la prima volta nel negozio, avrà la possibilità di utilizzare un codice al posto della sua carta di credito. La gestione del Token è attivabile dal pannello di controllo del modulo Banca Sella Unlimited.

Banca Sella Unlimited Token

L'attivazione dell'opzione del Token necessita di una configurazione del pannello di controllo della Banca Sella in cui alcuni parametri dovranno essere restituiti dalla banca al momento dell'avvio della transazione. Ecco il pannello di Gestpay Banca Sella e la sua configurazione per la gestione del Token.

Banca Sella Gestpay - Token

Checkout

Al checkout dell'ordine in Magento, il cliente che precedentemente ha già acquistato nel negozio usando la sua carta di credito, troverà oltre all'opzione di inserimento del numero di carta di credito anche la possibilità di selezionare un Token precedentemente creato per velocizzare la fase di acquisto. Il cliente quindi potrà:

  • Reinserire nuovamente una carta di credito (anche uguale alla precedente, verrà creato un nuovo token)
  • Inserire una nuova carta di credito dei circuiti attivi
  • Selezionare un token dalla lista proposta nella fase di scelta del modulo di pagamento

MO.TO (Mail Order/Telephone Order) - Ordini via eMail o per via Telefonica (versione 0.5.0)

È, inoltre, possibile utilizzare il metodo di pagamento con addebito diretto (autorizzazione) per le cosiddette operazioni MO.TO (Mail Order/Telephone Order) in Magento. Tale operazione risulta molto utile per le aziende che ricevono le richieste di acquisto via telefono o via email da parte dei clienti. L'esercente può richiedere per via telefonica al cliente i dettagli della sua carta di credito ed accedendo nell'area amministrativa di Magento può creare un ordine e addebitarlo al cliente. Tale operazione di "autorizzazione" blocca il denaro del cliente finchè non verrà richiesta la "cattura" dell'importo indicato nel totale dell'ordine usando la funzionalità "Cattura On Line" di Magento.

Per poter utilizzare la funzionalità MO.TO l'esercente dovrà richiedere alla Banca Sella la disattivazione del sistema 3D Secure. Tale disabilitazione permetterà al modulo di richiedere l'autorizzazione sulla carta di credito del cliente. Non è possibile utilizzare  il servizio 3D secure ("Verified by VISA", "MasterCard Secure Code") poichè l'esercente non può richiedere al cliente la chiave di sicurezza della carta di credito. Tale opzione, come indicato in precedenza, deve essere richiesta al call center della Banca Sella indicando il codice utente impostato nella configurazione del modulo di pagamento.

Se attivata la funzionalità Token, verranno registrate le carte di credito dei clienti (in chiaro oppure protette), con la possibilità della sovrascrittura della maggior parte delle cifre della carta di credito ai fini della sicurezza dei dati, ed ottenere un Token per poter offrire alla clientela un servizio veloce di sottoscrizione dei prodotti e/o servizi proposti nel proprio negozio Magento. 

La funzionalità MyBank non può essere utilizzata nella sezione amministrativa di Magento poichè non è possibile richiedere le credenziali di un conto corrente ad un cliente durante la fase di acquisto on line.

MyBank

MyBank è una soluzione di autorizzazione elettronica che consente ai consumatori di effettuare in modo sicuro pagamenti online e autenticazioni dell’identità digitale usando il servizio di online banking delle propria banca.   

MyBank crea un collegamento diretto online tra il conto corrente bancario del cliente e la banca dell’esercente, evitando di richiedere e memorizzare dati personali. L’identità digitale del cliente e i suoi dati sensibili sono sempre protetti. L’autorizzazione immediata dei pagamenti riduce il rischio di frodi e ri-addebiti. Grazie a MyBank le transazioni online avvengono con più fiducia e serenità.

MyBank e-payment consente di ottenere, in tempo realeun’autorizzazione per il trasferimento di fondi dal conto bancario del cliente a quello dell’esercente online, utilizzando un bonifico SEPA.

Tale funzionalità è attivabile da pannello di controllo di Magento. Vedi parametri di configurazione in alto. 

 


Configurazione dei percorsi di risposta 

Per poter far modificare lo status dell'ordine da "Pending" a "Processing", il modulo deve ricevere la conferma da parte della banca. Per ricevere le risposte da Banca Sella bisogna impostare i percorsi di reindirizzamento. Ecco un esempio utilizzato nel nostro negozio di test. Modificate il vostro nome http://magento.shinesoftware.it/ con il vostro dominio e salvate la configurazione. Foto indicativa il dominio indicato è puramente di esempio. Bisogna modificarlo con il proprio dominio.

 

Attenzione: chiedere sempre se il proprio profilo presente in Banca Sella consente le richieste per il metodo MyBank. 

 

Banca Sella & Paypal

Banca Sella ha una convenzione con il più grande pos virtuale on line: Paypal. Tale convenzione permette di reindirizzare un utente in una pagina di comodo della banca al termine della procedura di acquisto nella pagina di checkout di Magento. Tale opzione escluderà la gestione Server 2 Server del piano Banca Sella Unlimited. La commissione di transazione bisogna sempre trattarla con Paypal anche se vi è una convenzione fra le due società, poichè tale convenzione è meramente tecnica con Banca Sella. Banca Sella permetterebbe al cliente attraverso una pagina web di scegliere se pagare con una carta di credito o con un account di Paypal. Tale opzione non è presente nel nostro modulo poichè interrompe il workflow di pagamento direttamente nel sito dell'esercente.

Riskified Fraud Prevention (ver. 1.2)

Riskified è un servizio di gestione delle frodi. La banca riceve i dati dell'ordine dal commerciante e vengono inviati a Riskified con altri dati e viene restituita una risposta di controllo sull'ordine (Approvato o Rifiutato).
Questa opzione dà al commerciante uno strumento di prevenzione della frode legata a ogni transazione, fornito da RISKIFIED.

Per ogni ordine è possibile inserire nel xml una serie di parametri che consentono Riskified la possibilità di valutare il rischio di frode legato all'ordine questi parametri sono presenti nel tag ORDERDETAILS. Maggiori informazioni sono fornite a Riskified, più accurata è la valutazione del rischio. Il modulo invia tutti i dati presenti in Magento ed inseriti dal cliente in fase di acquisto.

Nella scheda dell'ordine il modulo scriverà, se il controllo antifrode è stato superato oppure non ha passato i controlli di sicurezza di Riskified.

Beacon ID

Durante la navigazione del sito internet verrà creato un codice chiamato BeaconID che invierà alcune informazioni al sistema di sicurezza Riskified che controllerà la provenienza della transazione. Per attivare questo script bisogna fare attenzione alla struttura del proprio template Magento. Lo script Beacon verrà installato nel footer del template di Magento.

 

Vista la molteplicità di personalizzazioni dei template magento è pressocchè impossibile controllarne tutte le opzioni di ogni singolo negozio Magento. Proprio per questo motivo, se lo script non fosse presente durante la normale navigazione del negozio Magento, bisogna controllare o richiedere un controllo approfondito nella struttura grafica del layout di Magento all'azienda che ha realizzato il template accertandosi che la sezione di layout footer presente nel layout standard di magento sia presente nel proprio template.

Scheda dell'ordine

Cronjob (ver. 1.2)

Il modulo funziona solamente se il sistema Cronjob è attivo nel proprio hosting. Contattare il proprio hosting provider per richiedere l'attivazione del servizio. Come si può vedere dalle impostazioni di default del modulo vi sono tre distinte operazioni pianificate:

  • CheckIPN
    • Questa operazione controlla se l'ordine può essere considerato attendibile da Banca Sella e dagli istituti di credito. Il sistema controlla di default, ogni 5 minuti, se le transazioni legate agli ordini, sono attendibili e pone lo status dell'ordine da in attesa a in elaborazione. L'opzione può essere modificata da pannello di controllo del modulo. Vedi sopra.
  • MyBank
    • Questa operazione scarica in una tabella di Magento generata all'istallazione del modulo, la lista di tutti le banche collegate al servizio MyBank. L'opzione può essere modificata da pannello di controllo del modulo. Vedi sopra.
  • Riskified
    • Questa operazione controlla se l'ordine può essere considerato attendibile da Riskified attendibile offrendo una garanzia all'esercente. L'opzione può essere modificata da pannello di controllo del modulo ma Riskified controlla gli ordini ogni 2 ore. Vedi sopra.



Configurazione Gestpay 

Per utilizzare i servizi di Banca Sella bisogna configurare il pannello di controllo della banca nel servizio chiamato Gestpay. Il pannello di controllo fornisce agli esercenti un vero e proprio cuscotto di funzionalità pre-abilitate dalla banca solo DOPO un CONTRATTO. Durante la fase di test potete chiedere di attivare nel vostro account tutte le specifiche opzioni necessarie senza sottoscrivere alcun contratto. I servizi quali il pagamento con carta di credito on site, il controllo del Verify by VISA o Mastercard Secure Code, oppure il servizio MyBank necessitano di alcuni parametri attivi nel pannello Gestpay per poter essere utilizzati dal modulo di Magento. L'assenza di tali parametri o la cattiva configurazione bloccherà il vostro account o non sarà possibile connettersi al servizio richiesto. Quindi prima di tutto bisogna contattare la Banca Sella e chiedere un account di test che rispecchi le impostazioni del contratto attivato dall'esercente, successivamente si necessita di una corretta configurazione dei parametri del pannello gestpay ed infine bisogna impostare il pannello di controllo del modulo di pagamento Banca Sella dentro Magento. Il vantaggio del nostro modulo è il file di LOG generato che contiene tutti i dati inviati e ricevuti dai server della Banca Sella. Tale file può essere inviato al reparto tecnico della Banca Sella per capire come mai il vostro profilo non funziona correttamente. Ecco un esempio di configurazione del pannello Gestpay:

Traduzioni

Magento gestisce facilmente le traduzioni usando il file csv che si trova nella locazione /app/locale/it_IT/ShineSoftware_Bancasella.csv Qualora una parola o più parole non siano presenti nella lingua italiana, è possibile inserirle nel file su indicato per poter controllare la traduzione del vostro nuovo metodo di pagamento.

 

Codici di errore comuni

Durante le transazioni di pagamento il cliente potrebbe inserire una carta di credito non valida, senza fondi, non riconosciuta, bloccata, ecc...

Il modulo di magento Banca Sella Unlimited controlla se la carta di credito e le sue informazioni sono formalmente corrette durante la digitazione dei dati da parte del cliente. Successivamente i dati formalmente corretti vengono inviati ai server della banca sella che controllerà nuovamente se sono corretti. Banca Sella invierà questi dati all'istituto di credito (VISA, MASTERCARD, ecc...) per richiedere un controllo approfondito dei dati della carta di credito e riceverà una risposta positiva oppure negativa con la dovuta descrizione dell'errore. Ecco ad esempio gli errori inviati da Banca Sella e dagli istituti di credito:

Codice     Descrizione
0     Transazione correttamente effettuata
10     Pagina di pagamento caricata correttamente
57     Carta bloccata
58     Importo conferma superiore ad importo autorizzato
63     Richiesta di movimentare una autorizzazione inesistente
64     Preautorizzazione scaduta
65     Divisa non corretta
66     Preautorizzazione già notificata
74     Autorizzazione negata
97     Autorizzazione negata
100     Transazione interrotta dal sistema autorizzativo della banca
150     Configurazione esercente errata in sistema autorizzativo banca
208     Data carta errata
212     Sistema autorizzativo banca non disponibile
251     Disponibilità carta non sufficiente
401     Chiamare Ente
402     Chiamare Ente
403     Errore tecnico
404     Ritirare carta
405     Autorizzazione negata dai circuiti
406     Errore tecnico
409     Errore tecnico
412     Errore tecnico
413     Errore tecnico
414     Carta non riconosciuta
415     Errore tecnico nel colloquio con i circuiti internazionali
416     Pin errato
417     Autorizzazione negata
418     Rete non disponibile
419     Data transazione errata
420     Data carta errata
430     Errore tecnico
431     Errore tecnico nel colloquio con i circuiti internazionali
433     Carta scaduta
434     Autorizzazione negata dai circuiti
435     Autorizzazione negata dai circuiti
436     Carta non abilitata
437     Operazione non permessa
438     Operazione non permessa (Tentativi pin esauriti)
439     Carta non riconosciuta
441     Carta bloccata
443     Carta bloccata
451     Importo non disponibile
454     Carta scaduta
455     Operazione non effettuata
456     Carta non riconosciuta
457     Autorizzazione negata dai circuiti
458     Configurazione esercente errata in sistema autorizzativo banca
461     Importo non disponibile
462     Carta bloccata
468     Sistema autorizzativo banca non disponibile
475     Operazione non permessa
490     Errore tecnico
491     Errore tecnico nel colloquio con i circuiti internazionali
492     Errore tecnico nel colloquio con i circuiti internazionali
494     Errore tecnico
516     Operazione abbandonata dal compratore
551     Bonifico non autorizzato
552     Pagamento MyBank non effettuato
553     Pagamento MyBank abbandonato dal compratore
600     Errore tecnico
613     Errore tecnico
614     Errore tecnico
615     Errore tecnico
810     Sistema autorizzativo banca non disponibile
811     Configurazione esercente errata in sistema autorizzativo banca
901     Autorizzazione negata
902     Autorizzazione negata
903     Autorizzazione negata
904     Autorizzazione negata
905     Autorizzazione negata
906     Autorizzazione negata
907     Autorizzazione negata
908     Autorizzazione negata
910     Autorizzazione negata
911     Autorizzazione negata
913     Autorizzazione negata
914     Autorizzazione negata
915     Autorizzazione negata
916     Autorizzazione negata
917     Autorizzazione negata
918     Autorizzazione negata
919     Autorizzazione negata
920     Autorizzazione negata
950     Carta non abilitata
951     Configurazione esercente errata in sistema autorizzativo banca
998     Carta di credito con Check-digit errato
999     Operazione non effettuata
1100     Stringa di parametri vuota
1101     Formato non valido della stringa di parametri
1102     Simbolo = non preceduto da nome parametro
1103     La stringa di parametri termina con un separatore
1104     Nome parametro non valido
1105     Valore parametro non valido
1106     Nome parametro ripetuto
1107     Nome parametro non previsto. Verificare la configurazione Campi e Parametri nel Back Office.
1108     Parametro obbligatorio non valorizzato
1109     Parametro mancante
1110     Parametro PAY1_UICCODE non presente
1111     Codice divisa non valido
1112     Parametro PAY1_AMOUNT non presente
1113     Importo non numerico
1114     Importo con numero di decimali errato
1115     Parametro PAY1_SHOPTRANSACTIONID non presente
1116     Parametro PAY1_SHOPTRANSACTIONID troppo lungo
1117     Identificativo lingua non valido
1118     Il numero di carta contiene caratteri non numerici
1119     Lunghezza errata del numero di carta di credito
1120     Carta di credito con Check-digit errato
1121     Carta di credito di una compagnia non abilitata
1122     Anno di scadenza senza mese di scadenza
1123     Mese di scadenza senza anno di scadenza
1124     Mese di scadenza non valido
1125     Anno di scadenza non valido
1126     Data scadenza superata
1127     Indirizzo email compratore non valido
1128     Stringa di parametri troppo lunga
1129     Il valore assegnato al parametro è troppo lungo
1130     Chiamata non accettata: parametro A mancante
1131     Chiamata non accettata: negozio non riconosciuto
1132     Chiamata non accettata: il negozio non è attivo
1133     Chiamata non accettata, manca il parametro B
1134     Chiamata non accettata: parametro B vuoto
1135     Chiamata non accettata: presenti altri parametri oltre ad A e B
1136     Chiamata non accettata: la transazione non è iniziata con una chiamata al sistema di crittografia server-server
1137     Chiamata non accettata: la transazione è già stata processata precedentemente
1138     Chiamata non accettata: numero carta o scadenza carta mancanti
1139     Chiamata non accettata: il negozio non ha una pagina di pagamento pubblica
1140     Transazione abbandonata dal cliente
1141     Chiamata non accettata: stringa di parametri non accettabile
1142     Chiamata non accettata: indirizzo IP non valido
1143     Transazione abbandonata dal compratore
1144     Campo obbligatorio non valorizzato
1145     OTP invalida
1146     Importo troppo basso
1147     Importo troppo alto
1148     Nome del compratore non valido
1149     CVV2 mancante o errato
1150     Valorizzare IPIN
1151     Parametri errati
1153     Impossibile verificare l'abilitazione della carta al servizio VBV
1154     Chiamata non accettata: TransKey mancante
1160     Lunghezza errata del CustomToken
1161     Numero errato di cifre nel CustomToken
1162     CustomToken con caratteri non validi
1163     CustomToken usato per altra carta
1164     Token scaduto
1165     Token non presente
1200     Codice ABI non corrispondente ad alcuna banca aderente a BankPass
1201     Transazione BankPass abbandonata dal compratore
1202     BankPass - Fallita autenticazione compratore
1203     BankPass - nessuno strumento di pagamento disponibile
1204     BankPass - Errore tecnico
1205     BankPass Server-Server: URL Return non valorizzata
1206     BankPass Server-Server: URL Return troppo lunga (max 250 char)
1207     BankPass Server-Server: URL Return non valida (deve iniziare con http:// o https://)
1208     BankPass Server-Server: Parametro URL Return non presente
1209     BankPass Server-Server: IDBankPass non presente
1210     BankPass Server-Server: IDBankPass non valido
1300     Shipping Address Country Error
1301     Shipping Address1 Empty
1302     Shipping Address City Empty
1303     Shipping Address State Empty
1304     Shipping Address Postal Code Empty
1305     Shipping Address Country Empty
1306     Shipping Address Invalid City State Postal Code
1999     Errore tecnico nel colloquio con i circuiti internazionali
2000     La transazione eccede il numero massimo di operazioni nell¿intervallo di tempo
2001     La transazione eccede il numero Massimo di operazioni effettuate dallo stesso utente nell¿intervallo di tempo
2002     La transazione eccede l¿importo massimo nell¿intervallo di tempo
2003     La transazione eccede l¿importo massimo pagabile dallo stesso utente nell¿intervallo di tempo
2004     La transazione contiene un valore dichiarato come non accettabile
2005     La transazione è stata abbandonata in quanto duplicato di una effettuata precedentemente
2006     Lunghezza linea errata
2007     Campo SHOPTRANSACTIONID non correttamente valorizzato
2008     Campo DIVISA non correttamente valorizzato
2009     Campo IMPORTO non correttamente valorizzato
2010     Campo DATA AUTORIZZAZIONE non correttamente valorizzato
2011     Transazione non esistente
2012     Transazione non univoca
2013     Il file contiene più di una riga relativa alla stessa transazione
2014     Avete richiesto uno storno per un importo eccedente la disponibilità residua della transazione
2015     Campo BANKTRANSACTIONID non correttamente valorizzato
2016     Campi BANKTRANSACTIONID e SHOPTRANSACTIONID non valorizzati
2017     Transazione non cancellabile
2018     Transazione non stornabile
2019     Transazione non movimentabile
2020     Transazione non annullabile
2030     Transazione inviata ai circuiti nonostante la fallita autenticazione 3d/securecode per verifica RED
4001     Valore parametro non previsto
4002     Valore parametro non numerico
4100     Operazione non permessa
4101     Lunghezza errata del numero di carta di credito
4102     Importo non disponibile
4103     Errore tecnico
4104     Errore tecnico
4105     Errore tecnico
4106     Errore tecnico
4108     Errore tecnico nel colloquio con i circuiti internazionali
4109     Errore tecnico
4200     Errore tecnico
4201     Errore tecnico
4202     Errore tecnico
4203     Chiamare Ente
4204     Operazione non permessa
4205     Operazione non permessa
4206     Carta di credito con Check-digit errato. Verificare il numero di carta inserito.
4207     Errore tecnico
4208     Operazione non permessa
4209     Errore tecnico
4300     Errore tecnico
4301     Importo troppo elevato
4302     Errore tecnico
4303     Operazione non permessa
4304     Errore tecnico
4305     Autorizzazione negata dai circuiti
4306     Operazione non permessa
4307     Errore tecnico
4308     Operazione non permessa
4309     Importo troppo elevato
4400     Data transazione errata
4401     Data carta errata
4402     Errore tecnico nel colloquio con i circuiti internazionali
4403     Errore tecnico
4404     Errore tecnico
4405     Operazione non permessa
4406     Operazione non permessa
4407     Importo non disponibile
4408     Operazione non permessa
4409     Operazione non permessa
4500     Errore tecnico
4501     Errore tecnico
4502     Errore tecnico
4503     Operazione non permessa
4504     Operazione non permessa
4505     Operazione non permessa
4506     Errore tecnico
4507     Errore tecnico
4508     Operazione non permessa
4604     Errore tecnico
4701     Operazione non permessa
4702     Data carta errata
4703     Carta non abilitata
4704     Importo non disponibile
4705     Errore tecnico nel colloquio con i circuiti internazionali
4706     Errore tecnico nel colloquio con i circuiti internazionali
4707     Transazione già elaborata
4708     MyBank: fallito il colloquio con la banca del compratore
4709     Ideal: fallito il colloquio con la banca del compratore
4710     Errore elaborazione in PayPal
4720     Rate in Rete: fallito il colloquio con Consel
4730     C-Pay: fallito il colloquio con Compass
4731     Transazione non autorizzata da Compass
7400     Autorizzazione non concessa
7401     Autorizzazione negata dai circuiti
7402     Carta non abilitata
7403     Carta non riconosciuta
7404     Carta scaduta
7405     Chiamare Ente
7406     Data carta errata
7407     Data transazione errata
7408     Errore di sistema
7409     Esercente non riconosciuto
7410     Formato invalido
7411     Importo non disponibile
7412     Non movimentata
7413     Operazione non permessa
7414     Rete non disponibile
7415     Ritirare carta
7416     Tentativi PIN esauriti
7417     Terminale bloccato
7418     Terminale chiuso forzatamente
7419     Transazione non permessa
7420     Transazione non autorizzata
7421     Servizio sospeso il 01/01/2002.
7500     Autorizzazione non concessa
7600     Autorizzazione non concessa
8000     Flusso elaborato correttamente
8001     Record di testa/coda non presente
8002     Cod.esercente non valorizzato
8003     Num.righe incongruente
8004     File con formato errato
8005     Esercente non abilitato alla funzione
8006     Verify By Visa
8007     Funzione non disponibile per carte VISA
8008     Funzione non disponibile
8009     Pagamento interrotto
8010     Num.carta di credito errato per questa operazione
8011     Operazione acquisita correttamente
8012     Autorizzazione non trovata
8013     Movimentazione non trovata
8014     Imp.mov. > Imp.aut
8015     Imp.storno maggiore del saldo
8016     Operazione non movimentata
8017     Flusso in attesa di elaborazione
8018     Flusso elaborato correttamente
8021     Funzione non disponibile per carte MASTERCARD
8022     Funzione non disponibile per carte JCB
8023     Funzione non disponibile per carte MAESTRO
8888     UP Mobile Payment
9991     Browser non supportato
9992     Errore nella crazione dell'iFrame
9997     Fase con errori
9998     Fase correttamente eseguita
9999     Errore di Sistema

Tutto viene Registrato

Ogni singola operazione del modulo Banca Sella viene registrata nei file di log di conseguenza qualsiasi anomalia di malfunzionamento e facilmente risolvibile leggendo tutte le operazioni compiute dal programma attraverso i file di log di magento. Per attivare i file di log di magento bisogna accedere all'area amministrativa di magento e far click nel menù in alto:

Sistema > Configurazione > Sistema > Sviluppa

Abilitare i log impostando il parametro Log su "Si". Prima di richiedere qualsiasi assistenza tecnica suggeriamo di controllare tale file ed in caso di bisogno di ulteriore assistenza inviare il file log al servizio di assistenza di Banca Sella per poter far controllare se i parametri inseriti sono stati inviati correttamente.

Sicurezza

La gestione di un gateway on-site presuppone maggiori responsabilità da parte del negoziante in quanto i dati di pagamento saranno gestiti completamente sul proprio server, inoltre sarà più impegnativo anche dal punto di vista tecnico perché:

  • Dovrete innanzitutto dotare il vostro server di un certificato SSL

  • Dovrete occuparvi e sarete responsabili del trattamento e dell’archiviazione dei dati delle carte di credito

  • Dovrete occuparvi dei problemi di sicurezza o degli aggiornamenti che potrebbero riguardare il software che gestisce i pagamenti

Assistenza Tecnica

La Shine Software offre una consulenza tecnica a pagamento a tutti coloro che trovano difficoltà nell'installazione e nella configurazione.

Aggiornamenti del modulo

Inserite una recensione del modulo nella sceda del prodotto. All'aggiornamento riceverete il 20% di sconto sul nuovo modulo. La recensione deve essere inserita entro la data di scadenza della garanzia (1 anno data fattura) e riportare il link del vostro negozio per essere valida.

Ulteriori Informazioni

La richiesta di assistenza tecnica per qualsiasi errore riscontrato durante la fase di installazione, configurazione, uso del modulo avrà un costo di un'ora di Assistenza Tecnica Magento per il controllo, la correzione e la riconfigurazione del modulo. Per qualsiasi richiesta di assistenza usare il gestore delle segnalazioni.

Licenza

Ogni modulo acquistato è legato ad un solo dominio. Nei negozi multidominio dovete richiedere una multilicenza al nostro staff costo 50 euro + IVA per ogni singolo nuovo dominio. Non è possibile installare lo stesso modulo in più negozi con domini differenti a meno che si possiede la suddetta licenza multidominio. A tal fine si accetta tale condizione al momento dell'acquisto del modulo. Per richieste superiori a 5 licenze il costo delle ulteriori licenze scenderà a 25 euro + IVA. Se il dominio indicato risulta essere errato, cancellato, o modificato dopo l'invio del modulo via email, bisogna richiedere l'estensione della licenza per un nuovo dominio.

Licenza Sviluppatori

Nel caso in cui il negozio magento si trovi temporaneamente presso un dominio di test/sviluppo è possibile richiedere la licenza per sviluppatori gratuitamente all'atto dell'acquisto del modulo per il dominio ufficiale. Bisogna indicare i due distinti domini nella scheda dell'ordine indicando qual'è il dominio di riferimento per il negozio di produzione ed il dominio di test/sviluppo. Verranno inviati due moduli attivati rispettivamente per i due domini indicati. Il modulo per il dominio di test sarà un trial 30gg.

Dichiarazione di limitazione della responsabilità

Il modulo fornito viene fornito "così com'è" e qualsiasi garanzia (esplicita o implicita), qualsiasi condizione o altro termine di qualsiasi tipo, tra cui, senza restrizioni, qualsiasi garanzia di commerciabilità, idoneità ad uno scopo particolare, non-violazione o titolo, sono escluse in questa sede. In nessun caso la Shine Software o i suoi fornitori saranno responsabili di eventuali danni diretti, indiretti, speciali, incidentali or consequenziali fra cui, senza restrizioni, la perdita di profitti o introiti, il costo di merci sostitutive, la perdita o la corruzione dei dati derivanti dall'uso o dall'incapacità di usare questo sito web o qualsiasi sito ad esso collegato, i danni risultanti dall'utilizzo o dall'affidamento su informazioni o materiali pubblicati su questo sito Web, siano essi basati su garanzia, contratto, torto o qualsiasi altra metodologia legale.

posted 05/12/2013 | This article has been read 6538 times

back to the list