Weiterleitungen konfigurieren

Ü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 zu Pay Station > Einstellungen > Regeln zur Weiterleitung.

2. Geben Sie im Feld Rückgabe-URL eine URL-Adresse oder einen Pfad (Deep Link) an, zu der/dem ein Nutzer nach der Bezahlung weitergeleitet wird. Falls die Nutzer das Zahlungsportal in einer mobilen App öffnen, empfehlen wir, einen Deep Link als Rückgabe-URL anzugeben, um die User Experience zu verbessern.
3. Wählen Sie in der Drop-down-Liste Bedingungen für die automatische Weiterleitung eine Option aus:
   • Keine – nicht weiterleiten.
   • Erfolgreiche Zahlung – Weiterleitung bei erfolgreicher Zahlung.
   • Erfolgreiche oder abgebrochene Zahlung – Weiterleitung bei erfolgreicher oder abgebrochener Zahlung.
   • Beliebige Zahlung – Weiterleitung unabhängig vom Zahlungsstatus.
4. Geben sie im Feld Verzögerung einen Timeout-Wert in Sekunden für die Weiterleitung ein. Standardmäßig erfolgt eine Weiterleitung nach 0 Sekunden.
5. Soll die Weiterleitung automatisch erfolgen, ohne dass der Nutzer auf eine Schaltfläche klicken muss, wählen Sie in der Drop-down-Liste die Option Keine – nicht weiterleiten.
6. Klicken Sie auf Speichern.

Automatische Weiterleitungen über API konfigurieren

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

• settings.return_url – URL-Adresse oder Pfad (Deep Link), zu der/dem ein Nutzer nach dem Bezahlen weitergeleitet wird. Falls die Nutzer das Zahlungsportal in einer mobilen App öffnen, empfehlen wir, einen Deep Link als Rückgabe-URL anzugeben, um die User Experience zu verbessern.
• settings.redirect_policy.redirect_conditions – Bedingungen für die Weiterleitung:
  • none – es erfolgt keine Weiterleitung.
  • successful – Weiterleitung bei erfolgreicher Zahlung.
  • successful_or_canceled – Weiterleitung bei erfolgreicher oder abgebrochener Zahlung.
  • any – Weiterleitung unabhängig vom Zahlungsstatus.
• settings.redirect_policy.delay – Timeout in Sekunden, nach dessen Ablauf die Weiterleitung zu der im Parameter settings.return_url übermittelten URL erfolgt. Standardmäßig erfolgt eine Weiterleitung nach 0 Sekunden.

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 zu Pay Station > Einstellungen > Regeln zur Weiterleitung.

1. Geben Sie im Feld Rückgabe-URL eine URL-Adresse oder einen Pfad (Deep Link) an, zu der/dem ein Nutzer nach der Bezahlung weitergeleitet wird. Falls die Nutzer das Zahlungsportal in einer mobilen App öffnen, empfehlen wir, einen Deep Link als Rückgabe-URL anzugeben, um die User Experience zu verbessern.
2. Wenn Sie nur die manuelle Weiterleitung konfigurieren möchten, wählen Sie in der Drop-down-Liste Bedingungen für die automatische Weiterleitung die Option Keine – nicht weiterleiten.
3. Lassen Sie das Feld Verzögerung leer.
4. Wählen Sie in der Drop-down-Liste Bedingungen für die manuelle Weiterleitung einen Zahlungsstatus aus, bei dem die Weiterleiten-Schaltfläche angezeigt wird:
   • Keine – nicht weiterleiten.
   • Erfolgreiche Zahlung – Weiterleitung bei erfolgreicher Zahlung.
   • Erfolgreiche oder abgebrochene Zahlung – Weiterleitung bei erfolgreicher oder abgebrochener Zahlung.
   • Beliebige Zahlung – Weiterleitung unabhängig vom Zahlungsstatus.
5. Geben Sie im Feld Schaltflächenbeschriftung einen Namen für die Schaltfläche ein, die den Nutzer zur Rückgabe-URL weiterleitet.
6. Klicken Sie auf Speichern.

Manuelle Weiterleitungen über API konfigurieren

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

• settings.return_url – URL-Adresse oder Pfad (Deep Link), zu der/dem ein Nutzer nach dem Bezahlen weitergeleitet wird. Falls die Nutzer das Zahlungsportal in einer mobilen App öffnen, empfehlen wir, einen Deep Link als Rückgabe-URL anzugeben, um die User Experience zu verbessern.
• settings.redirect_policy.manual_redirection_action – wie sich das Zahlungsportal verhält, wenn der Nutzer auf die Schließen- oder Zurück-Schaltfläche klickt:
  • redirect (standardmäßig) – Nutzer wird zur Rückgabe-URL weitergeleitet.
  • postmessage – beim Klick auf das Schließen-Symbol wird das Ereignis close-widget gesendet und beim Klick auf die Zurück-Schaltfläche das Ereignis return. In diesem Fall wird der Nutzer nicht zur Rückgabe-URL weitergeleitet. Sie müssen die Verarbeitung der Ereignisse "Zahlungsportal schließen" und "Weiterleiten" konfigurieren. Diese Einstellung ist nur bei Verwendung der API verfügbar.
• settings.redirect_policy.redirect_button_caption – Beschriftung der Schaltfläche, die den Nutzer zur Rückgabe-URL weiterleitet.
• settings.redirect_policy.status_for_manual_redirection – Zahlungsstatus, bei dem die Weiterleiten-Schaltfläche angezeigt wird:
  • none – es erfolgt keine Weiterleitung.
  • successful – Weiterleitung bei erfolgreicher Zahlung.
  • successful_or_canceled – Weiterleitung bei erfolgreicher oder abgebrochener Zahlung.
  • any – Weiterleitung unabhängig vom Zahlungsstatus.

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:

{
    "user": {
        "country": {
            "value": "US"
        },
        "id": {
            "value": "1234abCd"
        },
        "name": {
            "value": "John Smith"
        }
    },
    "settings": {
        "currency": "USD",
        "project_id": 123456,
        "language": "en",
        "return_url": "myapp://payment/successful",
        "ui": {
            "desktop": {
                "header": {
                    "visible_logo": true
                }
            }
        },
        "redirect_policy": {
            "redirect_conditions": "any",
            "redirect_button_caption": "Back to Store",
            "manual_redirection_action": "redirect",
            "status_for_manual_redirection": "any"
        },
        "external_id": "1a2b3c"
    },
    "custom_parameters": {
        "timestamp": 1234512345123,
        "sku": "testSKU",
        "amount": "10"
    },
    "purchase": {
        "virtual_items": {
            "items": [
                {
                    "sku": "testSKU",
                    "amount": 1
                }
            ]
        }
    }
}