Sitzungsdetails

Prev Next

Übersicht

Jedes Mal, wenn ein Kunde einen Checkout öffnet, wird eine “Session” (Sitzung) erstellt – egal, ob er ein Abonnement abschließt, eine einmalige Rechnung bezahlt oder eine Zahlungsmethode speichert. Die Sitzungsdetails zeigen dir die Parameter, mit denen die Sitzung erstellt wurde, einschließlich der Einstellungen, die durch die verwendete Checkout-Konfiguration festgelegt wurden, sowie genau das, was während dieses Checkout-Versuchs passiert ist: welches Gerät und welchen Browser der Kunde verwendet hat, ob eine 3-D-Secure-Abfrage ausgelöst wurde und wo er letztendlich gelandet ist. Verwende diesen Artikel, um zu verstehen, was du in den Sitzungsdetails ablesen kannst, und wie du die Informationen zur Fehlerbehebung nutzen kannst.


Wo du die Sitzungsdetails findest

  • Kundendetails: Für alle Sitzungen im gesamten Konto dieses Kunden (Abonnements, Rechnungen und Aktualisierungen der Zahlungsmethode). Öffne den Kunden und gehe zum Bereich Sessions. Nutze diese Navigation, wenn du nicht weißt, zu welchem Abonnement oder welcher Rechnung ein Checkout-Versuch gehört.

  • Abonnementdetails: Für wiederkehrende Sitzungen und Sitzungen bei Abonnement-Kauf. Öffne ein Abonnement und gehe zum Bereich Sessions.

  • Rechnungsdetails: Für einmalige Zahlungen (Charges). Öffne die Rechnung und gehe zum Bereich Sessions.

Hinweis

Ein Abonnement oder eine Rechnung kann mehrere Sitzungen haben. Jedes Mal, wenn ein Kunde den Checkout öffnet, auch bei erneuten Versuchen nach einem fehlgeschlagenen oder abgebrochenen Vorgang, wird eine neue Sitzung erstellt. Auf den Abonnement- und Rechnungsseiten wird der Bereich „Sessions" erst angezeigt, sobald mindestens eine Sitzung existiert.


Was du mit den Sitzungsdetails tun kannst

Der Kunde sagt, der Checkout-Link funktioniert nicht
Prüfe zuerst expires in der Sitzungsübersicht — der Link könnte einfach abgelaufen sein.

Die Zahlung des Kunden ist fehlgeschlagen oder er hat den Checkout abgebrochen
Gehe das Aktivitätsprotokoll der Reihe nach durch, um genau zu sehen, wo der Vorgang gestoppt ist. Ein paar wichtige Ereignisse, auf die du achten solltest:

  • SHOW — bestätigt, welches Gerät/welchen Browser/welches Betriebssystem der Kunde tatsächlich gesehen hat, hilfreich, wenn er ein Anzeigeproblem beschreibt

  • CARD_VALIDATION — zeigt, ob der Kunde Schwierigkeiten bei der Eingabe der Kartendaten hatte

  • CHARGE — aufklappen, um das Transaktionsergebnis, den Fehlercode und die Fehlermeldung zu sehen, falls die Zahlung selbst fehlgeschlagen ist

Die Bank des Kunden hat ihn aufgefordert, die Zahlung zu verifizieren (3-D Secure)
Achte auf SCA_FRAME (die Abfrage wurde angezeigt) und SCA_RETURN (das Ergebnis kam zurück). Beachte, dass SCA_RETURN in der Benutzeroberfläche nicht anklickbar ist — du musst das Kopiersymbol in der Kopfzeile des Bereichs „Ereignisliste" verwenden, um das vollständige JSON abzurufen und das Rohergebnis dort zu prüfen.

Der Kunde sagt, seine Karte wurde nicht gespeichert
Prüfe das Ereignis PM_SAVE auf die gleiche Weise — kopiere die Ereignisliste als JSON und schau dir das Feld result an, sowie errorCode/errorMessage, falls es fehlgeschlagen ist. Prüfe außerdem das Feld recurring in der Übersicht, um zu bestätigen, dass die Sitzung überhaupt zum Speichern einer Karte gedacht war.

