Magento ® extension

1. Disclaimer

Tutti i marchi di fabbrica, marchi di servizi e i nomi commerciali menzionati nel presente materiale sono proprietà dei rispettivi proprietari. Le informazioni qui contenute sono fornite a titolo di cortesia e a solo scopo informativo generale. Il presente documento non intende fornire una descrizione esaustiva di tutte le regole, le politiche e le procedure applicabili. Le tematiche alle quali si fa riferimento possono cambiare nel tempo, così come possono variare le circostanze specifiche.

Viveum declinano qualsiasi responsabilità per informazioni imprecise o incomplete. Le informazioni contenute nel presente comprendono, tra l'altro, una serie di informazioni ricevute da terze parti; tali informazioni sono e resteranno proprietà dei rispettivi titolari. Niente di quanto esposto nella presentazione è volto a integrare, emendare o modificare qualsiasi contratto, regola o regolamento applicabili.

Viveum ha dedicato ampia attenzione al contenuto del presente documento senza, tuttavia, garantirne e dichiararne la precisione o la completezza. Sia Ingenico ePayments, sia le oro affiliate declinano qualsiasi responsabilità per costi, perdite e/o danni generati dall'accesso o dall'uso di qualsiasi contenuto cui il presente documento si riferisce. A causa della complessità del processo e del diritto delle Banche di modificare le condizioni, il presente fornisce esclusivamente una descrizione ed e soggetto a modificazioni future.

L'Estensione di cui al presente, è stata sviluppata come soluzione generica. Viveum declinano qualsiasi responsabilità per eventuali danni causati dall'Estensione. Qualora l'Estensione venga modificata da un utente in qualsiasi modo, Viveum declinano qualsiasi responsabilità per eventuali danni causati dall'Estensione modificata. La descrizione dell'Estensione nel presente è fornita a solo scopo di praticità; Viveum non rilascia nessuna garanzia o dichiarazione in merito all'uso o al funzionamento dell'Estensione. Sia Viveum , le loro affiliate declinano qualsiasi responsabilità per costi, perdite e/o danni generati dall'accesso o dall'uso dell'Estensione.

2. Installazione in Magento ®

2.1 Requisiti

PHP 5.4+
Un account Viveum attivo
Le versioni supportate Magento ® Community e Enterprise Edition possono essere recuperate dalla pagina "Official Viveum Extension".

2.2 Installazione in Magento 1.7 e versioni successive

Scaricare il file tgz.
Fare clic sul pulsante "Install" e copiare la chiave di installazione.
L'installazione procede e dopo un po' nella finestra della console viene visualizzato il messaggio "Package ... installed successfully".

3. Configurazione

3.1 Back office Viveum

Accedere al proprio back office Viveum per inserire le seguenti impostazioni.

3.1.1 Opzioni richieste

A seconda dell'abbonamento Viveum selezionato, potrebbe essere necessario attivare altre opzioni obbligatorie nel proprio account Viveum.

Queste opzioni sono:

OPC
DirectLink (Nuovo pagamento)
DirectLink (Manutenzione)
D3D
Alias Manager (per ulteriori informazioni, andare a Carta di credito con Alias Manager).

Controllare se queste opzioni sono attivate automaticamente. In caso contrario contattare nostro team Assistenza clienti per l'attivazione.

Magento ® Viveum extension classic.brandname-offered-by potrebbe non funzionare in concomitanza con altre estensioni. Per evitare malfunzionamenti si consiglia di disabilitare qualsiasi altra estensione in Magento ®.

3.1.2 Gestione utenti

Il negozio necessita di un API-Utente separato per comunicare con Viveum.

Creare l'API-Utente:

Andare a "Configuration > Users".
Selezionare "New User".
Selezionare uno USERID (ad esempio APIUSER).
Inserire il nome e un indirizzo e-mail esistente (il campo "External USERID" può essere lasciato vuoto).
Selezionare il profilo "Administrator".
Selezionare il tipo di accesso "API only".
Annotare lo USERID e la password creati.

