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.
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.
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 clientVous pouvez ajouter un nouveau client en envoyant une requête à l’API FedaPay. Voici des exemples dans différents langages de programmation :
Copy
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' }});
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.
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
Copy
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 = {} );
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
Copy
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 = {});
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
Copy
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 = {});