1. Home
  2. Anfangen
  3. Kontoverwaltung
  4. Erstellen und konfigurieren Sie Ihren Viveum Test Account

Erstellen und konfigurieren Sie Ihren Viveum Test Account

In diesem Handbuch erklären wir Ihnen, wie Sie:

  • Ihre Viveum Test-Account registrieren und konfigurieren können.
  • Neues Testtransaktionen erstellen können.

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. Neues Konto registrieren

Um ein kostenloses Testkonto zu eröffnen

  1. Besuchen Sie unsere Website unter homepage.
  2. Klicken Sie auf die Schaltfläche „Testkonto > Testkonto erstellen“.
  3. Wählen Sie das passende Produkt und klicken Sie auf die Schaltfläche „Neues Testkonto“.
  4. Füllen Sie das Formular aus (*1) und klicken Sie dann auf die Schaltfläche „Registrieren“.
  5. Warten Sie auf die E-Mail-Bestätigung und die E-Mail mit Ihrem Passwort (dies kann etwas dauern, denn wir prüfen Ihre Angaben zuvor).

(*1) bitte mit korrekten Daten, denn wir schicken das Passwort an die dort angegebene Adresse.

Nachdem Sie das Passwort für Ihr Testkonto per E-Mail erhalten haben, können Sie wie folgt auf das Konto zugreifen:

  1. Besuchen Sie unsere Website unter classic.urlbackofficelogintest
  2. Klicken Sie auf die Schaltfläche „Jetzt Anmelden!“ unten auf der Seite.
  3. Klicken Sie den Login-Link (oben auf der Seite).
  4. Geben Sie die bei der Registrierung Ihres Kontos gewählte PSPID ein
  5. Geben Sie das Passwort ein, das Sie per E-Mail erhalten haben (*2).
  6. Klicken Sie auf „Abschicken“.

(*2) Wenn Sie sich zum ersten Mal anmelden werden Sie aufgefordert, dieses Passwort sofort durch ein neues Passwort eigener Wahl zu ersetzen.

3. Testkonto konfigurieren

Nach der ersten Anmeldung bei Ihrem Konto bekommen Sie eine Liste der auf der Homepage zu absolvierenden Schritte angezeigt. Diese Schritte betreffen die Verwaltung, Zahlungsmethode und technische Details Ihres Testkontos.

Durch Anklicken des ersten Links können Sie die Konfiguration starten. Sobald alle Schritte ausgeführt sind, haben Sie die Möglichkeit, die Aktivierung Ihres Testkontos anzufordern.

Wenn Sie einige Angaben ändern möchten, nachdem das Testkonto aktiviert ist, können Sie weiterhin die einzelnen Konfigurationsseiten über Ihr Back-Office-Menü aufrufen. Dies ist vor allem hinsichtlich der Seite „Technische Informationen“ nützlich, denn möglicherweise möchten Sie während des Tests Ihrer Integration manche Daten nachträglich anpassen.

3.1 Administrative Daten konfigurieren

Kontaktinformationen zum Kontoinhaber:

Bei diesem Schritt sehen Sie ein Formular, das Informationen enthält, die Sie während der Registrierung für ein Testkonto eingegeben haben. Bei Bedarf können Sie einige Angaben darin ändern.

Rechnungsinformationen:

Innerhalb der Testumgebung erhalten Sie von uns keinerlei Rechnungen. Darum müssen Sie keine Rechnungsinformationen für Ihr Testkonto eingeben. Wenn Sie jedoch Angaben eintragen wollen, wählen Sie als Zahlungsmethode „Kreditkarte“ und geben die VISA Testkartennummer 4111111111111111 sowie ein in der Zukunft liegendes Ablaufdatum ein.