Nota: lo USERID e la password non possono contenere caratteri speciali.

3.1.3 Informazioni tecniche

Configurare le informazioni tecniche nel back office Viveum:

Andare in "Configuration > Technical Information > Global Transactionparameters".
Nella sezione "Default operation code", selezionare "Sale" o "Authorisation".
Nella sezione "Payment retry", modificare il valore, se lo si desidera.
Fare clic sul pulsante "Save".
Selezionare la scheda "Global security parameters".
Nella sezione "Hashing method"; selezionare "SHA-512" per "Hash algorithm" e "UTF-8" per "Character encoding".
Nella sezione "Template", selezionare "No" per "Enable JavaScript check on template".
Fare clic sul pulsante "Save".
Selezionare la scheda "Data and origin verification".
In entrambe le sezioni "Checks for e-Commerce & Alias Gateway" e "Checks for Viveum DirectLink and Viveum Batch (Automatic)", compilare "SHA-IN pass phrase". Entrambe le chiavi devono essere solo alfanumeriche ed entrambe devono avere lo stesso valore.
Selezionare la scheda "Transaction feedback".
Nella sottosezione "HTTP redirection in the browser" della sezione "e-Commerce", selezionare "I would like to receive transaction feedback parameters on the redirection URLs" e deselezionare "I would like Viveum to display a short text to the customer on the secure payment page if a redirection to my website is detected ...".
Nella sottosezione "Direct HTTP server-to-server request" della sezione "e-Commerce" ...
1. Selezionare "Online but switch to a deferred request when the online requests fail"
2. Inserire il valore "YOUR_SHOP_URL/ops/api/postBack" in entrambi i campi per "URL of the merchant's post-payment page".
3. Selezionare "POST" come "Request method".
Nella sottosezione "Dynamic e-Commerce parameters" della sezione "e-Commerce", selezionare tutti i parametri disponibili eccetto "ECOM_BILLTO" e "ECOM_SHIPTO" poiché possono generare facilmente errori di trasmissione.
Nella sezione "All transaction submission modes", compilare "SHA-OUT pass phrase". L'immissione in SHA-OUT pass phrase deve essere identica a quella effettuata
precedentemente per SHA-IN pass phrase.
In "HTTP request for status changes", selezionare "For each offline status change (payment, cancellation, etc.)." e inserire il valore "YOUR_SHOP_URL/ops/api/directLinkPostBack".
Fare clic sul pulsante "Save".
Selezionare la scheda "Transaction e-mails".
Nella sezione "E-mails to the merchant", eseguire le seguenti azioni facoltative ...
1. Inserire il proprio indirizzo e-mail.
2. Selezionare "Yes, for all transaction submission modes."
3. Selezionare "Yes, for each offline status change (payment, cancellation, etc.)."
Selezionare la scheda "Test info".
Nella sezione "Test info", selezionare "I would like to simulate transaction results based on the card number.".

3.2 Magento ®

3.2.1 Servizi di pagamento

Eseguire le seguenti operazioni dopo l'installazione dell'estensione:

Accedere al back office di Magento ®.
Andare in "System > Configuration > Sales > Payment services". Sarà disponibile l'opzione “Viveum Account”.
Selezionare l'opzione e inserire le seguenti informazioni:

