Guide de l'utilisateur ePay

Comment démarrer

1. Créer un compte

   Pour commencer à utiliser TAMAYYUZ ePay, commencez par créer un compte. Accédez à la page d'inscription, renseignez vos informations et activez votre compte comme demandé sur la plateforme.

   

   Une fois votre compte configuré, vous pourrez créer plusieurs applications au sein d'un même compte.

2. Créer une application ou mettre à jour une application existante

   Une application représente un projet, un site web ou une entité commerciale unique. Chaque application est un environnement autonome qui vous permet de gérer votre intégration de paiement de manière indépendante. Lorsque vous créez une application, vous recevez une clé API et une clé secrète uniques, qui servent à authentifier et à sécuriser les transactions pour cette application spécifique.

   Considérez une application comme un conteneur pour vos paramètres de paiement et votre historique de transactions. Cela signifie que chaque application dispose de ses propres enregistrements de transactions, garantissant ainsi que les paiements et les commandes sont clairement attribués au bon projet ou site web. De plus, l'utilisation d'applications distinctes pour chaque projet permet d'éviter les conflits de numéros de commande, chaque site web utilisant son propre système de numérotation. Cette flexibilité vous permet d'organiser efficacement vos intégrations de paiement et de développer votre activité en toute simplicité.

   Lors de la configuration initiale de votre compte, une application par défaut nommée « My new app » est créée automatiquement. Vous pouvez la modifier ou en créer de nouvelles si nécessaire pour gérer plusieurs projets ou sites web.

   2.1. Cliquez sur le nom de l'application actuelle dans la barre latérale gauche.

   2.2. Cliquez sur le bouton « Ajouter application ».

   

3. Activer le paiement électronique

   3.1. Saisissez vos coordonnées bancaires. Ce compte sera utilisé pour recevoir vos paiements et/ou paiements directs.

   

   3.2. Cliquez sur le bouton « Activer Epay » et renseignez les informations requises. Attendez qu'un membre de notre équipe examine et approuve votre demande d'activation.

   
   

   Si vous n'avez pas de RC, veuillez indiquer « N/A » dans les champs correspondants. Dans ce cas, assurez-vous que les informations de votre profil sont correctes et téléchargez une pièce d'identité (carte d'identité).

   3.3. Une fois votre ePayment activé, vous pouvez commencer à accepter des paiements. Vous recevrez alors une CLÉ API et une CLÉ SECRÈTE.

   

   3.4. Enregistrez l'URL de votre webhook. Pour enregistrer l'URL de votre webhook, accédez à votre application, cliquez sur « Modifier l'application », puis modifiez et enregistrez l'URL.

   Remarque:

   • Il est possible de modifier une application existante. Accédez-y en cliquant sur le nom de l'application et modifiez les informations souhaitées. Veuillez noter qu'après l'activation du paiement électronique, il ne sera plus possible de modifier certains champs de l'application.

   Important:

   • Pour traiter les paiements, vous devez activer votre compte utilisateur et demander l'activation du paiement électronique.

   • Veillez à ne JAMAIS partager vos clés sur des espaces publics tels que GitHub ou du code côté client.

4. Utiliser la fonctionnalité de paiement électronique

   À l'aide de la clé API et de la clé secrète, vous pouvez configurer votre site web pour accepter les paiements électroniques.

   La configuration dépend du type de site web. Par exemple, pour les sites web WordPress, il vous suffit d'installer notre plugin WordPress et d'ajouter les clés à sa configuration, comme indiqué ci-dessous.

   

   Pour tous les types de sites web (langages et frameworks), veuillez consulter cette documentation pour connaître les étapes d'intégration : Guide du développeur.

Paiements et Versements

Lorsque les acheteurs paient les produits que vous vendez sur vos sites web, les transactions sont effectuées via notre passerelle ePay.

Voici comment ces transactions sont liées aux factures et aux retraits.

1. Transactions

   Une transaction se produit lorsqu'un acheteur effectue un paiement pour un achat sur votre site web. Il peut s'agir d'achats de biens physiques, de produits numériques ou de services.

   Les transactions peuvent être réussies (approuvées) ou non (refusées). Les transactions réussies entraînent le blocage des fonds sur votre compte, que vous pouvez demander à virer sur votre compte bancaire via une demande de retrait.

   Par exemple, pour un paiement réussi de 4 000 DA, votre compte disposera d'un solde disponible pour retrait de 3 940 DA, compte tenu des frais de 1,5 %.

   

2. Factures

   Les factures désignent le paiement que vous nous effectuez. Le montant actuel dû s'affichera sur votre écran Factures.

   

   Ce montant correspond au total des frais possibles ci-dessous :

   • Frais de retrait réussi – consultez notre page de tarifs pour plus de détails.
   • Montant final du remboursement client (cas des commerçants intermédiaires et indirects)*
   • Frais de transaction réussie si le paiement a été effectué directement sur le compte bancaire du client (cas des commerçants directs)*

   Veuillez vérifier les types de commerçants dans la section « Frais » ci-dessous.

3. Retraits

   Un retrait est le transfert de fonds de votre compte commerçant vers votre compte bancaire. C'est ainsi que vous recevez l'argent des transactions réussies.

   Une fois les transactions réglées, vous pouvez effectuer un retrait pour transférer les fonds vers votre compte bancaire. Les retraits sont généralement soumis à des délais de traitement et entraînent des frais différents selon le type de commerçant.

4. Frais

   Nous définissons les types de commerçants suivants :

   • Direct Merchant: commerçant ayant conclu un contrat de commerçant en ligne avec sa banque, acceptant les paiements électroniques et ayant conclu un accord avec nous pour recevoir le paiement final du consommateur directement sur son compte bancaire.
   • Intermediary Merchant: commerçant ayant conclu un contrat de commerçant en ligne avec sa banque, mais ne recevant pas directement le paiement final du consommateur. Notre plateforme de paiement électronique encaisse le paiement et effectue un virement bancaire au commerçant.
   • Indirect Merchant: commerçant n'ayant pas conclu de contrat de commerçant en ligne avec sa banque. Notre plateforme de paiement électronique encaisse le paiement final du consommateur et effectue un virement bancaire au commerçant.

   Par défaut, un nouveau client est créé comme commerçant indirect. À la demande des utilisateurs, nous pouvons valider le basculement de cet utilisateur du statut de commerçant indirect vers les autres types de commerçants.

   Pour plus d'informations sur nos tarifs et les formules disponibles, veuillez consulter notre page de tarification.

Comment intégrer TAMAYYUZ ePay à votre site web/application

1. Plugin WooCommerce

   Commencez par télécharger le plugin WooCommerce que nous vous envoyons après l’enregistrement.

   Ensuite, regardez le tutoriel vidéo pour obtenir les instructions d'installation et de configuration. La vidéo sera disponible prochainement.

2. Autres langues et plateformes

   Veuillez consulter notre Guide du développeur TAMAYYUZ ePay pour une description détaillée de l'intégration des paiements électroniques à votre site web ou application.