So konfigurieren Sie Weiterleitungen

Überblick

Sie können Weiterleitungen im Kundenportal oder über die API konfigurieren und so Nutzer nach erfolgter Bezahlung auf eine andere Seite weiterleiten. Je nach Zahlungsstatus (erfolgreiche oder abgebrochene Zahlung) können Sie die folgenden Weiterleitungen konfigurieren:

• automatisch – Weiterleitung nach einer festgelegten Verzögerungszeit.
• manuell – Weiterleitung, nachdem ein Nutzer auf eine Weiterleiten-Schaltfläche klickt.

Sie können gleichzeitig eine automatische und eine manuelle Weiterleitung konfigurieren. Ein Nutzer hat immer noch die Möglichkeit, auf die Weiterleiten-Schaltfläche zu klicken, um zur Anwendung zurückzukehren. Andernfalls wird er automatisch weitergeleitet, nachdem die festgelegte Verzögerungszeit verstrichen ist.

• user_id – Benutzer-ID
• foreigninvoice – die im Parameter external_id übermittelte Transaktions-ID
• invoice_id – Transaktions-ID
• status – Transaktionsstatus. Mögliche Werte sind:

URL, zu der der Nutzer weitergeleitet wird (Beispiel): {Return URL}?user_id=[value]&foreignInvoice=[value]&invoice_id=[value]&status=done

Wenn Benutzer das Zahlungsportal schließen, bevor die Zahlung abgeschlossen wurde, werden sie auf die festgelegte Weiterleitungs-URL weitergeleitet, die folgendes Format aufweist: {Return URL}?user_id=[value]&invoice_id=. Wenn das Zahlungsportal mit Pay Station Embed geöffnet wird, wird das Widget geschlossen und der Benutzer kehrt zurück zum Spiel, sobald das Zahlungsportal geschlossen wird.

Automatische Weiterleitungen konfigurieren

Automatische Weiterleitungen lassen sich auf folgende Arten konfigurieren:

Automatische Weiterleitungen im Kundenportal konfigurieren

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Zahlungen > Zahlungsportal > Allgemeine Einstellungen.
2. Wechseln Sie zum Abschnitt Weiterleitungsverwaltung.

3. Geben Sie im Feld Rückgabe-URL eine URL-Adresse oder einen Pfad (Deep-Link) an, zu der bzw. dem der Nutzer nach erfolgter Zahlung weitergeleitet werden soll. Wir empfehlen, einen Deep-Link als Rückgabe-URL anzugeben, um die User Experience zu verbessern, wenn der Nutzer ein Zahlungsportal in einer mobilen Spiele-Anwendung öffnet.
4. I der Drop-Down-Liste wählen Sie Bedingung für automatische Weiterleitung:
   • Kein Status - es erfolgt keine Weiterleitung.
   • Erfolgreiche Zahlung - Weiterleitung bei erfolgreicher Zahlung.
   • Erfolgreiche oder abgebrochene Zahlung - Weiterleitung bei erfolgreicher oder abgebrochener Zahlung.
   • Beliebige Zahlung - Weiterleitung unabhängig vom Zahlungsstatus.
5. Im Feld Verzögerung geben Sie einen Weiterleitungs-Timeout in Sekunden ein. Standardmäßig ist die Weiterleitung auf 0 Sekunden eingestellt.
6. Wenn Sie nur die automatische Weiterleitung konfigurieren wollen, ohne eine Weiterleiten-Schaltfläche hinzuzufügen, wählen Sie in der Drop-Down-Liste unter Bedingung für manuelle Weiterleitung Kein Status - es erfolgt keine Weiterleitung.
7. Klicken Sie auf Änderungen speichern.

Automatische Weiterleitungen über API konfigurieren

Übermitteln Sie die folgenden Daten im API-Aufruf Token erstellen, um Weiterleitungen zu konfigurieren:

Manuelle Weiterleitung konfigurieren

Manuelle Weiterleitungen lassen sich auf folgende Arten konfigurieren:

• im Kundenportal
• über API

Manuelle Weiterleitungen im Kundenportal konfigurieren

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Zahlungen > Zahlungsportal > Allgemeine Einstellungen.
2. Wechseln Sie zum Abschnitt Weiterleitungsverwaltung.

3. Geben Sie im Feld Rückgabe-URL eine URL-Adresse oder einen Pfad (Deep-Link) an, zu der bzw. dem der Nutzer nach erfolgter Zahlung weitergeleitet werden soll. Wir empfehlen, einen Deep-Link als Rückgabe-URL anzugeben, um die User Experience zu verbessern, wenn der Nutzer ein Zahlungsportal in einer mobilen Spiele-Anwendung öffnet.
4. Wenn Sie nur die manuelle Weiterleitung konfigurieren wollen, wählen Sie in der Drop-Down-Liste unter Bedingung für automatische Weiterleitung Kein Status - keine Weiterleitung.
5. Lassen Sie das Feld Verzögerung leer.
6. Wählen Sie in der Drop-down-Liste Bedingungen für manuelle Weiterleitung einen Zahlungsstatus, wenn die Weiterleiten-Schaltfläche angezeigt wird:
   • Kein Status – es erfolgt keine Weiterleitung.
   • Erfolgreiche Zahlung – Weiterleitung bei erfolgreicher Zahlung.
   • Erfolgreiche oder abgebrochene Zahlung – Weiterleitung bei erfolgreicher oder abgebrochener Zahlung.
   • Beliebige Zahlung – Weiterleitung unabhängig vom Zahlungsstatus.
7. Geben Sie im Feld Schaltflächenbeschriftung den Text für die Schaltfläche ein, die einen Nutzer zur Rückgabe-URL weiterleitet.
8. Klicken Sie auf Änderungen speichern.

Manuelle Weiterleitungen über API konfigurieren

Übermitteln Sie die folgenden Daten im API-Aufruf Token erstellen, um Weiterleitungen zu konfigurieren:

Weiterleitungskonfiguration (Beispiel)

Im Kundenportal haben Sie festgelegt, dass Weiterleitungen automatisch nach 3 Sekunden erfolgen. Dieses Verhalten gilt sowohl für die mobile als auch für die Desktop-Version des Zahlungsportals. Die im Kundenportal eingestellten Konfigurationen sehen wie folgt aus:

Soll das Zahlungsportal in der mobilen App Ihres Spiels anderweitig geöffnet werden (z. B. durch Klick auf eine Weiterleiten-Schaltfläche, wozu ein Deep Link als Rückgabe-URL angegeben sein muss), müssen Sie die in dem Token übermittelten Einstellungen aktualisieren:

 1{
 2    "user": {
 3        "country": {
 4            "value": "US"
 5        },
 6        "id": {
 7            "value": "1234abCd"
 8        },
 9        "name": {
10            "value": "John Smith"
11        }
12    },
13    "settings": {
14        "currency": "USD",
15        "project_id": 123456,
16        "language": "en",
17        "return_url": "myapp://payment/successful",
18        "ui": {
19            "desktop": {
20                "header": {
21                    "visible_logo": true
22                }
23            }
24        },
25        "redirect_policy": {
26            "redirect_conditions": "any",
27            "redirect_button_caption": "Back to Store",
28            "manual_redirection_action": "redirect",
29            "status_for_manual_redirection": "any"
30        },
31        "external_id": "1a2b3c"
32    },
33    "custom_parameters": {
34        "timestamp": 1234512345123,
35        "sku": "testSKU",
36        "amount": "10"
37    },
38    "purchase": {
39        "virtual_items": {
40            "items": [
41                {
42                    "sku": "testSKU",
43                    "amount": 1
44                }
45            ]
46        }
47    }
48}