Impostazione	Descrizione
PSPID	Compilare il PSPID del proprio account Viveum.
SHA-IN Pass phrase	Inserire la SHA-IN passphrase impostata nel back office Viveum di "Technical information > Data and origin verification".
SHA-OUT Pass phrase	Inserire la SHA-OUT passphrase impostata nel back office Viveum di "Technical information > Transaction feedback".
URL di gateway	Gli URL di gateway sono già configurati correttamente. Tuttavia, quando si passa dall'ambiente di PROVA all'ambiente di PRODUZIONE, occorre sostituire questi URL di TEST con gli URL di PRODUCTION, mostrati nel commento di questi campi di configurazione.
API User / API Password	Inserire i dati API creati nel back office Viveum.
Modello del pagamento	Quando si seleziona il modello di negozio Magento ® - Interal, la pagina di pagamento presenterà lo stesso layout del negozio dell'utente. Quando si seleziona una delle seguente opzioni di Ingenico ePayments, tutti i campi che seguono con riferimento al modello Viveum devono essere compilati obbligatoriamente. -Modello Ingenico ePayments - Dynamic: Il cliente viene reindirizzato alla pagina di pagamento di Ingenico ePayments. L'aspetto della pagina è definito da un file di modello caricato dinamicamente che può essere definito direttamente con il seguente Template Identifier/URL (Identificatore modello/URL). -Modalità Ingenico ePayments - iFrame: Il cliente deve immettere i dati del pagamento in una pagina nel negozio che contenga la pagina di pagamento di Ingenico ePayments in un iFrame. È possibile configurare i parametri di stile direttamente di seguito. -Modalità Ingenico ePayments - Redirect: Il cliente viene reindirizzato a Ingenico ePayments per immettere i suoi dati di pagamento. È possibile configurare i parametri di stile direttamente di seguito. -Modello del negozio Magento ® - Internal: Il cliente viene reindirizzato alla pagina di pagamento di Ingenico ePayments con l'aspetto del negozio. L'URL del modello usato viene visualizzato direttamente sotto.
Modello pagamento	Quando si seleziona Magento ®, la pagina di pagamento presenterà lo stesso layout del negozio dell'utente. Quando si seleziona Viveum, tutti i campi che seguono con riferimento al modello Viveum devono essere compilati obbligatoriamente.
Riferimento all'ordine nel caso di pagamenti reindirizzati (o inline)	Con questa opzione è possibile specificare se l'ID incremento ordine o l'ID quota debba essere trasferito come riferimento del pagamento per gli ordini a Viveum. L'ID ordine è il numero nel formato 100000001, che è riportato nella griglia degli ordini di backend nella colonna "Order #". Nel caso in cui si selezioni "Order ID", questo numero sarà trasferito durante il processo di pagamento a Viveum. Per ragioni di compatibilità, prima dell'ID (incremento) ordine viene aggiunto un segno di cancelletto. Se si seleziona "Quote ID", questo numero sarà trasferito a Viveum. Quote ID è, inoltre, l'unica modalità per tutti i metodi di pagamento in linea quali carta di credito (se attivata), direct debit e Kwixo.
Show Quote ID in the order grid	Se attivata, Quote ID sarà aggiunta come colonna nella griglia degli ordini di backend.
Submit extra parameters	Se attivata, parametri aggiuntivi saranno trasmessi a Viveum per utilizzare la rilevazione delle frodi o la protezione del venditore di Paypal.
Device ID	Attiva il tracking del cliente per fini di rilevazione delle frodi
Rimandare l'identità/il modello dei dati di pagamento	è possibile inviare un'e-mail ai clienti se non sono riusciti a pagare con Ogone (stato 0 o 2). L'e-mail conterrà un collegamento alla pagina di pagamento di Ogone, in cui il cliente può reinserire i suoi dati di pagamento per recuperare l'ordine. Rispedire l'identità dei dati di pagamento: Selezionare il contatto a cui dovrà essere inviata l'e-mail (collegato a Store Email Addresses (Salva indirizzi e-mail)) Rispedisci modello informazioni pagamento: Selezionare un modello di e-mail a propria discrezione
Debug	Quando si seleziona questa opzione, saranno controllate tutte le richieste e le risposte da Viveum. Si raccomanda di attivare questa opzione solo quando si è in modalità di prova e non in modalità di produzione. Il file di debug è salvato sul fileserver in /Var/Logs/ops.log

Nota: in "System > Configuration > General > Web > URL options", si consiglia di disattivare l'opzione "Add store code to URL's" poiché ciò può introdurre un comportamento errato nell'estensione.

3.2.2 Metodi di pagamento

Configurare i metodi di pagamento in "System > Configuration > Payment Methods".

Si noti che occorre attivare solo i metodi di pagamento che sono stati attivati nel proprio back office Viveum tramite "Configuration > Payment methods > Selected payment methods".

