In questa guida vi spieghiamo come potete:

  • Registrare e configurare il tuo conto di prova Viveum.
  • Creare transazioni di prova.

1. Test and Production

Viveum offers two platforms that work completely separately:

  • The test environment
  • The production (live) environment

Our test environment allows you to:

  • make test payments
  • change your account configuration
  • fine-tune the integration of our payment system into your website

Using your account and making transactions in the test environment is almost exactly the same as in the production (live) environment, with the difference that in "Test" there are no actual links with financial institutions (= no payments are processed), and you're not billed.

Once you go live (in production), you will start processing real payments. Therefore we strongly advice you to use your test account to create test payments so that you get comfortable with the platform. This way you will also avoid making mistakes, such as linking your website to your test account instead of your production account.

The test and production environment can easily be distinguished:

  • In the various URLs (for the mode, in the back office, etc.):
    • https://viveum.v-psp.com/ncol/test/...
    • https://viveum.v-psp.com/ncol/prod/...
  • In the back office, the environment you've logged on to is indicated on several locations.
  • Also, the word "test" is mentioned in the various emails you receive while using your test account.

Platform releases:

  • Several times per year, Viveum publishes new versions of its platform, which are referred as releases.
  • This new release is first available in our test environment. After a couple of weeks we move the release to the production environment. This way, we allow you to test possible changes on our platform.
  • It also means that when there has been a new release, the test and production versions of our platform differ until the release has been moved to the production environment.
  • Each release is announced several weeks in advance in both the test and in the production environment.

2. Registrazione del vostro nuovo conto

Per aprire un conto di prova gratuito:

  1. Visitare la nostra pagina web.
  2. Fare clic sul pulsante "Test Account > Create Test Account".
  3. Scegliere il prodotto più appropriato e fare clic sul pulsante "New test account" (Nuovo conto di prova).
  4. Completare la maschera (*1) e fare clic sul pulsante "Register" (Registrazione).
  5. Attendere la e-mail di conferma e la e-mail contenente la password (il controllo dei dati inseriti potrebbe richiedere un po’ di tempo).

(*1) con informazioni corrette dato che invieremo la password all'indirizzo e-mail da voi inserito.

Dopo il ricevimento della password per il conto di prova tramite mail sarà possibile accedere al vostro account come segue:

  1. Visitare la nostra pagina web classic.urlbackofficelogintest
  2. Fare clic sul login link (superiore della pagina).
  3. Inserire il PSPID scelto durante la registrazione dell'account.
  4. Inserire la password ricevuta tramite e-mail (*2).
  5. Fare clic su "Invia".

(*2) Al primo accesso vi sarà richiesto di modificare immediatamente la password con i caratteri da voi scelti.

3. Configurazione del vostro conto di prova

Al primo accesso al vostro account visualizzerete nella pagina iniziale un elenco di operazioni da completare. Questi passaggi riguardano l'amministrazione, i metodi di pagamento e i dettagli tecnici del vostro conto di prova.

È possibile iniziare la configurazione facendo clic sul primo link. Completati tutti i passaggi è possibile richiedere l'attivazione del vostro conto di prova.

Se il vostro conto è già stato attivato e desiderate modificare alcuni dettagli, è possibile visualizzare le diverse pagine di configurazione dal vostro menu di back-office. Ciò è molto utile, in particolare la pagina "Informazioni tecniche", se desiderate modificare alcuni dettagli intanto che state testando l'integrazione.

3.1 Configurazione dei dettagli amministrativi

Informazioni sul contatto intestatario account:

Questo passaggio comprende una maschera contenente le informazioni inserite durante la registrazione per un conto di prova. È possibile modificare alcuni dettagli, se necessario.

  • Informazioni per la fatturazione:
    • Nell'ambiente di testing non riceverete nessuna fattura da noi, non è quindi necessario inserire nessuna informazione per la fatturazione nel conto di prova.
    • Se desiderate inserire qualche informazione potete selezionare "Carta di credito" come metodo di pagamento ed inserire il numero di test carta VISA 4111111111111111 con una data di scadenza futura . È possibile inserire uno spazio bianco nel campo Titolo/Servizio se non si ha nessuna informazione da inserire nel campo.
  • Abbonamento:
    È possibile selezionare il tipo di abbonamento preferito. Nell'ambiente di testing l'abbonamento è gratuito. Alcune opzioni non sono disponibili con tutti gli abbonamenti. Se siete incerti sul tipo di abbonamento da scegliere potete contattare il nostro reparto vendite. L'elenco delle tariffe dei nostri abbonamenti standard è disponibile nella nostra pagina web. Quando il vostro conto sarà attivato sarà possibile accedere alle pagine di configurazione attraverso "Configurazione" > "Abbonamento" del menu. Saranno disponibili anche le seguenti pagine di configurazione aggiuntive:
      Catalogo, lingue e URL (solo per e-Commerce): È possibile selezionare le diverse lingue in cui si desidera visualizzare la pagina dei pagamenti. È anche possibile inserire un URL per le condizioni generali. Questo URL è accessibile al cliente con un link dalla nostra pagina di pagamento sicuro.
    • Valute: È possibile scegliere le valute in cui si desidera accettare i pagamenti dei clienti. Le valute aggiunte devono essere accettate dal vostro acquirer e dovrete avere un contratto per queste valute con il vostro acquirer (in ambiente produttivo). È possibile scegliere la valuta principale e aggiungere valute addizionali/cancellare valute.

