🚀 Plateforme de Paiement UBSI
Bienvenue dans la documentation de la plateforme de paiement UBSI ! Cette solution complète permet aux équipes SAV, e-commerce et magasins de traiter les paiements en toute sécurité.
🎯 À propos
La plateforme de paiement UBSI est une solution intégrée qui offre :
- Interface web moderne pour les clients finaux
- API REST complète pour l'intégration e-commerce
- Simulation de paiements pour les tests
- Gestion des moyens de paiement sauvegardés
- Support multi-devises (EUR, USD, etc.)
- Paiements différés et en plusieurs fois pour les clients fidèles
- Intégration Stripe pour Apple Pay et Google Pay
- Système de récupération en cas d'interruption
🏗️ Architecture
📁 Plateforme UBSI
├── 🖥️ Frontend React (Interface client)
├── ⚙️ Backend NestJS (API + Business Logic)
├── 💳 Stripe Integration (Digital Wallets)
├── 🐰 RabbitMQ (Messages d'expédition)
└── 🗄️ Base de données (Transactions & Clients)
👥 Public cible
🛠️ Équipes SAV
- Traitement des remboursements
- Consultation des transactions clients
- Support technique paiements
🛒 E-commerce
- Intégration API pour sites marchands
- Gestion des commandes et paiements
- Webhooks pour notifications
🏪 Magasins partenaires
- Paiements en espèces via bornes
- Consultation des transactions
- Interface simplifiée
🔗 Liens utiles
- Swagger Documentation : https://paiement.staging.ubsi.fr/api/swagger
- JSON Schema : https://paiement.staging.ubsi.fr/api/swagger/json
- Frontend Demo : https://paiement.staging.ubsi.fr/
📋 Modules principaux
🎨 Frontend (React + TypeScript)
- Interface de paiement avec support carte/digital wallets
- Récupération automatique en cas d'interruption
- Panel de test pour les développeurs
- Composants réutilisables pour intégration
⚡ Backend (NestJS + TypeScript)
- API Publique (
/api/publique) : Accessible sans authentification - API Privée (
/api/private) : Pour les intégrations internes - Services métier : Gestion des paiements, clients, transactions
- Intégration Stripe : Digital wallets et simulation
🔄 Système de récupération
- Sauvegarde automatique des sessions de paiement
- Détection d'interruptions (fermeture navigateur, coupure réseau)
- Modal de récupération au retour de l'utilisateur
- Polling automatique du statut des transactions
🚦 Statuts des paiements
| Statut | Description | Action recommandée |
|---|---|---|
en_attente | Paiement initié, en cours | Attendre la confirmation |
accepte | Paiement confirmé en attente d'envoi | |
paye | Paiement debité la commande a été envoyé | |
refuse | Paiement rejeté ou échoué | Réessayer ou contacter support |
annule | Paiement annulé par l'utilisateur | - |
🛠️ Prochaines étapes
- Pour le SAV → Consultez la section API Transactions
- Pour l'e-commerce → Voir API Paiements et Intégration
- Pour les magasins → Section Paiements en espèces
- Pour les développeurs → Spécifications techniques