È possibile configurare i tipi di pagamento dei paesi applicabili. Ad esempio: se come paese di fatturazione per iDeal è selezionata l'Olanda, questo paese non verrà visualizzato quando i clienti immettono un paese di fatturazione diverso.

Per le attivazioni e altre modifiche contattare nostro Assistenza clienti via office@viveum.at.

3.2.3 Metodi di pagamento con fattura aperta

Abilitare le seguenti impostazioni aggiuntive in "System > Configuration > Customer Configuration > Name and address options":

Display Birthday
Display VAT number (applicabile solo per Open Invoice NL)
Display Gender

Nota: se si utilizza Afterpay come acquirente da parte propria, non è possibile eseguire acquisizioni parziali con Open Invoice NL).

Quando si attiva Open Invoice AT tramite Klarna, sono applicabili i seguenti prerequisiti:

Il Titolo deve essere impostato su “Kauf auf Rechnung - zahlen in 14 Tagen”.
Il logo deve essere caricato e reso disponibile su https://developers.klarna.com/en/at+php/kpm/logos.
La codifica dei dati deve essere impostata su "other" (altro), perché l'integrazione corrente non supporta la codifica UTF-8.
Invoice terms title (titolo delle condizioni della fattura) deve essere impostato su Rechnungsbedingungen.
Invoice terms url (l'URL delle condizioni della fattura) deve essere impostato su https://cdn.klarna.com/1.0/shared/content/legal/terms/123/de_at/invoice?fee=0#
Non è possibile eseguire un'acquisizione parziale o un rimborso parziale con Magento. Queste operazioni possono essere effettuate dal back office di
Viveum.
Durante l'acquisizione/rimborso Magento non invierà fatture ai clienti: la fattura verrà inviata da Klarna. Durante l'acquisizione/rimborso, l'opzione Email Copy of Invoice (invia copia della fattura per e-mail) deve essere deselezionata.

3.2.4 Metodo di pagamento InterSolve

È possibile definire diversi marchi, corrispondenti ai metodi di pagamento dei rispettivi Viveum.

Affinché possano essere utilizzati nel proprio negozio, questi marchi devono essere configurati in anticipo nel back office Viveum. È possibile assegnare un "Titolo" personalizzato per ogni "Marchio" mostrato al cliente nella pagina della fatturazione.

Intersolve

3.2.5 Carta di credito con metodo di pagamento Alias Manager

Alias Manager si riferisce all'Alias Manager Viveum.

Configurazione:

Impostazione	Descrizione
Enabled Alias Manager	Se questa opzione è abilitata, il cliente ha la possibilità di salvare le sue informazioni di pagamento con carta di credito e di riutilizzare le informazioni salvate per i pagamenti futuri. Queste informazioni possono essere salvate solo per le carte che supportano i pagamenti online.
Show Alias Manager information for guests	Se questa opzione è abilitata, un suggerimento informa i clienti circa i vantaggi associati al salvataggio dei dati della carta di credito, poiché è disponibile solo per i clienti che hanno eseguito il login.

Per un corretto utilizzo di questa funzione, è necessario eseguire periodicamente cron.php che si trova nella directory principale di Magento ®. Su un sistema basato su Unix o Linux occorre aggiungere una delle seguenti voci alla scheda cron:

*/5 * * * * /bin/sh /absolute/path/to/magento/cron.sh
0,5,10,15,20,25,30,35,40,45,50,55 * * * * /bin/sh /absolute/path/to/magento/cron.sh

Per ulteriori informazioni sull'utilizzo, consultare Carta di credito con Alias Manager.

3.2.6 Paypal con metodo di pagamento di protezione del venditore

Configurare le seguenti impostazioni:

Impostazione	Descrizione
Configuration > General > State options > State is required for	Selezionare i paesi per i quali lo stato è obbligatorio in base alle esigenze di tutela del venditore Paypal.
Configuration > Payment Services > Viveum account > Submit extra parameters	Impostare su 'Yes' per trasmettere i parametri necessari a Viveum.

3.2.7 Device fingerprinting

Questa funzionalità offre l'estensione per i dispositivi cliente a impronte digitali per Viveum per raccogliere i dati ed eseguirne l'hashing (ad es. risoluzione dello schermo, agente utente, ecc.) in una chiave. In alcuni paesi Europei la legge prevede che il cliente autorizzi la raccolta dei dati.
Le impronte digitali per il dispositivo possono essere attivate/disattivate in base alla transazione. Ciò viene indicato da un apposito parametro per le transazioni di e-Commerce. Per le transazioni DirectLink è necessario raccogliere informazioni seguendo i pixel nel sito.

Integrazione tramite JavaScript Hook

Quest'estensione offre una funzionalità JavaScript che permette di gestire il consenso dei clienti nella fase di pagamento. I clienti possono anche aggiungere il file
(js/netresearch/ops/deviceFingerprinting.js) in altri punti del negozio per accedere alle funzionalità descritte di seguito. Quest'operazione può essere eseguita con il seguente codice:

consentHandler.toggleConsent( consent , callback );

Consent: il valore booleano e lo stato di destinazione del consenso che devono essere salvati nella sessione del cliente.
Callback: funzione opzionale da richiamare con il consenso salvato dopo il suo salvataggio.
Il gestore dei consensi offre inoltre una funzione per il recupero dello stato corrente del consenso tramite

consentHandler.getConsent (callback)

Analogamente all'altra funzione, il richiamo viene chiamato con il risultato della richiesta (lo stato corrente dell'autorizzazione).