In das Feld Titel/Abteilung können Sie anstelle einer konkreten Angabe auch eine Leerstelle eintragen.

  • Abonnements: Wählen Sie das gewünschte Abonnement aus. In der Testumgebung ist das Abonnement kostenlos. Einige Optionen sind nicht in allen Abonnements verfügbar. Wenn Sie unsicher sind, welches Abonnement für Sie das geeignete ist, können Sie sich jederzeit an unsere Vertriebsabteilung wenden. Die Liste mit unseren Standard-Abonnementspreisen ist außerdem auf unserer Website verfügbar. Nach erfolgter Aktivierung Ihres Kontos können Sie auf die Konfigurationsseiten zugreifen. Dies geschieht über „Konfiguration“ > „Konto“ in Ihrem Menü. Darüber hinaus werden Sie die folgenden zusätzlichen Konfigurationsseiten vorfinden:
    • Katalog, Sprachen und URL (nur für e-Commerce): Sie haben die Wahl zwischen verschiedenen Sprachen, die Sie nach Wunsch auf der Zahlungsseite anzeigen lassen können. Darüber hinaus besteht die Möglichkeit, eine URL für Ihre Allgemeinen Geschäftsbedingungen einzutragen. Diese URL wird über einen Link auf unserer sicheren Zahlungsseite für den Kunden zugänglich gemacht.
    • Währungen: Sie können die Währungen auswählen, in denen Sie Kundenzahlungen akzeptieren möchten. Die hier ausgewählten Währungen müssen von Ihrem Acquirer ebenfalls akzeptiert werden und Sie müssen für diese Währungen einen Vertrag mit Ihrem Acquirer abgeschlossen haben (diese Bedingungen gelten für die Produktionsumgebung). Hier können Sie Ihre Hauptwährung angeben und weitere Währungen hinzufügen bzw. löschen.

3.2 Zahlungsmethoden konfigurieren

Um eine Zahlungsmethode auszuwählen, die Sie in Ihrem Konto nutzen möchten, klicken Sie einfach in der Liste der verfügbaren Zahlungsmethoden neben der betreffenden Zahlungsmethode die Schaltfläche „Hinzufügen“ an und füllen den Aufnahmeantrag aus. Die Zahlungsmethode wird aktiviert und in die Liste „Ausgewählte Zahlungsmethoden“ aufgenommen.

Nach Aktivierung des Kontos können Sie weiterhin über den Link „Zahlungsmethoden“ in Ihrem Menü auf die Konfigurationsseite zugreifen.

3.3 Technische Daten konfigurieren

Auf der Seite „Technische Informationen“ müssen Sie die notwendigen technischen Daten zur Verbesserung der Transaktionssicherheit, die Automatisierung der Konto-Aufgaben usw. eingeben. Für weitere Informationen zur Konfiguration klicken Sie den Link „?“ auf der Seite Technische Informationen an.

Nach Aktivierung des Kontos können Sie weiterhin über den Link „Technische Informationen“ in Ihrem Menü auf diese Konfigurationsseite zugreifen.

3.4 Aktivierung des Testkontos anfordern

Wenn Sie auf den Link auf der Homepage klicken, um die Aktivierung Ihres Testkontos anzufordern, erscheint ein Link zu unseren Allgemeinen Geschäftsbedingungen.

Nachdem Sie bestätigt haben, dass Sie unseren Allgemeinen Geschäftsbedingungen zustimmen, aktivieren wir automatisch Ihr Testkonto.

4. Testtransaktionen und deren Ergebnisse

4.1 URLs testen

Wenn Sie mit der Durchführung von Testzahlungen beginnen möchten, ohne die Integration in Ihre Website vollständig abgeschlossen zu haben (d. h. wenn Sie einen Betriebsmodus wie beispielsweise e-Commerce wählen, der eine Integration erfordert), können Sie dies von einer Testseite auf unserem Server aus tun, die dann die Rolle der letzten Seite Ihres Warenkorbs übernimmt.

