Richte deine Premium-Zahlungsplattform ein
Die in Avantio integrierten Premium-Zahlungsplattformen ermöglichen es dir, Zahlungen für deine Buchungen zu automatisieren und Transaktionen sicher zu verarbeiten.
Das Vorgehen für die Anbindung hängt vom jeweiligen Anbieter ab. In manchen Fällen musst du zunächst ein Konto erstellen und das Onboarding direkt bei der Plattform abschließen. In anderen Fällen ist es notwendig, bestimmte Zugangsdaten oder Verbindungslinks beim Customer Experience Team von Avantio anzufordern.
In diesem Artikel findest du den Integrationsprozess für jeden Anbieter, die benötigten Daten und ungefähre Aktivierungszeiten.
Was lernst du in diesem Artikel?
In diesem Artikel erfährst du, wie du:
Die notwendigen Informationen vorbereitest, bevor du eine Verbindung herstellst.
Das Onboarding beim Zahlungsanbieter abschließt.
Die erforderlichen Links oder Kennungen bei Avantio anforderst.
Die Integrationsdaten korrekt übermittelst.
Die Verbindung mit einer Testbuchung überprüfst.
Die häufigsten Fehler im Prozess erkennst.
Vorteile
Die Anbindung einer Premium-Zahlungsplattform ermöglicht dir:
Zahlungen im Zusammenhang mit Buchungen zu automatisieren.
Den manuellen Aufwand für dein Team zu reduzieren.
Die Konfiguration der Zahlungen zu zentralisieren.
Die Sicherheit durch Systeme wie 3D Secure zu erhöhen.
Die Nachvollziehbarkeit von Transaktionen zu verbessern.
Die Nachverfolgung von Zahlungen, Rückerstattungen und Vorfällen zu erleichtern.
Die Zahlungslösung an das Land anzupassen, in dem dein Unternehmen tätig ist.
Wann solltest du diese Einstellungen vornehmen?
Du solltest diese Einstellungen vornehmen, wenn:
Du die Zahlungsplattform ausgewählt hast, die dein Unternehmen nutzen wird.
Du bestätigt hast, dass der Anbieter in deinem Land tätig ist.
Du Zahlungen für Buchungen über die neue Plattform abwickeln möchtest.
Du ein bisher genutztes Zahlungs-Gateway ersetzen musst.
Du Zahlungen automatisieren möchtest, die du bisher manuell verwaltest.
Der Anbieter das Konto deines Unternehmens freigegeben hat.
Bevor du startest
Vorab solltest du prüfen:
Ob die gewählte Plattform in deinem Land verfügbar ist.
Ob du den Service direkt beim Anbieter gebucht hast.
Ob das Konto auf den richtigen Unternehmensnamen registriert ist.
Ob du die geforderten rechtlichen und bankbezogenen Prüfungen abgeschlossen hast.
Ob du administrativen Zugriff auf das Konto hast.
Ob du alle notwendigen Daten und Zugangsdaten bereit hast.
Ob du weißt, welches Unternehmen, welche Büros oder Unterkünfte die Verbindung nutzen werden.
Ob die für die Einstellungen verantwortliche Person über ausreichende Rechte in Avantio verfügt.
Es ist außerdem ratsam, intern festzulegen, wer für die Überprüfung von Zahlungen, Rückerstattungen, Abstimmungen und eventuellen Vorfällen zuständig ist.
Sende niemals sensible Zugangsdaten über nicht autorisierte Kanäle. Wenn du Daten an Avantio übermitteln musst, nutze dafür ein Ticket an das Customer Experience Team.
Verbinde deine gewählte Premium-Plattform mit Avantio
Comercia Global Payments
Comercia Global Payments
Bevor du startest
Um Comercia Global Payments zu nutzen, musst du zunächst den Vertrags- und Onboarding-Prozess direkt bei Comercia beginnen.
So gehst du vor
Nimm Kontakt mit Comercia Global Payments über deinen Ansprechpartner auf.
Teile mit, dass du Comercia Global Payments mit Avantio nutzen möchtest.
Reiche die angeforderten Unternehmens- und Bankunterlagen ein.
Schließe das Onboarding bei Comercia ab.
Warte, bis Comercia das Konto geprüft und freigegeben hat.
Comercia wird sich mit Avantio in Verbindung setzen, um die für die Integration benötigten Daten bereitzustellen.
Bestätige beim Customer Experience Team von Avantio, dass die Anfrage läuft.
Sobald die Verbindung verfügbar ist, führe eine Testbuchung durch.
Überprüfe, ob die Transaktion korrekt in Avantio und in der Comercia-Oberfläche angezeigt wird.
Aktivierungsdauer
Der Prozess ist in der Regel innerhalb einer Woche abgeschlossen, kann aber je nach erforderlicher Dokumentation und Prüfungen während des Onboardings variieren.
Stripe
Stripe
Bevor du startest
Um Stripe zu verbinden, benötigst du:
Ein Stripe-Konto vom Typ Standard.
Den von Stripe geforderten Verifizierungsprozess abgeschlossen.
Zugriff auf das Konto mit ausreichenden Rechten.
Einen von Avantio bereitgestellten Verbindungslink.
So gehst du vor
Gehe auf die Stripe-Webseite und erstelle ein Standard-Konto.
Trage die geforderten Unternehmens-, Steuer- und Bankdaten ein.
Schließe die Kontoverifizierung ab.
Erstelle ein Ticket für das Customer Experience Team von Avantio.
Gib im Ticket an, dass du dein Stripe-Standardkonto verbinden möchtest.
Warte auf den Verbindungslink.
Öffne den Link und melde dich mit dem entsprechenden Stripe-Konto an.
Autorisiere die Verbindung zwischen Stripe und Avantio.
Bestätige beim Customer Experience Team, dass der Vorgang abgeschlossen ist.
Führe eine Testbuchung durch und prüfe, ob die Zahlung korrekt verarbeitet wird.
Aktivierungsdauer
Die Verbindung kann am selben Tag aktiv sein, sofern das Stripe-Standardkonto verifiziert und einsatzbereit ist.
SysPay
SysPay
Bevor du startest
Um die Verbindung mit SysPay zu starten, musst du deren Onboarding-Prozess abschließen.
Während dieses Prozesses fordert SysPay zwei Kennungen an, die dir Avantio bereitstellen muss:
Account ID.
Merchant ID.
So gehst du vor
Nimm Kontakt mit dem Vertriebsteam von SysPay auf.
Teile mit, dass du die Integration mit Avantio nutzen möchtest.
Reiche die geforderten Unternehmens- und Bankunterlagen bei SysPay ein.
Erstelle ein Ticket für das Customer Experience Team von Avantio.
Fordere deine Account ID und Merchant ID für die Verbindung mit SysPay an.
Übermittle diese beiden Kennungen an SysPay.
Schließe die noch ausstehenden Prüfungen beim Anbieter ab.
Warte, bis SysPay das Zahlungsmodul per API aktiviert hat.
Sobald SysPay bestätigt, dass das Modul bereit ist, informiere das Customer Experience Team von Avantio über das Ticket.
Avantio schließt die Integration ab.
Führe eine Testbuchung durch.
Überprüfe, ob die Transaktion auf beiden Plattformen korrekt verarbeitet und angezeigt wird.
Aktivierungsdauer
Die Aktivierung dauert in der Regel einige Tage, abhängig davon, wie schnell das Onboarding und die API-Freischaltung abgeschlossen sind.
Mercado Pago
Mercado Pago
Bevor du startest
Um Mercado Pago zu verbinden, benötigst du:
Ein aktives Unternehmenskonto.
Zugriff auf den Bereich Integrationen.
Die User ID des Kontos.
Den für Webhooks eingerichteten Secret Key.
Das Access Token für den Produktivbetrieb.
Die von Avantio bereitgestellte Webhook-URL.
So gehst du vor
Melde dich in deinem Unternehmenskonto bei Mercado Pago an.
Gehe zum Bereich Dein Unternehmen.
Wähle Integrationen aus.
Suche das Panel für verbundene Anwendungen.
Gehe zu der Anwendung, die du für die Verbindung mit Avantio nutzen wirst.
Suche das Feld User ID.
Kopiere den Wert und bewahre ihn sicher auf.
Erstelle ein Ticket für das Customer Experience Team von Avantio.
Fordere die URL an, die du für die Webhook-Konfiguration benötigst.
Gehe zurück zu Mercado Pago und öffne den Bereich Webhooks.
Trage die von Avantio bereitgestellte URL ein.
Wähle im Bereich Ereignisse Zahlungen aus.
Suche das Feld Secret Key.
Kopiere den Wert des Webhook-Secret Keys.
Gehe zu Produktiv-Zugangsdaten.
Suche das Feld Access Token.
Kopiere den Wert und bewahre ihn sicher auf.
Stelle sicher, dass du folgende Daten hast:
User ID.
Webhooks Secret Key.
Access Token.
Übermittle diese Daten dem Customer Experience Team von Avantio über das Ticket und den angegebenen sicheren Kanal.
Warte, bis Avantio die Zugangsdaten im Verbindungsassistenten hinterlegt hat.
Sobald die Einrichtung abgeschlossen ist, führe eine Testbuchung durch.
Überprüfe, ob die Zahlung korrekt verarbeitet und registriert wird.
Aktivierungsdauer
Die Aktivierung kann sofort erfolgen, sobald Avantio die korrekten Zugangsdaten erhalten und die Einrichtung abgeschlossen hat.
Nach der Aktivierung sollte eine Testbuchung durchgeführt werden, um zu prüfen, ob die Zahlungen korrekt funktionieren.
Tilopay
Tilopay
Bevor du startest
Um Tilopay zu verbinden, musst du zuerst den Onboarding-Prozess abschließen und die Produktions-Zugangsdaten erhalten.
Die benötigten Daten sind:
Tilopay Key.
Tilopay Password.
Tilopay Proxy Key.
Tilopay User.
Du musst außerdem den Betriebsmodus auswählen, den du verwenden möchtest.
Verfügbare Betriebsmodi
3DS v.2
In diesem Modus muss der Gast jede Zahlung, die mit der Buchung verbunden ist, per 3D Secure autorisieren.
Das ist sinnvoll, wenn du möchtest, dass alle Abbuchungen eine individuelle Authentifizierung durch den Karteninhaber erfordern.
E-Commerce: CIT und MIT
In diesem Modus autorisiert der Gast die erste Zahlung per 3D Secure.
Weitere Zahlungen, die mit der Buchung verbunden sind, können automatisch als vom Händler initiierte Vorgänge verarbeitet werden, sofern die Bedingungen des Anbieters erfüllt sind.
Das ist besonders geeignet für Buchungen mit mehreren Fälligkeiten oder Teilzahlungen.
So gehst du vor
Nimm direkt Kontakt mit Tilopay auf, um den Onboarding-Prozess zu starten.
Gib an, dass du die Integration mit Avantio nutzen möchtest.
Reiche die erforderlichen Unternehmens- und Bankunterlagen ein.
Schließe die von Tilopay geforderten Überprüfungen ab.
Klär mit Tilopay, welcher Betriebsmodus am besten zu deinem Unternehmen passt: 3DS v.2 oder E-Commerce mit CIT und MIT.
Fordere die Produktions-Zugangsdaten an.
Stelle sicher, dass du Tilopay Key, Tilopay Password, Tilopay Proxy Key und Tilopay User hast.
Erstelle ein Ticket für das Customer Experience Team von Avantio.
Übermittle die erforderlichen Zugangsdaten über den vom Team angegebenen sicheren Kanal.
Gib den gewählten Betriebsmodus an.
Warte, bis Avantio die Integration eingerichtet hat.
Führe eine Testbuchung durch.
Überprüfe die erste Abbuchung und, falls zutreffend, die Funktion der weiteren Zahlungen.
Aktivierungsdauer
Die Aktivierung ist in der Regel innerhalb weniger Tage abgeschlossen, abhängig davon, wie schnell das Onboarding und die Zugangsdaten bereitgestellt werden.
Ascent Payment Solutions
Ascent Payment Solutions
Bevor du startest
Um Ascent Payment Solutions zu verbinden, musst du den Onboarding-Prozess abschließen und folgende Zugangsdaten bereithalten:
Client ID.
Site ID.
Key.
Password.
Price ID.
So gehst du vor
Nimm direkt Kontakt mit Ascent Payment Solutions auf.
Gib an, dass du die Integration mit Avantio nutzen möchtest.
Schließe den Vertrags- und Onboarding-Prozess ab.
Reiche die erforderlichen Unternehmens- und Bankunterlagen ein.
Warte, bis Ascent dein Konto genehmigt und die Zugangsdaten erstellt.
Stelle sicher, dass du Client ID, Site ID, Key, Password und Price ID hast.
Erstelle ein Ticket für das Customer Experience Team von Avantio.
Übermittle die Zugangsdaten über den angegebenen sicheren Kanal.
Warte, bis Avantio die Einrichtung abgeschlossen hat.
Führe eine Testbuchung durch.
Überprüfe, ob die Abbuchung sowohl in Avantio als auch im Ascent-Interface korrekt angezeigt wird.
Aktivierungsdauer
Die Verbindung ist in der Regel innerhalb weniger Tage abgeschlossen, abhängig vom Fortschritt des Onboardings bei Ascent.
Zu erwartendes Ergebnis
Nach Abschluss des Prozesses bei deinem Anbieter:
Die Zahlungsplattform ist mit Avantio verbunden.
Du kannst die mit den Buchungen verbundenen Zahlungen abwickeln.
Die Transaktionen werden an die konfigurierte Plattform gesendet.
Du kannst die Vorgänge sowohl in Avantio als ggf. auch im Anbieter-Panel einsehen.
Die Zahlungen nutzen die verfügbaren Sicherheits- und Authentifizierungsmaßnahmen der Plattform.
Die Integration gilt erst dann als abgeschlossen, wenn eine Testbuchung erfolgreich durchgeführt und überprüft wurde.
Empfohlene nächste Schritte
Nach der Aktivierung der Verbindung:
Führe eine Testbuchung mit einem kleinen Betrag durch.
Überprüfe, ob die Zahlung in Avantio korrekt erfasst wird.
Stelle sicher, dass die Transaktion auf der Zahlungsplattform erscheint.
Prüfe den Zahlungsstatus und die verwendete Währung.
Teste die Funktion von 3D Secure.
Überprüfe die weiteren Zahlungen, falls du mit Teilzahlungen arbeitest.
Führe eine Test-Rückerstattung durch, sofern dies vom Anbieter unterstützt wird.
Stelle sicher, dass die richtigen Teammitglieder Zugriff auf das Zahlungs-Panel haben.
Dokumentiere intern das Vorgehen bei Problemen und Rückbuchungen.
Informiere das Team, bevor ihr mit echten Buchungen startet.
Wichtige Daten und Zugangsdaten
Je nach Anbieter benötigst du folgende Angaben:
Stripe: Standard-Konto und Verbindungslink.
Comercia Global Payments: genehmigtes Konto und Daten, die direkt zwischen Comercia und Avantio verwaltet werden.
Tilopay: Tilopay Key, Tilopay Password, Tilopay Proxy Key und Tilopay User.
Ascent Payment Solutions: Client ID, Site ID, Key, Password und Price ID.
SysPay: Account ID und Merchant ID.
Mercado Pago: User ID, Webhooks Secret Key und Access Token.
Behandle diese Zugangsdaten immer als vertrauliche Informationen.
Einschränkungen und Hinweise
Beachte bitte:
Avantio kann die Integration erst abschließen, wenn der Anbieter das Konto genehmigt hat.
Die Aktivierungszeiten sind Richtwerte.
Die angeforderten Unterlagen hängen vom Anbieter und vom Land ab.
Die Zugangsdaten müssen für die Produktionsumgebung gelten, sofern nicht anders angegeben.
Unvollständige, abgelaufene oder falsch kopierte Zugangsdaten können die Verbindung verhindern.
Für die Integration kann die Mitwirkung sowohl des Anbieters als auch von Avantio erforderlich sein.
Einige Vorgänge müssen über das externe Panel der Plattform verwaltet werden.
Die technische Aktivierung garantiert nicht, dass alle Zahlungsmethoden freigeschaltet sind.
Die 3D Secure-Einstellungen können je nach Plattform und Betriebsmodus variieren.
Für weitere Zahlungen kann eine spezielle Konfiguration nötig sein.
Du solltest keine echten Zahlungen abwickeln, bevor du einen Test durchgeführt hast.
Bevor du eine bereits genutzte Plattform wechselst, prüfe die Auswirkungen auf bestehende Buchungen und noch ausstehende Zahlungen.
Best Practices
Nutze ein Unternehmenskonto und kein Privatkonto.
Schließe das Onboarding ab, bevor du die Aktivierung bei Avantio beantragst.
Überprüfe jede Zugangsdaten sorgfältig, bevor du sie weitergibst.
Teile keine Passwörter oder Tokens über nicht autorisierte Kanäle.
Halte den administrativen Kontakt der Plattform aktuell.
Beschränke den Zugriff auf Personen, die tatsächlich Zahlungen verwalten müssen.
Aktiviere die Zwei-Faktor-Authentifizierung im Anbieter-Panel, wenn verfügbar.
Führe immer eine Testbuchung durch.
Überprüfe sowohl die erste als auch die weiteren Zahlungen.
Kontrolliere regelmäßig abgelehnte Transaktionen.
Dokumentiere intern den Ablauf für Rückerstattungen und Rückbuchungen.
Informiere Avantio und den Anbieter, wenn du das Bankkonto, die juristische Person oder Zugangsdaten änderst.
Vermeide es, eine aktive Verbindung während Zeiten mit hohem Volumen an ausstehenden Zahlungen zu ersetzen.
Praxisbeispiel
Ein Unternehmen entscheidet sich, Tilopay zu nutzen, um Buchungen mit mehreren Zahlungen zu verwalten.
Das Unternehmen schließt das Onboarding ab und wählt den Modus E-Commerce mit CIT und MIT, da der Gast die erste Zahlung per 3D Secure autorisieren und die weiteren Abbuchungen automatisch verarbeitet werden sollen.
Nach Erhalt der Produktions-Zugangsdaten übermittelt das Unternehmen Tilopay Key, Tilopay Password, Tilopay Proxy Key und Tilopay User an Avantio.
Avantio schließt die Einrichtung ab und das Unternehmen erstellt eine Testbuchung mit zwei Fälligkeiten. Zuerst wird die Authentifizierung der ersten Zahlung geprüft, anschließend wird kontrolliert, dass die zweite Abbuchung wie vereinbart verarbeitet wird.
Erst nach erfolgreicher Prüfung beider Zahlungen wird die Integration für echte Buchungen genutzt.
Häufige Fehler
Die Verbindung kann nicht aktiviert werden
Stelle sicher, dass das Konto vom Anbieter vollständig freigegeben wurde und alle ausstehenden Überprüfungen abgeschlossen sind.
Die Zugangsdaten sind ungültig
Überprüfe, ob du die vollständigen Werte ohne zusätzliche Leerzeichen, Zeilenumbrüche oder fehlende Zeichen kopiert hast.
Stelle außerdem sicher, dass es sich um Produktionsdaten und nicht um Testdaten handelt.
Die Zahlung erscheint nicht auf der Plattform
Prüfe, ob die Buchung die richtige Plattform verwendet und die Transaktion tatsächlich gesendet wurde.
Überprüfe auch den Zahlungsstatus und mögliche Fehlermeldungen.
3D Secure wird nicht angezeigt
Die Authentifizierung kann vom Kartentyp, Land, Herausgeber und den Einstellungen der Plattform abhängen.
Bestätige beim Anbieter, dass 3D Secure für das Konto aktiviert ist.
Folgezahlungen werden nicht verarbeitet
Stelle sicher, dass die Plattform und der Betriebsmodus Folgezahlungen erlauben.
Bei Tilopay prüfe, ob der E-Commerce-Modus mit CIT und MIT eingerichtet ist, falls erforderlich.
Mercado Pago erhält die Benachrichtigungen nicht
Überprüfe, dass:
Die Webhook-URL korrekt ist.
Das Ereignis Zahlungen ausgewählt ist.
Der geheime Schlüssel gültig ist.
Die Produktionsdaten aktiv sind.
SysPay schließt die Aktivierung nicht ab
Stelle sicher, dass SysPay die korrekte Account ID und Merchant ID erhalten hat.
Sobald SysPay das API-Modul aktiviert hat, informiere Avantio, damit wir die Integration abschließen können.
Wenn etwas nicht funktioniert
Wenn die Integration nicht wie erwartet funktioniert, prüfe diese Punkte, bevor du das Customer Experience Team kontaktierst:
Stelle sicher, dass das Konto freigegeben und aktiv ist.
Überprüfe, ob noch Validierungen beim Anbieter ausstehen.
Kontrolliere, ob die Zugangsdaten korrekt und vollständig sind.
Stelle sicher, dass du Produktionsdaten verwendest.
Überprüfe, ob der Anbieter die Integration oder das API-Modul aktiviert hat.
Kontrolliere, ob die richtige Plattform in den Zahlungseinstellungen hinterlegt ist.
Prüfe den Status der Transaktion in Avantio und im Anbieter-Panel.
Lade die Seite neu und prüfe das Ergebnis erneut.
Führe bei Bedarf eine neue Testbuchung durch.
Wenn das Problem weiterhin besteht, erstelle ein Ticket und gib folgende Informationen an:
Name des Unternehmens.
Verwendete Zahlungsplattform.
Ungefähres Datum und Uhrzeit der Transaktion.
Buchungsnummer.
Betrag und Währung.
Zahlungsstatus.
Vollständige Fehlermeldung.
Screenshots.
Bestätigung, dass das Onboarding abgeschlossen ist.
Bitte keine Passwörter, vollständige Tokens oder andere sensible Zugangsdaten auf Screenshots einreichen.
Häufig gestellte Fragen
Muss ich die Plattform beauftragen, bevor ich sie mit Avantio verbinde?
Muss ich die Plattform beauftragen, bevor ich sie mit Avantio verbinde?
Ja. Du musst das Konto direkt beim Anbieter erstellen oder beauftragen und den entsprechenden Onboarding- und Verifizierungsprozess abschließen.
Avantio übernimmt die technische Anbindung, ersetzt aber nicht den Vertrag zwischen deinem Unternehmen und der Zahlungsplattform.
Wie lange dauert die Aktivierung?
Wie lange dauert die Aktivierung?
Die Dauer hängt vom jeweiligen Anbieter ab:
Stripe kann am selben Tag aktiviert werden, wenn das Standard-Konto bereits vorbereitet ist.
Comercia Global Payments benötigt etwa eine Woche.
Tilopay, Ascent und SysPay benötigen in der Regel mehrere Tage.
Mercado Pago kann sofort nach Erhalt und Einrichtung der korrekten Zugangsdaten aktiviert werden.
Diese Angaben sind Richtwerte und können variieren.
Kann ich die Zugangsdaten per E-Mail senden?
Kann ich die Zugangsdaten per E-Mail senden?
Nutze immer den vom Customer Experience Team angegebenen sicheren Kanal.
Teile keine Passwörter, Tokens oder sensiblen Schlüssel über nicht autorisierte Kanäle.
Ist eine Testbuchung verpflichtend?
Ist eine Testbuchung verpflichtend?
Ja, das ist sehr zu empfehlen.
Mit einer Testbuchung kannst du prüfen, ob die Plattform verbunden ist, die Zahlung korrekt erfasst wird und die Authentifizierung funktioniert, bevor echte Buchungen verarbeitet werden.
Wer richtet die Verbindung ein?
Wer richtet die Verbindung ein?
Das hängt von der Plattform ab.
In manchen Fällen stellt Avantio einen Link bereit oder richtet die Zugangsdaten ein. In anderen Fällen muss der Anbieter vorher ein Modul aktivieren oder direkt mit Avantio kommunizieren.
Kann ich die Zahlungsplattform wechseln?
Kann ich die Zahlungsplattform wechseln?
Ja, aber prüfe vorher ausstehende Zahlungen und bestehende Buchungen.
Deaktiviere die bisherige Plattform erst, wenn klar ist, wie noch nicht abgewickelte Zahlungen bearbeitet werden.
Was muss ich tun, wenn ich eine Zugangsdaten ändere?
Was muss ich tun, wenn ich eine Zugangsdaten ändere?
Wende dich an das Customer Experience Team von Avantio, um die Einstellungen zu aktualisieren.
Geänderte oder widerrufene Zugangsdaten können die Zahlungsabwicklung unterbrechen.
Kann ich mehrere Plattformen gleichzeitig nutzen?
Kann ich mehrere Plattformen gleichzeitig nutzen?
Ob dies möglich ist, hängt von den Einstellungen deines Kontos, der Struktur deines Unternehmens und dem geplanten Einsatz ab.
Wende dich an das Customer Experience Team, damit wir deinen Fall prüfen können.