Integrazione tramite la chiamata personalizzata al Controller fornito

È possibile esprimere il consenso anche richiamando direttamente un controller nel seguente URL:
http://www.yourshop.tld/ops/device/toggleConsent
Il parametro "consent" è atteso per la richiesta. Verrà estratto un valore booleano che verrà salvato nella sessione del cliente. Una risposta allo stato corrente di autorizzazione come JSON può essere ad esempio:

{"consent":false}

Lo stato corrente di autorizzazione può essere visualizzato qui: http://www.yourshop.tld/ops/device/consent
Le funzioni preconfigurate di JavaScript richiamano gli URL.

4. Utilizzo

4.1 Generali

L'estensione funziona come la maggior parte delle estensioni Magento ®. Se si è scelto di elaborare le carte di credito, queste saranno elaborate attraverso la piattaforma Magento ®. Tuttavia, quando è attivata l'opzione 3D Secure, i titolari di carta saranno reindirizzati alla pagina di pagamento Viveum.

Ciò è applicabile anche per qualsiasi altro metodo di pagamento in cui i dati del titolare del conto devono essere confermati dall'emittente. Quando la transazione viene elaborata, è possibile vedere la transazione nel proprio back office Magento ® tramite "Sales > Orders".

4.1.1 Metodo di pagamento InterSolve

Durante la configurazione in Magento ®, è possibile definire diversi marchi, che possono essere selezionati dal cliente durante il processo di fatturazione. Il marchio selezionato sarà trasmesso a Viveum.

Se si definisce un solo marchio, il cliente non può selezionare un marchio, ma viene visualizzato direttamente e sarà trasmesso subito a Viveum.

4.1.2 Carta di credito con metodo di pagamento Alias Manager

Quando utilizza il metodo di pagamento "carta di credito" con la funzione Alias Manager attivata, un cliente che ha effettuato il login vede i dati della sua carta di credito memorizzati, se li ha salvati in precedenza.

Se il cliente non ha effettuato il login, viene visualizzato un suggerimento che lo informa della possibilità di memorizzare i dati della propria carta di credito affinché possa riutilizzarli.

Se fa clic sul link nel testo del suggerimento, il cliente viene diretto alla fase del "metodo di fatturazione" e l'opzione "register" sarà selezionata.

La selezione delle informazioni di pagamento visualizzate dipende dall'indirizzo di fatturazione e dall'indirizzo di spedizione, al fine di prevenire gli abusi.

Se desidera salvare le proprie informazioni di pagamento, il cliente deve selezionare l'opzione nella schermata di pagamento con carta di credito.

