Documentation

1Introduction aux Charge Flows

Les Charge Flows sont utilisés lorsque vous souhaitez débiter votre client. Selon le mode de paiement, nous décidons ensuite si nous pouvons débiter le client directement ou si nous devons envoyer un e-mail, un SMS, etc. pour collecter ses informations de paiement. Comment et quand cela se produit peut être défini dans les Charge Flow Levels.

1.1Cas d’utilisation des Charge Flows : paiements récurrents

Le paiement récurrent est un concept intéressant pour la fidélisation et le confort du client, en particulier dans le secteur du e-commerce. Le Charge Flow est un concept que vous pouvez utiliser si vous vendez des biens et que vous souhaitez contrôler quand un client doit être débité. Dans ce cas, vous pouvez créer une transaction via l’API en utilisant le token (voir ci-dessous pour plus de détails). L’application essaie alors de débiter le token spécifié. En cas d’échec, le processus de Charge Flow veille à ce que votre client soit contacté pour mettre à jour les informations de paiement, ce qui réduit considérablement votre charge de travail pour mettre en place des processus récurrents.

Important
Si vous souhaitez vendre des abonnements pour des biens numériques, consultez notre API d’abonnement qui vous permet de créer des produits et d’appliquer toutes sortes de méthodes de tarification et de facturation.

1.2Cas d’utilisation des Charge Flows : liens de paiement par e-mail

Vous pouvez également utiliser les Charge Flows pour votre intégration centre d’appels / boutique en ligne chaque fois que vous souhaitez collecter les informations de paiement de manière asynchrone. C’est-à-dire que vous souhaitez envoyer à vos clients un e-mail contenant un lien de paiement issu de votre boutique afin de ne pas collecter les informations de paiement directement par téléphone. Cela présente pour vous le grand avantage d’économiser des frais de transaction, car les transactions MoTo sont plus coûteuses, et de pouvoir traiter les paiements avec tous les modes de paiement possibles. Les Charge Flows enverront ensuite automatiquement des rappels à vos clients selon vos Charge Flow Levels (voir ci-dessous).

2Charge Flows et Charge Flow Levels

Nous distinguons trois manières différentes de débiter le client. Les Charge Flows et les Charge Flow Levels peuvent être configurés sous Space > Configuration > Charge Flows.

Vous devez d’abord configurer un Charge Flow, puis lui associer les différents niveaux. Les Charge Flow Levels définissent le processus selon lequel vous souhaitez débiter le client et, si le débit échoue, la manière dont vous souhaitez récupérer les informations de paiement auprès de lui.

2.1Différentes manières de débiter un client

Nous vous proposons trois manières de débiter le client ou de récupérer les informations de paiement si le débit échoue ou si les informations de paiement n’ont pas encore été collectées.

  • Utilisation d’un token : un token représente essentiellement une référence à des informations de paiement stockées dans la plateforme. Si un client dispose d’un token associé valide, nous pouvons utiliser le token pour débiter le client directement.

  • Débit asynchrone : certains modes de paiement vous permettent de débiter le client sans son interaction. Tout ce dont vous avez besoin, ce sont les informations de paiement pertinentes (par exemple pour envoyer une facture). Dans ce cas, nous pouvons également débiter le client à l’aide des informations présentes.

  • Envoi d’un lien : si aucun des mécanismes ci-dessus ne fonctionne, un lien est envoyé au client. Le lien pointe vers la page de paiement. Le client peut y sélectionner n’importe quel mode de paiement configuré et finaliser la transaction. Comment et quand ce lien est envoyé est défini dans les Charge Flow Levels. Voir aussi Envoi du lien de paiement.

La configuration du Charge Flow définit exactement comment les stratégies ci-dessus sont appliquées. Vous pouvez ajuster les configurations selon vos besoins.

2.2Token

Un token représente une référence à des informations de paiement stockées. Consultez la documentation sur la tokenisation pour découvrir comment les tokens peuvent être utilisés et appliqués aux transactions.

2.3Créer un Charge Flow

Un Charge Flow peut être créé dans le back-office. Allez sous Space > Paiement > Configuration > Charge Flows et cliquez sur Charge Flow pour en ajouter un.

2.4Gérer les Charge Flow Levels

