API

Appel d'Offre pour le Développement d'une API Lebalma Pay Intégrable sur WordPress/WooCommerce et PrestaShop

1. Introduction
- Objet de l'appel d'offre : Développement d'une API BNPL (Buy Now, Pay Later) pour Lebalma, permettant d'intégrer les paiements par tranche via des services de mobile money et compatible avec les plateformes e-commerce telles que WordPress/WooCommerce et PrestaShop.
- Porteur de projet : El Hadji Cheikhou Sall

2. Contexte et objectifs
- Contexte : Lebalma souhaite offrir une solution de paiement flexible pour ses clients, leur permettant de payer par tranche grâce aux services de mobile money.
- Objectifs
- Développer une API BNPL robuste et sécurisée.
- Intégrer les principaux services de paiement mobile (Wave, Orange Money, etc.).
- Offrir une expérience utilisateur fluide et transparente.
- Moderniser et digitaliser tout le processus d'achat, de vente, et de collecte de paiement récurrent du crédit restant.
- Assurer la compatibilité avec des plateformes e-commerce comme WordPress/WooCommerce et PrestaShop.
- Ajouter la possibilité d'intégrer le paiement par carte bancaire à l'avenir.

3. Description du projet et structure de l'API
- Structure de l'API:
- Inscription et vérification : Enregistrement des clients et vérification de leur éligibilité pour le BNPL.
- Gestion des paiements:Traitement des paiements initiaux et échelonnés via les services de mobile money.
- Notification et rappel : Envoi de notifications pour les paiements à venir et les rappels de paiement.
- Suivi des paiements : Interface pour suivre l'état des paiements et le scoring des clients basé sur leurs différents achats.
-Compatibilité e-commerce : Intégration fluide avec WordPress/WooCommerce et PrestaShop.

4. Fonctionnalités requises

4.1. Authentification et sécurité
- OAuth 2.0 pour la sécurisation des accès.
- JWT (JSON Web Tokens) pour les sessions.
- SSL/TLS pour le chiffrement des communications.

4.2. Gestion des utilisateurs
- Endpoints :
- `POST /users/register` : Inscription des utilisateurs.
- `POST /users/login` : Connexion des utilisateurs.
- `GET /users/profile` : Récupération des informations de profil.
- `PUT /users/profile` : Mise à jour des informations de profil.

4.3. Gestion des paiements
- Endpoints :
- `POST /payments/initiate` : Initiation d'un paiement BNPL.
- `POST /payments/complete` : Confirmation du paiement initial.
- `GET /payments/schedule` : Récupération du calendrier de paiement.
- `POST /payments/remind` : Envoi de rappels de paiement.

4.4. Intégration des services de mobile money
:
Endpoints
- `POST /mobilemoney/wave/initiate` : Initiation d'un paiement avec Wave.
- `POST /mobilemoney/orange/initiate` : Initiation d'un paiement avec Orange Money.
- `POST /mobilemoney/wave/confirm` : Confirmation d'un paiement avec Wave.
- `POST /mobilemoney/orange/confirm` : Confirmation d'un paiement avec Orange Money.

4.5. Gestion du scoring
- Endpoints
- `GET /scoring/user` : mettre en place un système de scoring d'un utilisateur basé sur ses différents achats.
- `POST /scoring/update` : Mise à jour du scoring d'un utilisateur après chaque achat.

4.6. Compatibilité avec WordPress/WooCommerce et PrestaShop
- Endpoints:
- `POST /woocommerce/orders/initiate` : Initiation d'un paiement BNPL pour une commande WooCommerce.
- `POST /woocommerce/orders/complete` : Confirmation du paiement initial pour une commande WooCommerce.
- `GET /woocommerce/orders/:id/schedule` : Récupération du calendrier de paiement pour une commande WooCommerce.
- `POST /prestashop/orders/initiate` : Initiation d'un paiement BNPL pour une commande PrestaShop.
- `POST /prestashop/orders/complete` : Confirmation du paiement initial pour une commande PrestaShop.
- `GET /prestashop/orders/:id/schedule` : Récupération du calendrier de paiement pour une commande PrestaShop.
- **Plugins nécessaires** :
- Plugin WordPress pour intégrer l'API Lebalma Pay.
- Extension WooCommerce pour la gestion des paiements BNPL via Lebalma Pay.
- Module PrestaShop pour la gestion des paiements BNPL via Lebalma Pay.

4.7. Intégration future du paiement par carte bancaire
- Prévoir des endpoints pour :
- `POST /card/initiate` : Initiation d'un paiement par carte bancaire.
- `POST /card/confirm` : Confirmation d'un paiement par carte bancaire.

5. Design et ergonomie
- **Conformité avec les normes RESTful API**.
- **Documentation API** avec Swagger ou Postman.
- **Interface utilisateur** : Widgets et shortcodes pour une intégration facile sur les sites WordPress/WooCommerce et PrestaShop.