Se sono disponibili i dati della carta di credito salvati, il modulo sullo schermo di pagamento con carta di credito sarà pre-compilato e i campi di immissione saranno in grigio.

Se desidera aggiornare i dati della propria carta di credito salvati, il cliente deve:

Fare clic in uno dei campi di immissione in grigio. Il contenuto di tutti i campi di immissione viene cancellato.
Inserire i nuovi dati della carta di credito.
Selezionare l'opzione "Save payment information". Se non viene selezionata, le nuove informazioni di pagamento saranno utilizzate per il pagamento, ma non saranno memorizzate e le informazioni di pagamento precedenti saranno ancora disponibili per l'uso successivo.

Se si desidera visualizzare e/o cancellare le cliente le sue informazioni di pagamento, si deve:

Nel back office Viveum, andare in "payment information" ed eseguire l'azione specifica.
In Magento ®:
1. Andare in "customers > manage customers".
2. Fare clic sulla riga del cliente.
3. Selezionare "Payment information".
4. Eseguire l'azione specifica.

4.1.3 Metodi di pagamento con addebito diretto

È possibile utilizzare il metodo di pagamento con addebito diretto per Austria, Germania e Olanda, che consente al cliente di utilizzare i dati del proprio account per i pagamenti.

Panoramica delle funzioni:

Origine del metodo di pagamento con addebito diretto	Tedesco	Austriaco	Olandese
Il cliente deve inserire il numero del conto (Kontonummer, rekeningnummer)	X	X	X
Il cliente deve inserire il codice della banca (BLZ)	X	X
Il cliente può inserire l'IBAN	X		X
Il cliente può inserire il BIC	X		X

Nota: se il cliente inserisce sia IBAN che BIC, e i relativi dati del conto, per l'elaborazione del pagamento vengono utilizzati sia IBAN che BIC.

È, inoltre, possibile utilizzare il metodo di pagamento con addebito diretto per le cosiddette operazioni MOTO in Magento ®. Ciò significa che l'utente accetta e inserisce manualmente le transazioni Mail Order/Telephone Order e il comportamento sarà lo stesso a quello descritto sopra.

4.2 Ricevuta di spedizione

La creazione di una ricevuta di spedizione viene effettuata senza una connessione al servizio di pagamento e si comporta, quindi, come Magento ®-Standard.

4.3 Cancellazioni

Se l'autorizzazione ha avuto successo, è disponibile il pulsante "Void" in "order view" di Magento ® (in "Sales > Orders", facendo clic sull'ordine). Per annullare usare questo pulsante "Void" invece del pulsante "Annulla" (per motivi di workflow gateway).

Se l'annullamento viene elaborato con successo da Viveum, in alcune versioni Magento ® può essere necessario fare clic sul pulsante "Cancel" per impostare il corretto stato di annullamento in Magento ®.

Nel caso in cui l'ordine presenti lo stato "Pending Payment" e lo stato di Viveum sia "0" o "empty", è possibile annullare l'ordine utilizzando il pulsante "Cancel":

Non viene inviata una richiesta di gateway a Viveum.
Le scorte vengono aumentate di nuovo.

Controllare in anticipo lo stato del pagamento nel back-office Viveum, altrimenti non si potrà più aggiornare lo stato in Magento ®.

4.4 Fatturazione

A prescindere che si sia scelto "Authorization" come "Payment Action" nella configurazione di Magento ®, occorre comunque creare una fattura per i metodi di pagamento con carta di credito della spesa per attivare il processo di acquisizione da parte di Viveum.

Per creare una fattura:

