Banqup stellt eine Kundenvalidierungsumgebung (CVE, customer validation environment) bereit: eine Sandbox mit eigenen, getrennten Daten. Nutzen Sie sie, um eine API-Integration zu entwickeln und zu testen oder Funktionen in der mobilen App auszuprobieren, ohne die Rechnungen, Zahlungen und Kontakte in Ihrem Live-Arbeitsbereich zu berühren.
Was die Sandbox-Umgebung ist
Getrennte Daten. Nichts, was Sie in der Sandbox anlegen, erscheint in Ihrem Live-Banqup-Arbeitsbereich, und nichts, was Sie dort tun, ändert Ihre Live-Daten.
Dieselben Funktionen. Die Sandbox läuft auf derselben Banqup-Plattform und derselben API wie die Produktion. Was in der Sandbox funktioniert, funktioniert auch in Ihrem Live-Arbeitsbereich.
Drei Zugänge.
Web-App: app.cve.btx.banqup.com
Developer Portal, in dem Entwickler ihre App und API-Zugangsdaten anlegen: dev.cve.btx.banqup.com
Entwicklerdokumentation der Sandbox: docs.cve.btx.banqup.com
Eine API-Integration in der Sandbox testen
Beginnen Sie mit dem Getting-Started-Leitfaden in der Sandbox-Dokumentation. Er erklärt, welchen Authentifizierungsablauf Ihre Integration benötigt.
Ihr Entwickler legt die App und ihre Client-Zugangsdaten im Developer Portal der Sandbox an. Zugangsdaten gelten nur für eine Umgebung: Sandbox-Zugangsdaten funktionieren nicht in der Produktion, und Produktions-Zugangsdaten funktionieren nicht in der Sandbox.
Richten Sie die Integration auf die Sandbox-API aus. Die Basis-URLs finden Sie in den API-Leitfäden.
In der Web-App der Sandbox gewährt der Arbeitsbereich-Administrator der App den Zugriff auf den Arbeitsbereich, genau wie in Berechtigungen für externe Anwendungen verwalten beschrieben.
Führen Sie Ihre Tests durch. Ausgangsrechnungen, Eingangsrechnungen und andere Dokumente, die Sie anlegen, bleiben in der Sandbox.
Wenn die Integration wie erwartet funktioniert, wiederholen Sie die Schritte 2 und 4 in der Produktion, mit der Produktionsdokumentation und dem Developer Portal der Produktion.
Die Sandbox in der mobilen App Banqup One verwenden
Sie brauchen keine separate App für die Sandbox. Die Banqup One-App, die Sie bereits verwenden, kann über ihre Einstellungen in die Sandbox wechseln.
Öffnen Sie die Banqup One-App und melden Sie sich wie gewohnt an.
Tippen Sie auf Ihr Profil und dann auf Einstellungen.
Tippen Sie auf Weitere Einstellungen.
Aktivieren Sie den Schalter Sandbox-Modus aktivieren.
Tippen Sie im Bestätigungsdialog auf Sandbox-Modus aktivieren.
Die App wechselt in die Sandbox und zeigt nur Sandbox-Daten an. Ihre Live-Daten werden nicht verändert und sind wieder verfügbar, sobald Sie zurückwechseln.
Um zu Ihren Live-Daten zurückzukehren, folgen Sie demselben Pfad und tippen Sie auf Sandbox-Modus deaktivieren. Die von Ihnen angelegten Testdaten bleiben für das nächste Mal in der Sandbox.
FAQ
Wirkt sich das, was ich in der Sandbox tue, auf meinen Live-Banqup-Arbeitsbereich aus?
Nein. Die Sandbox hat eigene Daten. Dokumente, Kontakte und Einstellungen, die Sie dort anlegen, erscheinen nie in Ihrem Live-Arbeitsbereich.
Kann ich meine Live-Zugangsdaten in der Sandbox verwenden?
Nein. Apps, Client-Zugangsdaten und Arbeitsbereich-Berechtigungen werden pro Umgebung eingerichtet. Legen Sie sie zum Testen im Developer Portal der Sandbox an und beim Go-live erneut im Developer Portal der Produktion.
Wo finde ich die API-Dokumentation der Sandbox?
Unter docs.cve.btx.banqup.com. Dort finden Sie dieselben Leitfäden, Rezepte und denselben API-Explorer wie in der Produktionsdokumentation.
Ich habe die mobile App in den Sandbox-Modus geschaltet und meine Rechnungen sind weg. Was ist passiert?
Es ist nichts verloren. Die App zeigt die Sandbox an, die leer bleibt, bis Sie Testdaten hinzufügen. Deaktivieren Sie den Sandbox-Modus unter Einstellungen > Weitere Einstellungen, um Ihre Live-Daten wieder zu sehen.