Détails de la session

Prev Next

Aperçu

Une session est créée chaque fois qu'un client ouvre un checkout, qu'il s'abonne, paie une facture ponctuelle ou enregistre un moyen de paiement. Les détails de la session vous montrent les paramètres avec lesquels la session a été créée, y compris les réglages définis par la configuration de Checkout utilisée, ainsi qu'exactement ce qui s'est passé pendant cette tentative de paiement : quel appareil et quel navigateur le client a utilisés, s'il a été confronté à une vérification 3-D Secure, et où il a finalement atterri. Utilisez cet article pour comprendre ce que vous voyez et comment vous en servir pour le dépannage.


Où trouver les détails de la session

  • Détails du client : pour toutes les sessions de ce compte client (abonnements, factures et mises à jour du moyen de paiement confondus). Ouvrez la fiche du client et accédez à la section Sessions. Utilisez cette option lorsque vous ne savez pas à quel abonnement ou à quelle facture une tentative de paiement appartient.

  • Détails de l'abonnement : pour les sessions récurrentes et les sessions de souscription à un abonnement. Ouvrez un abonnement et accédez à la section Sessions.

  • Détails de la facture : pour les paiements ponctuels (charges). Ouvrez la facture et accédez à la section Sessions.

Remarque

Un abonnement ou une facture peut avoir plusieurs sessions. Chaque fois qu'un client ouvre le checkout, y compris lors de nouvelles tentatives après un échec ou un abandon, une nouvelle session est créée. Sur les pages d'abonnement et de facture, la section « Sessions » n'apparaît qu'à partir du moment où au moins une session existe.


Ce que vous pouvez faire avec les détails de la session

Le client indique que le lien de paiement ne fonctionne pas
Vérifiez d'abord expires dans le résumé de la session — le lien a peut-être simplement expiré.

Le paiement du client a échoué ou il a abandonné le checkout
Parcourez le journal d'activité dans l'ordre pour voir exactement où le processus s'est arrêté. Voici quelques événements clés à repérer :

  • SHOW — confirme l'appareil/le navigateur/le système d'exploitation réellement utilisés par le client, utile s'il décrit un problème d'affichage

  • CARD_VALIDATION — indique si le client a eu des difficultés à saisir les informations de sa carte

  • CHARGE — développez cet élément pour voir le résultat de la transaction, le code d'erreur et le message d'erreur si le paiement lui-même a échoué

La banque du client lui a demandé de vérifier le paiement (3-D Secure)
Recherchez SCA_FRAME (la vérification a été affichée) et SCA_RETURN (le résultat est revenu). Notez que SCA_RETURN n'est pas cliquable dans l'interface — vous devrez utiliser l'icône de copie dans l'en-tête du panneau « Liste des événements » pour récupérer le JSON complet et vérifier le résultat brut à cet endroit.

Le client indique que sa carte n'a pas été enregistrée
Vérifiez l'événement PM_SAVE de la même manière — copiez la liste des événements au format JSON et consultez son champ result, ainsi que errorCode/errorMessage en cas d'échec. Vérifiez également le champ recurring dans le résumé pour confirmer que la session était bien censée enregistrer une carte.

Vous souhaitez reproduire ce que le client a vu
Chaque session dispose d'une icône de lien qui ouvre directement la page de paiement en direct.

Escalade vers le support Frisbii
Il vous suffit de relever l'id de la session (commence par cs_) — c'est tout ce dont le support a besoin pour retrouver exactement la même session de son côté.


Types de session

Le champ type indique ce que le client était invité à faire dans ce checkout :

Type

Signification

CHARGE

Le client a payé une facture ponctuelle.

RECURRING

Le client a enregistré un moyen de paiement sans effectuer de paiement immédiat — par exemple lors de la mise à jour de sa carte enregistrée.

SUBSCRIPTION

Le client a souscrit à un abonnement et a peut-être payé la première facture dans le cadre du même checkout.


Champs du résumé de session

En haut d'une session s'affiche un résumé comportant les champs suivants :

Champ

Description

id

L'identifiant unique de la session (commence par cs_). Communiquez-le au support Frisbii lorsque vous signalez un problème de paiement — cela nous permet de retrouver la tentative exacte.

type

Le type de session. Voir Types de session ci-dessus.

locale

La langue et la région dans lesquelles le checkout a été affiché (par exemple en_GB ou de_DE). Utile pour confirmer qu'un client a vu le checkout dans la bonne langue.

recurring

Indique si la session enregistre un moyen de paiement pour de futurs paiements. Pour une session CHARGE, cela reflète le choix du client (par exemple une case à cocher facultative « enregistrer la carte ») ; pour une session RECURRING ou SUBSCRIPTION, c'est généralement vrai par conception.

customer

Le client auquel appartient cette session. Cliquez pour accéder à sa fiche client.

subscription

Si la session est liée à un abonnement, l'abonnement auquel elle appartient. Cliquez pour y accéder.

charge