Du möchtest nachvollziehen, was der Kunde gesehen hat
Jede Sitzung verfügt über ein Link-Symbol, das die Live-Checkout-Seite direkt öffnet.

Eskalation an den Frisbii-Support
Nimm einfach die Sitzungs-id (beginnt mit cs_) — das ist alles, was der Support benötigt, um genau dieselbe Sitzung auf seiner Seite aufzurufen.


Sitzungstypen

Das Feld type gibt an, was der Kunde in diesem Checkout tun sollte:

Typ

Was er bedeutet

CHARGE

Der Kunde hat eine einmalige Rechnung bezahlt.

RECURRING

Der Kunde hat eine Zahlungsmethode ohne sofortige Zahlung gespeichert — zum Beispiel beim Aktualisieren der hinterlegten Karte.

SUBSCRIPTION

Der Kunde hat ein Abonnement abgeschlossen und möglicherweise im selben Checkout auch die erste Rechnung bezahlt.


Felder der Sitzungsübersicht

Oben in einer Sitzung wird eine Übersicht mit folgenden Feldern angezeigt:

Feld

Beschreibung

id

Die eindeutige Sitzungs-ID (beginnt mit cs_). Teile diese dem Frisbii-Support mit, wenn du ein Checkout-Problem meldest — so können wir den genauen Versuch nachvollziehen.

type

Die Art der Sitzung. Siehe Sitzungstypen weiter oben.

locale

Die Sprache und Region, in der der Checkout angezeigt wurde (zum Beispiel en_GB oder de_DE). Nützlich, um zu bestätigen, dass ein Kunde den Checkout in der richtigen Sprache gesehen hat.

recurring

