Dans cet article, vous trouverez un glossaire des termes, abréviations et acronymes spécifiques à l'API de GoCardless que vous retrouverez dans notre produit/service. N'hésitez pas à nous contacter à l'adresse api@gocardless.com si vous ne trouvez pas un terme ou avez des questions supplémentaires.
A
Jeton d'accès - Identifiant unique permettant à un marchand qui envoie une requête d'accéder à l'API. Un marchand peut générer un jeton d'accès dans le tableau de bord. Lorsqu'une requête est envoyée, nous pouvons ensuite faire correspondre le jeton qu'il fournit à celui que nous avons stocké afin d'authentifier et d'identifier le marchand.
API - Pont entre deux systèmes qui ne fonctionnent pas ensemble normalement - par exemple, des systèmes qui n'utilisent pas le même langage pour communiquer.
Application - Représentation d'une intégration de partenaires.
Frais de l'application - Frais que peuvent facturer les partenaires en plus des frais prélevés par GoCardless pour chaque transaction.
C
Identifiant du client - Utilisé pour authentifier et identifier une application partenaire pendant l'exécution du flux OAuth.
Bibliothèque cliente - Ensemble de code que les développeurs peuvent ajouter à leurs projets de développement. Elle fournit des morceaux de code qui exécutent les tâches de base requises par l'application pour interagir avec l'API, ce qui représente un gain de temps et d'effort pour un développeur.
Code secret du client - Sert à authentifier et identifier une application partenaire pendant l'exécution du flux OAuth.
Page de paiement personnalisée - Page de paiement hébergée par son intégrateur. Les intégrateurs qui ont recours aux pages de paiement personnalisées n'utilisent généralement pas le flux de redirection.
E
Point de terminaison - Un point de terminaison est simplement un des bouts d'un canal de communication avec l'API. Par exemple, pour envoyer une requête concernant des abonnements, vous devez utiliser le point de terminaison /abonnements.
H
En-tête HTTP - Les en-têtes HTTP sont le nom ou la combinaison de valeurs qui apparaît dans les en-têtes des messages de requête et de réponse pour le protocole Hypertex Transfer Protocol. Lorsque vous envoyez une requête HTTP à l'API, les en-têtes Authorization, GoCardless-Version, Accept et Content-Type sont requis.
I
Clé idempotency - En-tête qui peut être ajouté à une requête envoyée à l'API pour éviter l'envoi répété d'une même requête. Une requête pour créer une ressource avec une clé qui a été utilisée auparavant n'aboutira pas et génèrera une erreur 409
idempotent_creation_conflict.
Intégration - Système qui utilise l'API pour créer et gérer des ressources. Par exemple, un site web, un logiciel de gestion de la relation client, un logiciel de comptabilité, un système de gestion de contenu, etc.
J
Flux Javascript - Utilisé par les marchands avec les pages de paiement personnalisées pour stocker de manière sécurisée les coordonnées bancaires des clients sur notre serveur.
JSON - Format léger et lisible pour l'échange de données. Ce format est utilisé pour envoyer et récupérer la majorité des informations par le biais de l'API.
M
Métadonnées - Ensemble de données qui décrit et fournit des informations sur d'autres données. Elles peuvent être utilisées pour ajouter des données personnalisées sur un client, un paiement ou un abonnement et pour effectuer d'autres actions comme une nouvelle tentative de paiement.
O
OAuth - OAuth permet à un partenaire de travailler avec d'autres comptes d'utilisateurs GoCardless. Une fois qu'un utilisateur donne son approbation, vous pouvez utiliser l'API de GoCardless en son nom et recevoir ses webhooks.
P
Liste paginée - Chaque fois que vous envoyez une requête pour obtenir une liste de ressources de l'API, le nombre de ressources renvoyées est limité. Si le nombre de résultats dépasse la limite, l'API renvoie une liste paginée vous permettant d'envoyer des requêtes supplémentaires pour récupérer tous les résultats.
URL de post-intégration - Lors de l'exécution du flux OAuth, vous pouvez vérifier si les informations d'un marchand ont déjà été vérifiées. Si ce n'est pas encore le cas, vous pouvez lui envoyer le flux de post-intégration pour vérifier son compte. Une fois que le flux de post-intégration est terminé, il est redirigé vers l'URL du flux de post-intégration qui peut être configuré sur votre application.
Jeton d'accès publiable - Lors de l'exécution du flux Javascript, le jeton d'accès publiable est intégré dans un formulaire de paiement. Lorsque le formulaire est soumis, le jeton d'accès publiable est ensuite utilisé pour obtenir un jeton d'accès au compte bancaire du client et récupérer l'identifiant tout juste créé du compte bancaire hébergé sur nos serveurs.
R
Flux de redirection - Les flux de redirectionvous permettent d'utiliser les pages de paiement hébergées de GoCardless pour mettre en place des mandats avec vos clients.
URL de redirection - URL vers laquelle un client est renvoyé une fois qu'il a saisi ses informations de paiement via le flux de redirection.
Identifiant de la requête - Chaque requête envoyée à notre API peut être identifiée de manière unique par son identifiant.
Point de terminaison restreint - Point de terminaison auquel seuls les marchands/partenaires peuvent accéder lorsque des pages de paiement personnalisées sont activées.
Commission - Pourcentage que les partenaires peuvent prendre sur les frais facturés par GoCardless pour chaque transaction.
S
Simulateur de scénario Noms de clients spéciaux qui peuvent être utilisés dans l'environnement sandbox pour déclencher des séquences d'évènements presque instantanément.
Jeton de session - Identifiant aléatoire qui doit être fourni lorsque le flux de redirection est créé, et à nouveau lorsqu'il est terminé. Cela permet aux intégrateurs de s'assurer que l'utilisateur qui a initialement été renvoyé vers les pages de paiement de GoCardless est bien celui qui les as remplies.
T
Webhook de test - Webhook qui peut être envoyé manuellement en utilisant des données fictives dans l'environnement sandbox.
W
Webhook - Un webhook est une requête que GoCardless envoie au serveur d'un marchand pour l'avertir d'un événement. Les marchands peuvent ainsi recevoir des notifications de GoCardless en temps réel et automatiser leurs actions en conséquence.
Code secret de webhook - Identifiant unique utilisé pour identifier et authentifier le point de terminaison de votre webhook. Il est utilisé lors de la signature des webhooks pour s'assurer que le webhook envoyé est authentique.