Guide d'intégration rapide
📡Intégration d'un SDK
1. Installation et configuration
Téléchargement du SDK pour la plateforme concernée (Web, iOS, Android, Backend). Configuration avec les clés API fournies par l’agrégateur de paiement.
2. Intégration dans l’application
Utilisation des bibliothèques du SDK pour afficher un formulaire de paiement ou gérer une redirection vers une page de paiement hébergée. Appel aux APIs du SDK pour initier une transaction.
3. Gestion du paiement et confirmation
Le SDK communique avec les serveurs de l’agrégateur de paiement pour valider la transaction. En cas de succès, un callback ou un webhook est déclenché pour informer l’application de la confirmation du paiement.
4. Sécurisation et conformité
Le SDK intègre des mécanismes comme le chiffrement des données, la tokenisation et le 3D Secure pour garantir la sécurité des transactions.
🔌Intégration via les APIs REST
Une API REST (Representational State Transfer) est une interface qui permet à des applications de communiquer entre elles via le protocole HTTP, en respectant des principes architecturaux précis.
1. Authentification à l’API
L’accès aux API REST de MOALA est sécurisé avec :
API Key: Une clé unique envoyée dans l'en-tête ou l'URL.
API Secret: une seconde clé qui permet de s'assurer que le message transmis n'a pas été altéré, et souvent transmise dans l'entête de la requête.
2. Effectuer des requêtes HTTP
Pour effectuer des requêtes HTTP, il suffit d'identifier les requêtes dont on a besoin, et de les exécuter conformément aux paramètres d'exécution requis dans la documentation.
3. Tester l'API avant intégration
Il convient de toujours tester la bonne exécution des APIs avant leur intégration en production, afin de se rassurer de la bonne utilisation des paramètres fournis, et de la bonne gestion des erreurs qui peuvent survenir durant l'envoi des données au serveur ou durant la réception des réponses.
🔗Intégration via le lien de paiement
L’intégration dépend du fournisseur de services de paiement utilisé.
Voici les étapes générales :
1. Création du lien via l’interface Web
Certains prestataires permettent de générer manuellement des liens depuis un tableau de bord. Utile pour les petites entreprises ou les paiements ponctuels.
2. Création du lien via une API
Pour automatiser la création des liens, il est possible d’utiliser une API REST.
3. Intégration du lien dans l'expérience utilisateur
E-commerce : Affichage du lien sur la page de confirmation de commande. Facturation : Ajout du lien dans les emails ou PDF des factures. Service client : Envoi du lien via WhatsApp, Messenger ou SMS.
4. Gestion des notifications de paiement
Utilisation des webhooks pour être notifié des paiements en temps réel.