3.2 Configurazione dei metodi di pagamento

In generale, per selezionare un metodo di pagamento che si desidera utilizzare nel conto, fare clic semplicemente sul pulsante "Aggiungi" vicino al metodo di pagamento nell'elenco dei metodi di pagamento disponibili e completare la richiesta di affiliazione. Il metodo di pagamento sarà attivato e aggiunto all'elenco dei "Metodi di pagamento selezionati".

Quando il vostro conto sarà attivato sarà ancora possibile accedere a queste pagine di configurazione tramite il link "Mezzo di pagamento" del menu.

3.3 Configurazione delle informazioni tecniche

Nella pagina "Informazioni tecniche" vanno inseriti i dati tecnici necessari per aumentare la sicurezza delle transazioni, le attività di conto automatiche, ecc. È possibile fare clic sul link "?" nella pagina delle informazioni tecniche per avere maggiori informazioni sulla configurazione.

Quando il vostro conto sarà attivato sarà ancora possibile accedere a questa pagina di configurazione attraverso il link "Informazioni tecniche" del menu.

3.4 Richiesta di attivazione del conto di prova

Facendo clic sul link della pagina iniziale per richiedere l'attivazione del vostro conto di prova, si visualizza un link per le nostre Condizioni Commerciali Generali.

Alla conferma di accettazione delle nostre Condizioni Commerciali Generali attiveremo automaticamente il vostro conto di prova.

4. Transazioni di prova e loro risultati

4.1 Test URLs

