Mit Viva.com Smart Checkout können Sie Online-Zahlungen über eine gehostete Checkout-Seite akzeptieren.
In diesem Leitfaden werden die wichtigsten Schritte zur Integration von Smart Checkout in Ihre Website oder App erläutert – von der Einrichtung Ihres Viva.com-Kontos und Ihrer Zahlungsquelle bis hin zur Weiterleitung von Kunden und der Überprüfung des Zahlungsergebnisses.
1. Wählen Sie Ihre Viva.com-Umgebung
Viva.com bietet zwei Umgebungen. Stellen Sie sicher, dass Sie die Umgebung verwenden, die Ihrem Vorhaben entspricht.
Umgebung | Verwenden Sie sie für | Erste Schritte |
Produktion | Annahme von Live-Zahlungen | |
Demo | Testen Ihrer Integration und Durchführen von Testzahlungen |
Stellen Sie sicher, dass Sie beim Einrichten und Testen Ihrer Integration in der richtigen Umgebung arbeiten.
2. Erstellen Sie eine Zahlungsquelle für Online-Zahlungen
Eine Zahlungsquelle enthält die Einstellungen, die Viva.com für Zahlungen verwendet, die über Ihre Website oder App getätigt werden.
Konfigurieren Sie beim Einrichten Ihrer Zahlungsquelle Ihre Domain und die URLs, zu denen Kunden nach Abschluss des Checkout-Vorgangs zurückgeleitet werden sollen.
Zum Beispiel:
eine Erfolgsseite wie „Vielen Dank für Ihre Bestellung“
eine Fehlerseite wie „Bei Ihrer Zahlung ist ein Fehler aufgetreten“
Um eine Zahlungsquelle für Online-Zahlungen zu erstellen, gehen Sie in Ihrem Viva.com-Dashboard zu Umsätze > Online-Zahlungen.
Speichern Sie nach dem Erstellen der Zahlungsquelle deren 4-stelligen Quellcode. Sie benötigen diesen Code bei der Konfiguration Ihrer Integration.
Beispiel für die Einrichtung einer Zahlungsquelle mit dem Quellcode 1309 |
 |
Ausführliche Anweisungen zur Einrichtung finden Sie unter Quelle für Online-Zahlungen | Viva.com Support.
3. Integrieren Sie Smart Checkout
Die Integration von Smart Checkout umfasst drei Hauptschritte:
Schritt 1: Erstellen Sie einen Zahlungsauftrag
Bevor Sie eine Zahlung von einem Kunden anfordern, erstellen Sie einen Zahlungsauftrag.
Jedem Zahlungsauftrag wird eine eindeutige 16-stellige ID mit der Bezeichnung orderCode zugewiesen.
Erstellen Sie den Zahlungsauftrag auf Ihrem Server mithilfe der Create Payment Order API und übergeben Sie anschließend den orderCode an Ihre Website oder App.
Informationen zu API-Parametern und zur Implementierung finden Sie im Viva.com Developer Portal. Wählen Sie im Menü auf der linken Seite APIs for payments und anschließend Payment API. Wählen Sie unter Payments die Option Create payment order.
Schritt 2: Leiten Sie den Kunden zu Smart Checkout weiter
Nachdem Sie den Zahlungsauftrag erstellt haben, leiten Sie den Kunden zu Smart Checkout weiter. Der Kunde kann anschließend seine Zahlungsdaten eingeben und den Zahlungsvorgang auf der Smart Checkout-Seite abschließen.
Schritt 3: Verarbeiten Sie die Rückleitung des Kunden und überprüfen Sie das Zahlungsergebnis
Nach dem Zahlungsvorgang wird der Kunde zu der für das jeweilige Ergebnis konfigurierten URL weitergeleitet:
Success URL für erfolgreiche Zahlungen
Failure URL für fehlgeschlagene Zahlungen
Sie können diese URLs in Ihrem Viva.com-Dashboard unter Umsätze > Online-Zahlungen > Webseiten / Apps konfigurieren.
Überprüfen Sie das Zahlungsergebnis
Überprüfen Sie den Transaktionsstatus in Ihrem System anhand der von Viva.com zurückgegebenen Zahlungsinformationen. Zu den für die Validierung verwendeten Transaktionsinformationen gehören:
AmounttransactionIdstatusId
Viva.com bietet die folgenden Methoden zur Überprüfung des Zahlungsergebnisses.
Webhooks
Webhooks ermöglichen Ihrem System, Benachrichtigungen über erfolgreiche oder fehlgeschlagene Zahlungen zu empfangen, und unterstützen sowohl synchrone als auch asynchrone Zahlungsmethoden.
Informationen zur Implementierung, zu Ereignisparametern und Beispiel-Payloads finden Sie im Viva.com Developer Portal. Wählen Sie dort im Menü Webhooks For Payments aus.
Retrieve Transaction API
Sie können Transaktionsinformationen auch über die Retrieve Transaction API abrufen. Informationen zu API-Parametern und zur Implementierung finden Sie im Viva.com Developer Portal. Wählen Sie im Menü auf der linken Seite APIs for payments und anschließend Payment API. Wählen Sie unter Transactions die Option Retrieve transaction.
Optionale Smart Checkout-Einstellungen
Sie können je nach den Anforderungen Ihrer Integration zusätzliche Smart Checkout-Einstellungen konfigurieren.
Zeigen Sie Ihr Markenlogo an
Sie können Ihr Markenlogo über die Einstellungen Ihrer Zahlungsquelle zu Smart Checkout hinzufügen. Anweisungen finden Sie im Viva.com Developer Portal. Gehen Sie zu Tutorials, wählen Sie Smart Checkout Configuration und klicken Sie anschließend auf Add your brand logo.
Achten Sie darauf, ein deutliches Logo in einer geeigneten Größe hochzuladen, um eine optimale Darstellung zu gewährleisten.
Zeigen Sie eine Cancel-Schaltfläche an
Sie können in den erweiterten Konfigurationseinstellungen der Zahlungsquelle eine Cancel-Schaltfläche konfigurieren. Dadurch haben Kunden die Möglichkeit, ihre Bestellung zu stornieren.
Die Cancel-Schaltfläche wird für direkte Smart Checkout-Integrationen und Plugins für Shopify und PrestaShop unterstützt.
Sie können auch Webhooks konfigurieren, um Benachrichtigungen über Ereignisse im Zusammenhang mit der Stornierung von Bestellungen zu erhalten. Besuchen Sie das Viva.com Developer Portal, wählen Sie Webhooks For Payments und anschließend Order Updated, um weitere Informationen anzuzeigen.
Zusätzliche Zahlungsoptionen
Smart Checkout unterstützt auch zusätzliche Zahlungskonfigurationen, darunter:
Wiederkehrende Zahlungen: Der Händler veranlasst nach der ersten Zahlung automatisch Abbuchungen gemäß einem vordefinierten Zeitplan.
Vorautorisierungen: Ein Betrag wird reserviert und die Übertragung der Gelder zu einem späteren Zeitpunkt veranlasst.
Technische Informationen zur Implementierung und zu weiteren verfügbaren Smart Checkout-Konfigurationen finden Sie im Viva.com developer portal.
Benötigen Sie noch Hilfe? Unser Team unterstützt Sie gerne. Bitte kontaktieren Sie uns über die Option Chatten Sie mit uns in Ihrem Viva.com-Konto.