Créer un callback

Remarques préliminaires

Qu'est-ce qu'un callback ?

Les callbacks permettent de transférer en temps réel à d'autres systèmes des informations sur des événements définis dans le système Frisbii Media.

Lors de l'intégration de Frisbii Media, il peut être souhaitable que des systèmes tiers reçoivent des informations sur les événements qui se produisent dans le système Frisbii Media afin que ces systèmes puissent agir en conséquence. A cette fin, des callbacks peuvent être définis pour certains événements dans le Merchant Backend. Ils sont créés et gérés au niveau du client.

Note sur la protection des données :

Lors de l'utilisation de la plupart des types de callbacks, des données personnelles sont transmises. Le système récepteur peut donc être défini comme un processeur de données supplémentaire mandaté du point de vue de la juridiction applicable. Il convient d'en tenir compte lors de l'utilisation de callbacks.  

Nous avons créé une entrée séparée pour les exemples de charges utiles : Payloads - Exemples  

Créer et activer des callbacks

Créer un callback (sans authentification)  

• Dans la barre d'action, cliquez sur +Créer un Callback.

• Saisissez l'URL d'URL du service web propre. 
  Dès que l'URL a été saisie, vous pouvez cliquer sur la case Activépour activer le callback.

• Sélectionnez le type de callback à l'aide du menu déroulant (par ex. "Créer un client").

• Sauvegarder les paramètres.

Après l'enregistrement, le système Frisbii Media génère automatiquement un Secret Callback distinct pour chaque callback, qui peut être consulté en ouvrant le callback dans la vue détaillée.

Créer un callback (avec authentification)

Note: Nous recommandons généralement d'utiliser le mécanisme de sécurité par authentification. 

• Dans la barre d'action, cliquez sur +Créer un Callback.

• Activer la case à cocher Le point de terminaison nécessite une authentification .

• Méthode 1 : Authentification par nom d'utilisateur et mot de passe
  La transmission des données peut être sécurisée en utilisant l'authentification de base par nom d'utilisateur et mot de passe. Dans la plupart des cas, le système récepteur détermine les données à authentifier. Lors de l'utilisation du callback sécurisé, les données d'authentification sont incluses dans chaque demande de Frisbii Media.

• Méthode 2 : Authentification via l'en-tête HTTP
  Les en-têtes HTTP peuvent également être utilisés pour s'authentifier auprès d'un service.
  Pour ce faire, saisissez une ou plusieurs paires clé-valeur.

Après l'enregistrement, le système Frisbii Media génère automatiquement un Secret Callback distinct pour chaque callback, qui peut être consulté en ouvrant le callback dans la vue détaillée.

Gérer les callbacks

Tous les callbacks créés sont répertoriés dans la page d'aperçu.

• Vous pouvez obtenir plus d'informations sur un callback spécifique en cliquant sur Détails.

• Les callbacks peuvent être modifiés en cliquant sur Modifier.
  Cela peut être nécessaire pour désactiver ou activer le callback, ou en cas d'échec des tentatives, pour modifier l'URL du web, ou pour ajuster le type de callback.

• Le journal des callbacks peut être recherché pour l'ID de callback spécifique en cliquant sur Recherche dans le journal.
  Il naviguera dans le journal des callbacks et définira le filtre pour cet identifiant de callback spécifique.

Example Header

Dans l'exemple suivant, les méthodes 1 et 2 du mécanisme de sécurité ont été utilisées. Les paramètres du Merchant Backend sont les suivants :

L'authentification est transférée dans l'en-tête du callback. Les valeurs en gras sont les données d'authentification correspondantes dans le Merchant Backend. En outre, chaque callback est signé par une "plenigo signature". La manière dont la signature peut être vérifiée est expliquée plus en détail dans l'entrée suivante : plenigo signature