Ob die Sitzung eine Zahlungsmethode für zukünftige Zahlungen speichert. Bei einer CHARGE-Sitzung spiegelt dies die eigene Wahl des Kunden wider (z. B. ein Opt-in-Kästchen „Karte speichern"); bei einer RECURRING- oder SUBSCRIPTION-Sitzung ist dies in der Regel standardmäßig der Fall.

customer

Der Kunde, zu dem diese Sitzung gehört. Klicke durch, um zu seinem Kundendatensatz zu gelangen.

subscription

Falls die Sitzung mit einem Abonnement verknüpft ist, das entsprechende Abonnement. Klicke durch, um zum Abonnement zu gelangen.

charge

Falls die Sitzung mit einer einmaligen Rechnung verknüpft ist, die entsprechende Rechnung. Klicke durch, um zur Rechnung zu gelangen.

created

Wann die Sitzung erstellt wurde.

expires

Wann der Checkout-Link seine Gültigkeit verliert. Wenn ein Kunde meldet, „der Link funktioniert nicht", prüfe dies zuerst.

currency

Die für die Transaktion verwendete Währung.

url

Der tatsächliche Checkout-Link, der dem Kunden angezeigt wurde.

cancel_url

Wohin der Kunde weitergeleitet wird, wenn er abbricht oder die Zahlung fehlschlägt.

accept_url

Wohin der Kunde nach einem erfolgreichen Checkout weitergeleitet wird.

JSON-Beispiel

{
    "id": "cs_7e806516aad736861b3d0935eb14fa9e",
    "type": "RECURRING",
    "locale": "en_GB",
    "expires": "2026-11-05T09:38:18.688+00:00",
    "recurring": true,
    "customer": "cust-0004",
    "created": "2026-08-05T09:38:18.655+00:00",
    "currency": "EUR",
    "url": "https://staging-checkout.reepay.com/#/cs_7e806516aad736861b3d0935eb14fa9e",
    "cancel_url": "https://customer-portal.frisbii.com/#/dashboard?success=false",
    "accept_url": "https://customer-portal.frisbii.com/#/dashboard?success=true"
}

Sitzungsaktivitätsprotokoll

Unterhalb der Übersicht findest du ein zeitgestempeltes Protokoll aller Vorgänge während des Checkouts. Jeder Eintrag hat einen name (die Aktion), einen type (das Ergebnis - SUCCESS, INFO oder ERROR) sowie weitere, für diese Aktion spezifische Details in data.

Ereignis

Was es dir sagt

GET

Der Kunde hat den Checkout-Link geöffnet. Zeigt seine IP-Adresse und seinen Browser an. Wenn der Kunde eine bereits abgeschlossene Sitzung erneut aufruft, kann dies auch ein Ergebnis wie PAYMENT_METHOD_ALREADY_ADDED anzeigen.

SHOW

Die Checkout-Seite wurde gerendert. Zeigt Gerätetyp, Bildschirmgröße, Browser und Betriebssystem — nützlich, um zu bestätigen, was der Kunde tatsächlich gesehen hat.

CARD_VALIDATION

Die Kartendaten des Kunden wurden feldweise validiert, während er sie eingegeben hat (z. B. ein Hinweis zum Format des Ablaufdatums). Nützlich, um zu erkennen, wo der Kunde Schwierigkeiten mit dem Formular hatte.

TOKEN

Ein sicheres Token wurde an die Checkout-Seite ausgegeben (oder ist fehlgeschlagen — in diesem Fall zum Erweitern klicken, um Fehler-/Statusdetails anzuzeigen).

SCA_FRAME

Dem Kunden wurde eine Strong-Customer-Authentication-Abfrage (3-D Secure) seiner Bank angezeigt.

SCA_TOKEN

Ein mit dem 3-D-Secure-Ablauf verbundenes Token wurde angefordert.

SCA_RETURN / SCA_FRAME_RETURN

Das Ergebnis der 3-D-Secure-Abfrage kam zurück. Dieses Ereignis ist nicht anklickbar — die Admin-Oberfläche bietet dafür keine erweiterbare Detailansicht. Um das Rohergebnis zu prüfen, verwende das Kopiersymbol in der Kopfzeile des Bereichs „Event list", um das gesamte Ereignisprotokoll als JSON zu kopieren, und suche dann dieses Ereignis im Array.

CHARGE

Der eigentliche Zahlungsversuch wurde verarbeitet. Zum Erweitern klicken, um das Ergebnis, den Transaktionsstatus, den Transaktionsfehler, den Fehlercode/die Fehlermeldung sowie die Zahlungsmethode anzuzeigen.

PM_SAVE

Die Zahlungsmethode wurde im Konto des Kunden gespeichert. Wie SCA_RETURN, ist dieses Ereignis nicht anklickbar — verwende das Kopiersymbol in der Kopfzeile des Bereichs „Event list", um das Rohergebnis result und, falls fehlgeschlagen, errorCode/errorMessage abzurufen.

SUB_SET_PM

Die Zahlungsmethode des Abonnements wurde im Rahmen dieser Sitzung festgelegt oder geändert.

RETURN_URL

Eine benutzerdefinierte Rückkehr-URL wurde übergeben und für diese Sitzung erfasst.

REDIRECT_ACCEPT / REDIRECT_CANCEL

Der Kunde wurde zurück auf deine Website weitergeleitet — bei Erfolg zur accept_url, bei Fehlschlag oder Abbruch zur cancel_url.

EXTERNAL_PAYMENT_REDIRECT_RESULT / EXTERNAL_PAYMENT_RETURN_RESULT

Das Ergebnis kam von einer weiterleitungsbasierten Zahlungsmethode zurück (z. B. Vipps, MobilePay, Swish).

EXTERNAL_AGE_VERIFICATION_RESULT

Das Ergebnis eines Altersverifizierungsschritts kam zurück (wird von einigen Zahlungsmethoden für altersbeschränkte Käufe verwendet).

UNKNOWN_WEBVIEW_LOAD / ANDROID_WEBVIEW_LOAD / IOS_WEBVIEW_LOAD

Der Checkout wurde in der eingebetteten WebView einer mobilen App geladen und nicht in einem regulären Browser.

Hinweis

Je nachdem, welche Zahlungsmethode der Kunde gewählt hat, siehst du noch viele weitere methodenspezifische Ereignisse — insgesamt etwa 90. Dazu gehören Client-Ladeereignisse für Apple Pay und Google Pay (AP_LOAD/AP_FRAME, GP_LOAD/GP_FRAME), sowie ein *_START-Ereignis für nahezu jede unterstützte Zahlungsmethode — Klarna (Pay Now/Pay Later/Slice It/Direct Debit/Direct Bank Transfer), PayPal, Swish, Resurs, Vipps (Standard/Recurring/ePayment), MobilePay (MPS/MPO) sowie Dutzende lokalisierter Weiterleitungsmethoden (BLIK, iDEAL, Przelewy24, Giropay, Bancontact, EPS, MB WAY, Multibanco, MyBank, Trustly, TWINT, WeChat Pay, SEPA und weitere). Diese folgen alle derselben name/type/data-Struktur und können auf die gleiche Weise gelesen werden.

JSON-Beispiel

[
    {
        "name": "GET",
        "type": "SUCCESS",
        "data": {
            "ip": "3.124.222.54",
            "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36"
        },
        "session": "cs_7e806516aad736861b3d0935eb14fa9e",
        "timestamp": "2026-08-05T09:38:22.040+00:00"
    },
    {
        "name": "SHOW",
        "type": "SUCCESS",
        "data": {
            "sr": "2560x1392",
            "vp": "2560x1271",
            "de": "UTF-8",
            "sd": 24,
            "ul": "de-de",
            "os": "windows",
            "browser": "chrome",
            "device_type": "desktop",
            "window_type": "webpage",
            "active_module": "/checkout",
            "active_url": "https://checkout.reepay.com/#/cs_7e806516aad736861b3d0935eb14fa9e",
            "parent_url": "https://checkout.reepay.com/#/cs_7e806516aad736861b3d0935eb14fa9e",
            "app_version": "1.503",
            "appId": "rp-webpage-1785922702438"
        },
        "session": "cs_7e806516aad736861b3d0935eb14fa9e",
        "timestamp": "2026-08-05T09:38:22.270+00:00"
    },
    {
        "name": "CARD_VALIDATION",
        "type": "INFO",
        "data": {
            "message": "Enter expiration date in MM/YY format",
            "fieldName": "CARD_DATE",
            "appId": "rp-webpage-1785922702438"
        },
        "session": "cs_7e806516aad736861b3d0935eb14fa9e",
        "timestamp": "2026-08-05T09:38:29.851+00:00"
    },
    {
        "name": "TOKEN",
        "type": "SUCCESS",
        "data": {
            "appId": "rp-webpage-1785922702438"
        },
        "session": "cs_7e806516aad736861b3d0935eb14fa9e",
        "timestamp": "2026-08-05T09:38:36.423+00:00"
    },
    {
        "name": "SCA_FRAME",
        "type": "INFO",
        "data": {
            "acs_url": "https://acs165.sandbox.3dsecure.io/browser/challenge/manual",
            "frameType": "3dsv2-challenge",
            "metadata": {
                "os": "Windows",
                "browser": "Chrome",
                "window_type": "webpage"
            },
            "appId": "rp-webpage-1785922702438"
        },
        "session": "cs_7e806516aad736861b3d0935eb14fa9e",
        "timestamp": "2026-08-05T09:38:57.268+00:00"
    },
    {
        "name": "SCA_RETURN",
        "type": "INFO",
        "data": {
            "id": "ct_b008d12f9b0af65c3fdef7362118172d",
            "recurring": false,
            "action": "challenge",
            "isCheckout": null,
            "appId": "rp-webpage-1785922840131"
        },
        "session": "cs_7e806516aad736861b3d0935eb14fa9e",
        "timestamp": "2026-08-05T09:40:47.287+00:00"
    },
    {
        "name": "PM_SAVE",
        "type": "SUCCESS",
        "data": {
            "result": "SUCCESS",
            "errorMessage": null,
            "errorCode": null,
            "payment_method": "ca_01a846a293db0650140e29515acc59c0"
        },
        "session": "cs_7e806516aad736861b3d0935eb14fa9e",
        "timestamp": "2026-08-05T09:40:49.085+00:00"
    },
    {
        "name": "REDIRECT_ACCEPT",
        "type": "INFO",
        "data": {
            "uri": "https://customer-portal.frisbii.com/#/dashboard?success=true&id=cs_7e806516aad736861b3d0935eb14fa9e&customer=cust-0004&payment_method=ca_01a846a293db0650140e29515acc59c0"
        },
        "session": "cs_7e806516aad736861b3d0935eb14fa9e",
        "timestamp": "2026-08-05T09:40:49.256+00:00"
    }
]