Si la session est liée à une facture ponctuelle, la facture à laquelle elle appartient. Cliquez pour y accéder.

created

Date et heure de création de la session.

expires

Date à laquelle le lien de paiement cesse d'être valide. Si un client signale que « le lien ne fonctionne pas », vérifiez ce champ en premier.

currency

La devise utilisée pour la transaction.

url

Le lien de paiement réel présenté au client.

cancel_url

Adresse vers laquelle le client est redirigé s'il annule ou si le paiement échoue.

accept_url

Adresse vers laquelle le client est redirigé après un checkout réussi.

Exemple JSON

{
    "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://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"
}

Journal d'activité de la session

Sous le résumé se trouve un journal horodaté de tout ce qui s'est passé pendant le checkout. Chaque entrée comporte un name (l'action), un type (le résultat - SUCCESS, INFO ou ERROR) et des détails supplémentaires propres à cette action dans data.

Événement

Ce qu'il vous indique

GET

Le client a ouvert le lien de paiement. Affiche son adresse IP et son navigateur. Si le client revisite une session déjà terminée, cela peut aussi afficher un résultat comme PAYMENT_METHOD_ALREADY_ADDED.

SHOW

La page de paiement s'est affichée. Indique le type d'appareil, la taille d'écran, le navigateur et le système d'exploitation — utile pour confirmer ce que le client a réellement vu.

CARD_VALIDATION

Les informations de carte du client ont été validées champ par champ pendant la saisie (par exemple, une indication sur le format de la date d'expiration). Utile pour repérer où le client a rencontré des difficultés avec le formulaire.

TOKEN

Un jeton sécurisé a été délivré à la page de paiement (ou l'opération a échoué — dans ce cas, cliquez pour développer et afficher les détails de l'erreur/du statut).

SCA_FRAME

Le client s'est vu présenter une vérification d'authentification forte du client (3-D Secure) de sa banque.

SCA_TOKEN

Un jeton lié au flux 3-D Secure a été demandé.

SCA_RETURN / SCA_FRAME_RETURN

Le résultat de la vérification 3-D Secure est revenu. Cet événement n'est pas cliquable — l'interface d'administration ne propose pas de vue détaillée extensible pour celui-ci. Pour examiner le résultat brut, utilisez l'icône de copie dans l'en-tête du panneau « Liste des événements » afin de copier l'intégralité du journal des événements au format JSON, puis recherchez cet événement dans le tableau.

CHARGE

La tentative de paiement proprement dite a été traitée. Cliquez pour développer et afficher le résultat, l'état de la transaction, l'erreur de transaction, le code/message d'erreur et le moyen de paiement.

PM_SAVE

Le moyen de paiement a été enregistré sur le compte du client. Comme SCA_RETURN, cet événement n'est pas cliquable — utilisez l'icône de copie de l'en-tête du panneau « Liste des événements » pour récupérer son champ brut result et, en cas d'échec, errorCode/errorMessage.

SUB_SET_PM

Le moyen de paiement de l'abonnement a été défini ou modifié dans le cadre de cette session.

RETURN_URL

Une URL de retour personnalisée a été transmise et enregistrée pour cette session.

REDIRECT_ACCEPT / REDIRECT_CANCEL

Le client a été redirigé vers votre site — vers accept_url en cas de succès ou vers cancel_url en cas d'échec ou d'annulation.

EXTERNAL_PAYMENT_REDIRECT_RESULT / EXTERNAL_PAYMENT_RETURN_RESULT

Le résultat est revenu d'un moyen de paiement basé sur une redirection (par exemple Vipps, MobilePay, Swish).

EXTERNAL_AGE_VERIFICATION_RESULT

Le résultat d'une étape de vérification d'âge est revenu (utilisée par certains moyens de paiement pour les achats soumis à une restriction d'âge).

UNKNOWN_WEBVIEW_LOAD / ANDROID_WEBVIEW_LOAD / IOS_WEBVIEW_LOAD

Le checkout s'est chargé dans la vue Web intégrée d'une application mobile plutôt que dans un navigateur classique.

Remarque

Selon le moyen de paiement choisi par le client, vous verrez beaucoup d'autres événements spécifiques à la méthode — environ 90 au total. Cela inclut les événements de chargement client pour Apple Pay et Google Pay (AP_LOAD/AP_FRAME, GP_LOAD/GP_FRAME), ainsi qu'un événement *_START pour presque tous les moyens de paiement pris en charge — Klarna (Pay Now/Pay Later/Slice It/Direct Debit/Direct Bank Transfer), PayPal, Swish, Resurs, Vipps (standard/Recurring/ePayment), MobilePay (MPS/MPO), ainsi que des dizaines de méthodes de redirection localisées (BLIK, iDEAL, Przelewy24, Giropay, Bancontact, EPS, MB WAY, Multibanco, MyBank, Trustly, TWINT, WeChat Pay, SEPA, et bien d'autres). Elles suivent toutes la même structure name/type/data et se lisent de la même manière.

Exemple JSON

[
    {
        "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"
    }
]