La gestion des clients est une étape essentielle pour effectuer des transactions via la plateforme FedaPay. Chaque transaction est liée à un client, c’est pourquoi vous devez enregistrer et gérer vos clients dans le système avant de pouvoir initier une transaction.

​
Création des clients

La création d’un client dans FedaPay se fait via une requête API qui permet d’ajouter les informations nécessaires sur votre client. Ces données sont utilisées lors des transactions pour identifier clairement l’utilisateur.

​
Paramètres nécessaires

Lors de la création d’un client, vous devez fournir les informations suivantes :
  • Prénom (firstname) : le prénom du client.
  • Nom (lastname) : le nom de famille du client.
  • Email (email) : l’adresse email du client, qui servira pour toute communication et confirmation.
  • Numéro de téléphone (phone_number) : facultatif, mais utile pour des transactions avec certains services (doit inclure l’indicatif du pays, ex. +229 pour le Bénin).
Ces informations sont obligatoires à l’exception du numéro de téléphone, mais il est conseillé de les fournir pour améliorer le suivi des interactions avec le client et les paiements. Exemple de requête API pour la création d’un client Vous pouvez ajouter un nouveau client en envoyant une requête à l’API FedaPay. Voici des exemples dans différents langages de programmation : 
const { FedaPay, Customer } = require('fedapay');
/* Replace YOUR_SECRETE_API_KEY with your real API key */
FedaPay.setApiKey("YOUR_SECRETE_API_KEY");
/* Specify whether you want to run your query in test or live mode */
FedaPay.setEnvironment('sandbox'); //or setEnvironment('live');
/* Create customer */
const customer = await Customer.create({
  firstname: 'John',
  lastname: 'Doe',
  email: 'john@doe.com',
  phone_number: {
    number: '90090909',
    country: 'BJ'
  }
});

​
Points importants

  • Assurez-vous de remplacer YOUR_SECRETE_API_KEY par votre clé API secrète.
  • Le lien d’API peut changer selon l’environnement. Utilisez https://api.fedapay.com/v1/customers pour l’environnement live.

​
Suivi des transactions des clients

Une fois vos clients créés, il est possible de contrôler leurs informations et d’effectuer des modifications ou des suppressions en fonction des besoins.

​
Récupérer la liste des clients

Vous pouvez obtenir la liste complète des clients enregistrés sur votre compte FedaPay en envoyant une simple requête à l’API. Cela permet d’avoir un aperçu de tous les clients disponibles, de consulter leurs détails et de suivre leurs transactions. Exemple de requête pour récupérer les clients 
const { FedaPay, Customer } = require('fedapay');
/* Replace YOUR_SECRETE_API_KEY with your real API key */
FedaPay.setApiKey("YOUR_SECRETE_API_KEY");
/* Specify whether you want to run your query in test or live mode */
FedaPay.setEnvironment('sandbox'); //or setEnvironment('live');
/* Show customers */
const customer = await Customer.all( params = {}, headers = {} );

​
Mise à jour des informations client

Il peut arriver que vous ayez besoin de mettre à jour les informations d’un client (par exemple, une adresse email ou un numéro de téléphone incorrect). Pour ce faire, vous devez fournir l’identifiant du client et les nouvelles informations. Exemple de mise à jour 
const { FedaPay, Customer } = require('fedapay');
/* Replace YOUR_SECRETE_API_KEY with your real API key */
FedaPay.setApiKey("YOUR_SECRETE_API_KEY");
/* Specify whether you want to run your query in test or live mode */
FedaPay.setEnvironment('sandbox'); //or setEnvironment('live');
/* Modify customer */
const customer = await Customer.update(ID, params = {}, headers = {});

​
Suppression d’un client

Si un client n’est plus actif ou que vous souhaitez supprimer ses données de votre compte FedaPay, vous pouvez utiliser une requête API pour retirer ses informations. Exemple de suppression 
const { FedaPay, Customer } = require('fedapay');
/* Replace YOUR_SECRETE_API_KEY with your real API key */
FedaPay.setApiKey("YOUR_SECRETE_API_KEY");
/* Specify whether you want to run your query in test or live mode */
FedaPay.setEnvironment('sandbox'); //or setEnvironment('live');
/* Delete customer */
const customer = await Customer.delete(ID, params = {}, headers = {});