Die (normalerweise verborgenen) Felder, die von Ihrer Applikation automatisch initialisiert werden müssten, sind in diesem Fall sichtbar und enthalten Standardwerte. Sie können diese Werte ändern (beispielsweise durch Eintragen Ihrer eigenen Test-PSPID), um unterschiedliche Geschäftsvorfälle / Zahlungen zu simulieren. Die Testseite auf unserem Server, die zu Ihrem Arbeitsmodus passt, ist im Bereich „Test-Info“ auf Ihrer Seite „Technische Informationen“ zugänglich.

Wenn Sie die Integration in Ihre Website abgeschlossen haben, können Sie von Ihrer Website aus Testzahlungen vornehmen. Dabei verwenden Sie die aktionsabhängigen URLs, die Sie im Technischen Leitfaden für Ihren Betriebsmodus (e-Commerce, DirectLink etc.) finden (z. B. https://viveum.v-psp.com/ncol/test/orderstandard.asp für e-Commerce).

4.2 Testkarten

Wenn Sie innerhalb der Testumgebung Testzahlungen vornehmen möchten, müssen Sie dazu eine Kreditkartennummer mit einem gültigen Format verwenden.

Hierzu können Sie die VISA Testkartennummer 4111111111111111 mit einem beliebigen, in der Zukunft liegenden Ablaufdatum nutzen.

Diese Karte sollte nur innerhalb der Testumgebung verwendet werden. Eine Liste der Testkartennummern für andere Kartenmarken finden Sie im Bereich „Test-Info“ in den technischen Informationen.

4.3 Resultate simulieren

Da die Transaktionen innerhalb der Testumgebung nicht an Akzeptanzpartner (Acquirer) weitergeleitet werden, simuliert unser System Transaktionsergebnisse in Abhängigkeit vom Zahlungsbetrag oder der Kartenummer.

Sie können im Bereich „Test-Info“, Abschnitt „Simulation von Transaktionsergebnissen“ in den technischen Informationen wählen, welche der beiden Methoden Sie benutzen möchten.

Transaktionsergebnis abhängig vom Betrag (AMOUNT)
Erfolgreich: 0 - 9000
AMOUNT x 100: 0 - 900000
Verweigert: > 9000
AMOUNT x 100: > 900000
Unsicher: 9999
AMOUNT x 100: 999900

Transaktionsergebnis abhängig von der Kartenummer
Erfolgreich: Jede andere Kartenummer
Verweigert: 4111113333333333
Unsicher: 4111116666666666

4.4 Transaktionsergebnisse im Back-Office einsehen

Nach Durchführung einer Transaktion können Sie die resultierenden Daten im Back-Office Ihres Kontos einsehen.

  1. Nach der Anmeldung klicken Sie in Ihrem Menü auf den Link „Transaktionsansicht“.
  2. Geben Ihre Auswahlkriterien ein. Aktivieren Sie beim ersten Mal alle Status-Kontrollkästchen und lassen Sie die Standardeinträge der übrigen Felder unverändert.
  3. Betrachten Sie die Ergebnisliste.

Weitere Informationen finden Sie unter Verwenden Sie Ihre Viveum Konto und Transaktionen Ansehen.

5. Übergang von der Testumgebung zur Produktionsumgebung

Die Datenbanken der Testumgebung sind von denen der Produktionsumgebung vollständig getrennt. Daraus ergibt sich, dass ein in der Testumgebung angelegtes und konfiguriertes Konto in die Produktionsumgebung übertragen und dort rekonfiguriert werden muss, ehe ein Händler echte Zahlungen verarbeiten kann.

Wenn die Integration in der Testumgebung zufrieden stellend ist, können Sie Ihr Testkonto in unsere Produktionsumgebung übertragen.

  1. Klicken Sie im Menü Ihres Testkontos in der Liste ‚Konfiguration’ den Link „Produktionskonto erstellen“ an. Alternativ können Sie auch den Link „Transferieren Sie Ihr Testkonto in ein Produktivkonto“ auf Ihrer Back-Office-Homepage anklicken.

    Es erscheint eine Seite, auf der Sie die Umwandlung Ihres Kontos von ‚Test’ (Testumgebung) in ‚Live’ (Produktionsumgebung) veranlassen können. Es besteht die Möglichkeit, die aktuelle PSPID zu behalten und in der Produktionsumgebung weiter zu nutzen oder alternativ eine neue PSPID zu wählen.

  2. Melden Sie sich an bei Ihrem Produktionskonto (hierzu den Eintrag im Anmeldefeld von „Test“ in „Live“ ändern). Verwenden Sie das gleiche Passwort wie für Ihr Testkonto. Bitte ändern Sie Ihr Passwort unmittelbar nach der ersten Anmeldung bei Ihrem Produktionskonto.

    Das Produktionskonto weist dasselbe Look & Feel wie das Testkonto auf mit dem Unterschied, dass der Hintergrund vollständig weiß ist, beim Testkonto sehen Sie im Hintergrund ein Wasserzeichen.

  3. Ändern / eingeben Sie Ihre Kontodaten. Einige dieser Angaben werden automatisch von Ihrem Testkonto übernommen, andere Informationen (wie Abonnement, Optionen, USt-Nummer, Belastungsmethode, Zahlungsmethoden, Benutzer usw.) müssen erneut eingetragen werden.

  4. Für Kreditkarten gilt: eintragen Sie die UID-Nummern (die Vertragsnummern, die Sie von Ihrem Acquirer erhalten haben) auf der Seite Zahlungsmethoden.

    Unser System sendet automatisch eine E-Mail an Ihren Acquirer zur Überprüfung der Angaben. Wir erhalten daraufhin eine Bestätigung des Acquirers bezüglich Ihrer UID, die uns sagt, dass alles in Ordnung ist. Bestimmte andere Zahlungsmethoden können während der Konfiguration der Zahlungsmethode automatisch aktiviert werden.

  5. Klicken Sie den Link „Aktivieren Sie Ihr Konto“ auf der Homepage Ihres Kontos an, um die Anforderung zur Aktivierung Ihres Produktionskontos abzusenden (hier können Sie auch die Liste aller auszuführenden Einzelschritte sehen und ob diese bereits absolviert worden sind).

    Wir senden Ihnen eine E-Mail mit dem Vertrag und allen Kontodaten.

  6. Unterzeichnen Sie diesen Vertrag und senden Sie ihn per Fax an uns zurück. Fügen Sie die Bankeinzugsgenehmigung und die Daten Ihres Bankkontos bei, wenn Sie Ihre Rechnungen per Bankeinzug begleichen möchten (gilt nicht für Konten bei unseren nierderländischen Tochtergesellschaft, da dort die Bankeinzugsdaten bereits im Vertrag vermerkt sind).

    Wir aktivieren Ihr Produktionskonto nach Erhalt des unterzeichneten Vertrags UND wenn mindestens eine Zahlungsmethode für Ihr Konto aktiv / betriebsbereit ist. Für Kreditkarten aktivieren wir Ihre Zahlungsmethoden nach Erhalt einer bestätigenden E-Mail Ihres Acquirers bezüglich Ihrer UIDs.

  7. Beim Umstellen von Test auf Produktion, ersetzen Sie auf Ihrer Seite (Website, Applikation) lediglich in der URL, an die Sie Ihre Anfragen senden, die Zeichenfolge „test“ durch „prod“.

    Wenn Sie dies nicht tun, werden Ihre regulären Transaktionen weiter in der Testumgebung verarbeitet und bleiben ohne Wirkung. Wenn die für das Produktionskonto gewählte PSPID von der in der Testumgebung verwendeten abweicht, müssen Sie außerdem die PSPID in den Feldern ändern, die Sie an uns senden.

    Auch nach der Umstellung von Test- auf Produktion bleibt ihr Testkonto weiterhin aktiv und kann für Testzwecke genutzt werden.