Les Charge Flow Levels n’entrent en jeu que lorsqu’il n’y a pas de token ou pas de token valide et que le débit asynchrone n’a pas été possible. Ils déterminent comment et quand les informations de la transaction sont collectées. Dès que le Charge Flow est créé, vous pouvez créer un Charge Flow Level. Dans le Charge Flow Level, vous pouvez choisir le Type qui définit la manière dont le client sera notifié. Selon le Type, vous avez la possibilité de fournir des paramètres supplémentaires.

Vous pouvez créer autant de Charge Flow Levels que vous le souhaitez. Lors du traitement du Charge Flow, tous les niveaux sont pris en compte jusqu’à ce que le client ait fourni avec succès les informations de paiement et que la transaction se trouve dans l’état Fulfill. La tentative de débit est considérée comme Failed une fois que tous les Charge Flow Levels ont été traités sans succès.

2.5Processus de sélection du Charge Flow

Vous avez la possibilité de créer plusieurs Charge Flows pour différentes occasions. Vous pouvez attribuer des conditions sous Space > Paiement > Configuration > Conditions aux différents Charge Flows. Pour déterminer la configuration du Charge Flow, les étapes suivantes sont effectuées :

  • Les Charge Flows pertinents sont déterminés en appliquant toutes les conditions configurées.

  • La priorité de la configuration de niveau actuelle est sélectionnée.

  • Toutes les configurations de niveau d’un flux donné sont triées par ordre croissant.

  • Nous choisissons la configuration de niveau dont la priorité est immédiatement supérieure à celle de la configuration de niveau actuelle.

Important
La priorité indique l’ordre de tri des configurations de niveau. Une valeur basse indique que la configuration de niveau est exécutée avant tout niveau ayant une valeur plus élevée. Toute modification de cette valeur affecte les sélections futures de configuration de niveau. Cela signifie que si vous modifiez la priorité, l’ordre de tri sera réévalué lorsque le niveau suivant sera dû.

3Utiliser les Charge Flows

Les Charge Flows peuvent être déclenchés via le back-office ou via l’API.

3.1Déclencher des Charge Flows depuis le back-office

Vous pouvez créer des transactions depuis l’application sous Space > Paiement > Transaction > Créer. Vous pouvez fournir les informations de transaction pertinentes directement dans votre navigateur.

Chare Flows
Figure 1. Comment créer une transaction sans présence du client avec les Charge Flows.

3.2Déclencher des Charge Flows via l’API

Les Charge Flows peuvent être appliqués aux transactions à l’état pending. Il vous suffit de créer une transaction à l’aide du service de création de transaction.

Une fois la transaction créée, vous pouvez utiliser l’opération Apply Flow du service Charge Flow pour déclencher le débit à l’aide d’un Charge Flow. Cela déclenche alors le processus de débit décrit ci-dessus.

4Envoi du lien de paiement

Un Charge Flow se compose de différents niveaux. Chaque niveau peut avoir son propre type. Le type définit si et comment le lien de paiement est envoyé au client. Le type n’est pertinent que si le débit n’a pas abouti et que le client doit fournir des informations de paiement pour finaliser la transaction.

Les types d’envoi suivants existent :

  • Email : le type de niveau e-mail envoie le lien de paiement par e-mail au client. La condition préalable est une adresse e-mail définie sur la transaction. Pour utiliser cette option d’envoi, la fonction e-mail doit être activée.

  • No Action : ce type empêche l’envoi du lien de paiement, ce qui permet d’essayer de débiter le client avec un token sans prendre de mesures en cas d’échec du débit. Ceci est utile pour les stratégies de nouvelle tentative. Pour certains modes de paiement et dans certains pays, les nouvelles tentatives sont plus utiles que d’informer immédiatement le client de l’échec.

  • External Application : le type application externe permet de déléguer la transmission du lien de paiement au client à une application externe. L’application externe doit enregistrer un webhook pour l’entité Charge Flow Level Payment Link. Chaque fois qu’un Charge Flow Level nécessite la transmission d’un lien de paiement, une telle entité est créée et l’URL du webhook est appelée. L’application externe à l’écoute de cette URL peut utiliser l’API Web Service pour récupérer le lien de paiement. L’application externe transmet ensuite le lien au client.