Se si desidera effettuare pagamenti di prova ma non è ancora stata completata l'integrazione all'interno della vostra pagina web (quando si seleziona una modalità operativa che richiede un'integrazione, per esempio e-Commerce), è possibile effettuarli da una pagina di test del nostro server che rappresenta l'ultima pagina del vostro carrello acquisti. I campi (nascosti) che normalmente devono essere inizializzati automaticamente dalla nostra applicazione, sono visualizzati e inizializzati con valori predefiniti.

È possibile modificare questi valori (iniziando a compilare per esempio il vostro PSPID di prova) per simulare differenti casi/pagamenti. La pagina di test del nostro server per questa modalità di lavoro è disponibile alla finestra “Informazioni di test” della nostra pagina "Informazioni tecniche".

Al termine dell'integrazione all'interno della vostra pagina web sarà possibile effettuare il pagamento di prova dalla vostra pagina web utilizzando gli URL di azione disponibili nella Guida di integrazione tecnica per la modalità operativa (e-Commerce, DirectLink, ecc.) che state utilizzando (per es.: https://viveum.v-psp.com/ncol/test/orderstandard.asp per e-Commerce)

4.2 Carte di test

Se state effettuando dei pagamenti di prova all'interno dell'ambiente di testing dovete utilizzare un numero di carta di credito con formato valido.

È possibile utilizzare il numero di test carta VISA 4111111111111111 con qualsiasi data di scadenza futura.

Questa carta deve essere utilizzata esclusivamente in ambiente di testing. Fare riferimento alla finestra “Informazioni di test” della pagina Informazioni Tecniche per un elenco di numeri di test per altri tipi di carte.

4.3 Simulazione di risultati

Dato che le transazioni dell'ambiente di testing non sono inviate agli acquirer/banche il nostro sistema simula dei risultati di transazione in relazione all'importo del pagamento o secondo un numero di carta specifica.

Potete scegliere quale dei due metodi volete utilizzare dentro la finestra “Informazioni di test”, sezione “Simulazione del risultato di transazioni” della pagina Informazioni Tecniche

Risultato basato sul’importo (AMOUNT)
Riuscito: 0 - 9000
AMOUNT x 100: 0 - 900000
Rifiutato: > 9000
AMOUNT x 100: > 900000
Incerto: 9999
AMOUNT x 100: 999900

Risultato basato sul numero di carta
Riuscito: Qualsiasi altro numero di carta
Rifiutato: 4111113333333333
Incerto: 4111116666666666

4.4 Consultazione dei risultati delle transazioni nel back-office

Dopo aver effettuato una transazione è possibile visualizzare i dettagli nel back-office del vostro conto.

  1. Dopo aver effettuato il login fare clic sul link "Visualizza le transazioni" del menu.
  2. Inserire i criteri di selezione. La prima volta abilitare tutte le caselle di controllo e lasciare gli altri campi con i valori di riferimento.
  3. Visualizzare l'elenco dei risultati.

Per avere maggiori informazioni, consultare Usa il vostro Viveum conto e Consultazione delle Transazioni.

5. Trasferimento da test a produzione

I database dell'ambiente di testing sono completamente separati dai database di produzione. Ciò implica che un conto creato e configurato nell'ambiente di testing deve essere trasferito e riconfigurato nell'ambiente di produzione prima che il merchant possa processare pagamenti reali.

Se l'integrazione nell'ambiente di testing è soddisfacente potete trasferire il vostro conto di prova al nostro ambiente produttivo.

  1. Fare clic sul link "Crea conto di produzione" nel menu del vostro conto di prova nell'elenco "configurazione" o fare clic sul link "Trasferite in produzione il vostro conto di prova" della vostra pagina iniziale di back-office.

    Verrà visualizzata una pagina in cui è possibile convertire il conto da 'test' a 'produzione'. È possibile mantenere il PSPID corrente ed utilizzarlo in produzione oppure, in alternativa, scegliere un nuovo PSPID.

  2. Accedere al vostro conto di produzione (cambiare il campo di login da "test" a "produzione" per accedere) con la stessa password del conto di prova. Modificare la password immediatamente dopo aver effettuato il primo login nel conto di produzione.

    Il conto di produzione avrà lo stesso aspetto del conto di prova ad eccezione dello sfondo che sarà completamente bianco e non avrà la filigrana "test" sullo sfondo.

  3. Modificare/compilare i dettagli del conto; alcune informazioni saranno state trasferite automaticamente dal conto di prova, altre informazioni (come per esempio abbonamento, opzioni, numero P. IVA, metodo di addebito, metodi di pagamento, utenti, ...) dovranno essere nuovamente compilate.

  4. Per le carte di credito, compilare i numeri UID (numero di contratto ricevuto dal vostro acquirer) nella pagina "Mezzo di pagamento".

    Il nostro sistema invia automaticamente una mail al vostro acquirer per controllare i dettagli. Riceveremo una conferma dall'acquirer relativo al vostro UID che ci comunica che è tutto a posto. Alcuni altri metodi di pagamento possono essere attivati automaticamente, quando si configura il metodo di pagamento.

  5. Fare clic sul link di "Richiesta di attivazione" nella pagina iniziale del vostro conto per inviare una richiesta di attivazione del vostro conto di produzione (è anche possibile visualizzare l'elenco di tutti i passaggi necessari e il loro stato di completamento).

    Vi invieremo una mail contenente il contratto con tutti i dettagli del conto.

  6. Sottoscrivere il contratto ed inviatecelo per fax, insieme alla vostra delega bancaria ed ai dettagli del vostro conto corrente bancario, se scegliete di pagare le nostre fatture con addebito diretto (ad eccezione di conti NL sussidiari per cui i dettagli dell'addebito diretto sono già menzionati nel contratto).

    Attiveremo il vostro conto di produzione dopo aver ricevuto il contratto firmato e SE almeno un metodo di pagamento risulta attivo/operativo sul vostro conto. Per le carte di credito attiveremo i vostri metodi di pagamento dopo il ricevimento di una conferma per e-mail dai vostri acquirer sui vostri UID.

  7. Passando dal test alla produzione, passare da "test" a "prod" nell'URL a cui inviate le vostre richieste (pagina web, applicazione).

    In caso contrario le vostre transazioni reali saranno processate nell'ambiente di testing. Se il PSPID da voi scelto per il vostro conto di produzione è diverso da quello che avevate nell'ambiente di testing, dovrete cambiare anche il PSPID nei campi che ci inviate.

    Dopo il trasferimento dal test alla produzione il vostro conto di prova resterà attivo e accessibile a scopi di testing.