Andare in "Order view" di Magento ® (in "Sales > Orders" e fare clic sull'ordine).
Fare clic sul pulsante "Invoice".
Scegliere "Capture Online" come importo.
Fare clic sul pulsante "Submit Invoice".

4.5 Promemoria rimborsi - accredito

Per creare un rimborso:

Andare Vendite> Fatture.
Fare clic sulla fattura da rimborsare.
Fare clic sul pulsante "Credit Memo".
Modificare l'importo da rimborsare.
Volendo, selezionare l'opzione "Close Viveum transaction".
Fare clic sul pulsante "Refund" per confermare. Non fare clic sul pulsante "Refund Offline"!
Ripetere questa procedura finché la transazione Viveum si chiude. Ciò significa che sia l'intero importo è già stato rimborsato o è stata selezionata l'opzione "Close the Viveum transaction". Nell'ultimo caso sono disponibili solo i rimborsi offline.

A seconda del metodo di pagamento, il rimborso sarà eseguito immediatamente o dopo un ritardo da parte di Viveum.

Il pulsante "Credit Memo" in "Order view" crea solo un rimborso interno e non attiva alcuna azione di rimborso da parte di Viveum.

Per alcuni metodi di pagamento (ad es., iDEAL), occorre attivare i rimborsi nel proprio account Viveum.

4.6 Ulteriori informazioni

Per ottenere ulteriori informazioni di pagamento sull'ordine:

Andare in "Order view" in "Sales > Orders".
Scegliere "Information".
Selezionare la sezione “Payment Information”. Le informazioni comprendono:
- Tipo di metodo di pagamento (ad es., carta di credito VISA)
- ID pagamento
- Stato pagamento recente
- Valuta
Selezionare la sezione “Comments History”. Questa sezione contiene la cronologia delle modifiche dello stato del pagamento. Queste informazioni possono aiutare l'utente a verificare che l'autorizzazione della carta di credito è cambiata a causa dell'acquisizione di un pagamento.

4.7 Attivazione pagamenti in Magento ®

Nel contesto delle transazioni MOTO (Mail Order/Telephone Order) eTerminal di Viveum, sono disponibili alcuni metodi di pagamento per la creazione di un ordine in Magento ®.

Non è possibile utilizzare metodi di pagamento con reindirizzamento, poiché non sono ammessi. Non è possibile utilizzare nemmeno 3D secure ("Verified by VISA", "MasterCard Secure Code").

Per abilitare i metodi di pagamento con carta di credito e/o addebito diretto per transazioni MOTO eTerminal, occorre impostare l'opzione "Enable for backend" su "YES" in "System > Configuration > Payment methods > Select credit card and/or direct debit payment method".

Subito dopo aver inserito l'ordine, Magento ® invia già alcuni dati al negozio. Quindi, si potrebbe avere l'impressione che sia necessario fare clic due volte sul pulsante "Order submit".

È possibile anche inviare per e-mail un collegamento alla pagina di pagamento in cui completare il pagamento. Per usufruire di questa funzionalità è necessario attivare l'opzione da System -> Configuration -> Payment Methods -> PayPerMail (Sistema -> Configurazione -> Metodi di pagamento -> PayPerMail).

4.7.1 Pagamento con transazione Viveum esistente

Con questo metodo di pagamento, che è disponibile solo in Magento ® e non nel negozio dell'utente, è possibile immettere direttamente il PAY ID di una transazione Viveum esistente.

In tal caso, nessuna richiesta viene attivata per Viveum e si dovranno eseguire manualmente tutti i cambiamenti di stato.

5. Note

5.1 Generali

In Magento ® possono apparire i seguenti stati:

No credits in Viveum back office: Questo significa che è possibile inviare le richieste di carta di credito solo attraverso Magento ®.
3D-Secure (MasterCard, SecureCode and Verified by Visa) must be activated: Questo significa che l'account Viveum dell'utente deve accettare 3D-Secure.

5.2 Multistore

È possibile utilizzare l'estensione in Magento ® Multistores con:

più siti web
più punti vendita
più domini
più account Viveum

Per usare più account Viveum, occorre seguire la procedura indicata in back office Viveum eMagento per ciascun account Viveum, sito web o punto vendita.

La cosa più importante è impostare correttamente gli URL di risposta nel back office Viveum:

Andare in "Configuration > Technical Information > Transaction feedback".
Configurare le seguenti impostazioni:
- Direct HTTP server-to-server request
- HTTP request for status changes.

La corretta configurazione di questi URL è chiarita con i seguenti esempi.

5.2.1 Esempio – codice del negozio in url utilizzando lo stesso account Viveum

Il Multistore consiste di due punti vendita assegnati al medesimo sito web. L'esempio è valido anche nel caso in cui entrambi i punti vendita siano stati assegnati a siti web diversi:

Il punto vendita A opera sotto http://www.my-shop.com/shopa/
Il punto vendita B opera sotto http://www.my-shop.com/shopb/

La configurazione corretta nel back office Viveum è la seguente:

Direct HTTP server-to-server request: http://www.my-shop.com/shopa/ops/api/postBack
HTTP request for status changes: http://www.my-shop.com/shopa/ops/api/directLinkPostBack

Il feedback sarà elaborato correttamente per il punto vendita B, anche se la risposta viene inviata solo all'URL del punto vendita A.

5.2.2 Esempio – domini differenti ed account Viveum differenti

Il Multistore consiste di due punti vendita assegnati a siti web diversi e utilizza due account Viveum differenti:

Il punto vendita A opera sotto http://www.my-shop-a.com/
Il punto vendita B opera sotto http://www.my-shop-b.com/

La configurazione corretta per il punto vendita A nel back office Viveum è la seguente:

Direct HTTP server-to-server request: http://www.my-shop-a.com/ops/api/postBack
HTTP request for status changes: http://www.my-shop-a.com/ops/api/directLinkPostBack

La configurazione corretta per il punto vendita B nel back office Viveum è la seguente:

Direct HTTP server-to-server request: http://www.my-shop-b.com/ops/api/postBack
HTTP request for status changes: http://www.my-shop-b.com/ops/api/directLinkPostBack

5.2.3 Esempio - domini differenti utilizzando lo stesso account Viveum

Il Multistore consiste di due punti vendita assegnati a siti web diversi e utilizza due account Viveum differenti:

Il punto vendita A opera sotto http://www.my-shop-a.com/
Il punto vendita B opera sotto http://www.my-shop-b.com/

La configurazione corretta per entrambi i punti vendita nel back office Viveum è la seguente:

Direct HTTP server-to-server request: http://www.my-shop-a.com/ops/api/postBack
HTTP request for status changes: http://www.my-shop-a.com/ops/api/directLinkPostBack

Inoltre, occorre configurare l'URL di base di Magento ® per il punto vendita B:

Andare in "System > Configuration > General > Web".
Inserire "http://www.my-shop-b.com/" nei campi "Base URL" e "Base Link URL" della sezione "Unsecure". Usare/mantenere il valore predefinito per gli altri campi della sezione "Unsecure".
Inserire "http://www.my-shop-b.com/" nei campi "Base URL" e "Base Link URL" della sezione "Secure". Usare/mantenere il valore predefinito per gli altri campi della sezione "Secure".

5.2.4 Esempio - codice del negozio in url utilizzando account Viveum differenti

Il Multistore consiste di due punti vendita assegnati allo stesso sito web e utilizza due account Viveum differenti. L'esempio è valido anche nel caso in cui entrambi i punti vendita siano stati assegnati a siti web diversi:

Il punto vendita A opera sotto http://www.my-shop-a.com/
Il punto vendita B opera sotto http://www.my-shop-b.com/

La configurazione corretta per il punto vendita A nel back office Viveum è la seguente:

Direct HTTP server-to-server request: http://www.my-shop-a.com/ops/api/postBack
HTTP request for status changes: http://www.my-shop-a.com/ops/api/directLinkPostBack

La configurazione corretta per il punto vendita B nel backend Ogone è la seguente:

Direct HTTP server-to-server request: http://www.my-shop-b.com/ops/api/postBack
HTTP request for status changes: http://www.my-shop-b.com/ops/api/directLinkPostBack

6. Flusso di lavoro pagamento

Payment workflow between the Magento ® Extension and your Payment Service Provider

Disclaimer
Installazione in Magento ®
Configurazione
Utilizzo
Note
Flusso di lavoro pagamento