MPR Commande Revolution

MPR Express Checkout

Integration avancee de Stripe pour PrestaShop 1.7.8+ offrant un checkout express depuis n'importe quelle page. Les clients effectuent leurs achats instantanement avec des portefeuilles numeriques, des cartes et des methodes de paiement regionales sans le flux de checkout traditionnel.

Version: 1.7.3 Author: mypresta.rocks License: Commercial PrestaShop Compatibility: 1.6 - 1.7.8.11+

Table des matieres

• Apercu
• Fonctionnalites principales
• Methodes de paiement
• Systeme de themes d'icones
• Architecture
• Schema de base de donnees
• Developpement
• Configuration
• Controleurs Frontend
• Controleurs Admin
• Points d'integration
• Systeme de devis/RFQ
• Feuille de route future

Apercu

MPR Express Checkout transforme l'experience e-commerce en permettant les achats en un clic depuis les pages produits, le panier et le checkout. Base sur l'API Payment Intents de Stripe, il prend en charge 31+ methodes de paiement y compris les portefeuilles numeriques, les virements bancaires regionaux et les solutions Buy Now Pay Later.

Le module propose un modal de checkout unifie qui consolide l'inscription client, la gestion des adresses, la selection de livraison et le traitement des paiements dans une interface unique et optimisee, reduisant considerablement l'abandon de panier et augmentant les conversions mobiles.

Fonctionnalites principales

Experience Express Checkout

• Achat en un clic: Achetez directement depuis les pages produits, le panier ou tout type de page
• Modal unifie: Interface modale unique pour le flux de checkout complet
• Gestion intelligente du panier: Creation, fusion et recuperation automatiques du panier
• Validation en temps reel: Validation instantanee des bons et calcul des frais de livraison
• Optimise pour mobile: Integration native des portefeuilles (Apple Pay, Google Pay, Samsung Pay)

Traitement des paiements

• Integration Stripe: Support complet de l'API Payment Intents de Stripe
• 31+ methodes de paiement: Wallets, cartes, virements bancaires, BNPL et methodes manuelles
• Cartes sauvegardees: Stockage securise des cartes pour les achats recurrents
• Recuperation de paiement: Systeme de recuperation des paniers abandonnes
• Traitement Webhook: Mises a jour du statut de paiement en temps reel

Experience client

• Social Login: Authentification Google, Facebook, Apple, Microsoft
• Checkout invite: Achats complets sans creation de compte
• Autocompletion d'adresse: Integration Google Places API
• Validation TVA: Integration API VIES pour les entreprises de l'UE
• Multilingue: Traductions pour 7+ langues (EN, PL, DE, FR, ES, IT, NL)

Fonctionnalites B2B

• Comptes entreprise: Support multi-utilisateurs pour les comptes entreprise
• Exoneration de TVA: Gestion de l'exoneration fiscale pour les entreprises eligibles
• Bons de commande: Support des numeros de PO pour les paiements sur compte de credit
• Credit commercial: Methode de paiement par compte de credit
• Systeme de devis/RFQ: Workflow de demande de devis avec support de negociation

Outils d'administration

• Dashboard: Apercu des transactions et metriques de performance
• Gestion des transactions: Afficher et gerer toutes les transactions
• Traitement des remboursements: Support des remboursements complets et partiels
• Details des charges: Ventilation complete des paiements et frais
• Gestion des devis: Creer, modifier et gerer les devis clients
• Suivi clients social: Surveiller les inscriptions via social login
• Configuration des transporteurs: Configurer les transporteurs avec les delais de transit
• Verificateur d'integrite: Valider la configuration du module et la base de donnees

Methodes de paiement

Le module prend en charge 31 methodes de paiement dans plusieurs categories, chacune avec des icones dediees et des traductions localisees.

Wallets & Cartes (8 methodes)

Portefeuilles numeriques et paiements par carte avec autorisation instantanee:

1. Google Pay - Portefeuille numerique Google (navigateur Chrome)
2. Apple Pay - Portefeuille numerique Apple (Safari/iOS)
3. Card - Visa, Mastercard, Amex, JCB, Cartes Bancaires
4. PayPal - Portefeuille PayPal et paiements par compte
5. Amazon Pay - Paiements par compte Amazon
6. Link - Stripe Link (details de paiement sauvegardes)
7. Samsung Pay - Portefeuille numerique Samsung
8. Revolut - Portefeuille numerique Revolut

Methodes bancaires europeennes (9 methodes)

Methodes de paiement bancaires regionales populaires en Europe:

9. iDEAL - Virement bancaire neerlandais (EUR uniquement)
10. Bancontact - Paiement bancaire belge (EUR uniquement)
11. BLIK - Paiement mobile polonais (PLN uniquement)
12. Przelewy24 - Banque en ligne polonaise (PLN, EUR)
13. EPS - Virement bancaire autrichien (EUR uniquement)
14. Multibanco - Systeme de paiement portugais (EUR uniquement)
15. Twint - Paiement mobile suisse (CHF uniquement)
16. Satispay - Paiement mobile italien (EUR uniquement)
17. MobilePay - Paiement mobile nordique (DKK, NOK, SEK, EUR)

Methodes de paiement asiatiques (5 methodes)

Methodes de paiement populaires sur les marches asiatiques:

18. Alipay - Portefeuille numerique chinois (CNY, EUR, GBP, USD)
19. WeChat Pay - Paiement mobile chinois (CNY, EUR, GBP, USD)
20. Kakao Pay - Paiement mobile coreen (KRW uniquement)
21. Naver Pay - Plateforme de paiement coreenne (KRW uniquement)
22. Payco - Portefeuille numerique coreen (KRW uniquement)

Buy Now Pay Later (4 methodes)

Solutions de paiement echelonne et differe:

23. Klarna - BNPL en 11 devises (EUR, USD, GBP, SEK, NOK, DKK, CHF, PLN, AUD, NZD, CAD)
24. Afterpay / Clearpay - BNPL en 6 devises (USD, CAD, AUD, NZD, GBP, EUR)
25. Alma - BNPL francais (EUR, 10 pays europeens)
26. Billie - B2B BNPL (EUR, 7 pays europeens)

Virements bancaires & prelevement (1 methode)

Paiements directs par compte bancaire:

27. SEPA Debit - Prelevement europeen (EUR uniquement)

Methodes manuelles/hors ligne (4 methodes)

Methodes de paiement traditionnelles traitees hors ligne:

28. Bank Transfer - Virement bancaire manuel
29. Cash on Delivery (COD) - Paiement a la livraison
30. Credit Account - Compte commercial avec conditions de credit
31. Store Pickup - Paiement au retrait en magasin

Systeme de themes d'icones

Le module inclut un systeme d'icones complet avec 8 variantes de themes pour correspondre a tout design de boutique:

Themes d'icones (4 schemas de couleurs)

1. Light Mode - Arriere-plans clairs avec texte sombre
2. Dark Mode - Arriere-plans sombres avec texte clair
3. Light Accent - Arriere-plans clairs avec accents de couleur de marque
4. Dark Accent - Arriere-plans sombres avec accents de couleur de marque

Formes d'icones (2 rapports d'aspect)

1. Rectangle - Format large pour les pages de checkout et les listes d'options de paiement
2. Square - Format compact pour les boutons de paiement et le modal unifie

Configuration des icones

• Total Icon Variants: 31 methods × 4 themes × 2 shapes = 248 SVG icons
• Path Structure: views/img/payment-icons/{shape}/{theme}/{method}.svg
• Theming dynamique: Icones chargees selon la configuration admin
• Icones de marques de cartes: Icones separees pour Visa, Mastercard, Amex, JCB, Cartes Bancaires

Exemples de chemins:

views/img/payment-icons/rectangle/light-mode/google_pay.svg
views/img/payment-icons/square/dark-accent/apple_pay.svg
views/img/payment-icons/rectangle/light-mode/visa.svg

Architecture

Structure des repertoires

mprexpresscheckout/
├── mprexpresscheckout.php          # Main module class (3,600+ lines)
├── config.xml                       # Module metadata
├── composer.json                    # PHP dependencies
├── package.json                     # Node.js build tools
├── Gruntfile.js                     # Grunt task configuration
├── gulpfile.js                      # Gulp build pipeline
│
├── src/                             # Namespaced PHP classes
│   ├── Classes/                     # Core business logic (30+ classes, 28K+ lines)
│   │   ├── MPRExpressCheckoutConfig.php              # Configuration management
│   │   ├── MPRExpressCheckoutCart.php                # Virtual cart handling
│   │   ├── MPRExpressCheckoutTransaction.php         # Payment transactions
│   │   ├── MPRExpressCheckoutCharge.php              # Stripe charge details
│   │   ├── MPRExpressCheckoutRefund.php              # Refund processing
│   │   ├── MPRExpressCheckoutPaymentOption.php       # Payment method config
│   │   ├── MPRExpressCheckoutPaymentMethod.php       # Saved payment methods
│   │   ├── MPRExpressCheckoutOrderProcessor.php      # Order creation logic
│   │   ├── MPRExpressCheckoutAddress.php             # Address management
│   │   ├── MPRExpressCheckoutSocialAuth.php          # Social login (Google, FB, Apple, MS)
│   │   ├── MPRExpressCheckoutCustomer.php            # Customer handling
│   │   ├── MPRExpressCheckoutShippingService.php     # Carrier configuration
│   │   ├── MPRExpressCheckoutSession.php             # Session tracking
│   │   ├── MPRExpressCheckoutWebhookEvent.php        # Stripe webhook handler
│   │   ├── MPRExpressCheckoutVatValidator.php        # EU VAT validation
│   │   ├── MPRExpressCheckoutSMS.php                 # SMS notifications
│   │   ├── MPRExpressCheckoutIntegrity.php           # System integrity checks
│   │   ├── MPRExpressCheckoutAdminOrder.php          # Admin order creation
│   │   ├── MPRExpressCheckoutDbQuery.php             # Database query builder
│   │   ├── MPRExpressCheckoutErrorHandler.php        # Error handling
│   │   ├── MPRExpressCheckoutTranslations.php        # Translation management
│   │   ├── MPRExpressCheckoutQuote.php               # Quote management (ObjectModel)
│   │   ├── MPRExpressCheckoutQuoteItem.php           # Quote line items (ObjectModel)
│   │   ├── MPRExpressCheckoutQuoteStatus.php         # Quote status workflow (ObjectModel)
│   │   ├── MPRExpressCheckoutQuoteMessage.php        # Quote messaging (ObjectModel)
│   │   ├── MPRExpressCheckoutQuoteHistory.php        # Quote audit trail (ObjectModel)
│   │   └── MPRExpressCheckoutQuotePdf.php            # Quote PDF generation
│   │
│   ├── Config/                      # Configuration classes
│   │   ├── PaymentMethodsConfig.php          # All payment method definitions
│   │   └── PaymentMethodsTranslations.php    # Multi-language translations
│   │
│   └── Traits/                      # Reusable trait components
│       ├── AdminController/         # Admin list management traits
│       ├── Compatiblility/          # PrestaShop compatibility
│       ├── ObjectModel/             # ORM extensions
│       └── Associations/            # Database associations
│
├── controllers/                     # PrestaShop controllers
│   ├── front/                       # Frontend controllers (20 controllers)
│   │   ├── Checkout.php             # Main checkout modal
│   │   ├── Processing.php           # Payment processing
│   │   ├── Ajax.php                 # AJAX endpoint handler
│   │   ├── Webhook.php              # Stripe webhook receiver
│   │   ├── PaymentStatus.php        # Payment status page
│   │   ├── Recover.php              # Cart recovery
│   │   ├── Cards.php                # Saved cards management
│   │   ├── Login.php                # Customer login
│   │   ├── Register.php             # Customer registration
│   │   ├── ForgotPassword.php       # Password recovery
│   │   ├── Account.php              # Customer account
│   │   ├── Identity.php             # Personal information
│   │   ├── Address.php              # Single address management
│   │   ├── Addresses.php            # Address book
│   │   ├── Cart.php                 # Cart management
│   │   ├── Quotes.php               # Customer quotes list
│   │   ├── Quote.php                # Single quote detail view
│   │   ├── QuoteRequest.php         # Quote request form
│   │   └── QuotePdf.php             # Quote PDF download
│   │
│   └── admin/                       # Backend controllers (16 controllers)
│       ├── AdminMPRExpressCheckoutDashboardController.php
│       ├── AdminMPRExpressCheckoutConfigController.php
│       ├── AdminMPRExpressCheckoutTransactionsController.php
│       ├── AdminMPRExpressCheckoutChargesController.php
│       ├── AdminMPRExpressCheckoutRefundsController.php
│       ├── AdminMPRExpressCheckoutPaymentOptionsController.php
│       ├── AdminMPRExpressCheckoutPaymentMethodsController.php
│       ├── AdminMPRExpressCheckoutSocialCustomersController.php
│       ├── AdminMPRExpressCheckoutCartsController.php
│       ├── AdminMPRExpressCheckoutSessionsController.php
│       ├── AdminMPRExpressCheckoutShippingServiceController.php
│       ├── AdminMPRExpressCheckoutQuotesController.php
│       ├── AdminMPRExpressCheckoutQuoteStatusesController.php
│       ├── AdminMPRExpressCheckoutIntegrityController.php
│       └── AdminMPRExpressCheckoutAjaxController.php
│
├── views/                           # Frontend assets and templates
│   ├── templates/                   # Smarty templates
│   │   ├── front/                   # Frontend templates
│   │   ├── admin/                   # Admin templates
│   │   ├── hook/                    # Hook templates
│   │   └── _partials/               # Reusable template components
│   ├── js/                          # JavaScript (compiled)
│   ├── css/                         # Stylesheets (compiled)
│   └── img/                         # Images and icons
│       ├── payment-icons/           # Payment method icons (248 SVG files)
│       │   ├── rectangle/           # Wide format icons
│       │   │   ├── light-mode/
│       │   │   ├── dark-mode/
│       │   │   ├── light-accent/
│       │   │   └── dark-accent/
│       │   └── square/              # Square format icons
│       │       ├── light-mode/
│       │       ├── dark-mode/
│       │       ├── light-accent/
│       │       └── dark-accent/
│       ├── buttons/                 # Express checkout button graphics
│       └── options/                 # UI element icons
│
├── sources/                         # Source files for build
│   ├── js/                          # JavaScript source files
│   └── css/                         # SCSS source files
│
├── sql/                             # Database installation
│   ├── install.php                  # Table creation (28 tables)
│   └── uninstall.php                # Table cleanup
│
├── upgrade/                         # Version upgrade scripts
├── translations/                    # Language files
├── mails/                           # Email templates
├── vendor/                          # Composer dependencies
└── node_modules/                    # NPM build dependencies

Schema de base de donnees

Le module cree 34 tables de base de donnees pour gerer tous les aspects du checkout express:

Tables principales

mprexpresscheckout_cart - Stockage de panier virtuel

• Stocke les sessions de checkout express avec les donnees clients, adresses et selections
• Inclut les donnees de recuperation du panier avec dates d'expiration
• Suit le contexte de la page (produit, panier, checkout, etc.)

mprexpresscheckout_config - Configuration du module

• Stockage cle-valeur avec support de contexte (boutique, langue, groupe)
• Configuration multilingue via la table _lang

mprexpresscheckout_payment_options - Configuration des methodes de paiement

• Parametres et disponibilite des methodes de paiement
• Restrictions basees sur le contexte (pays, devise, navigateur, type de page)
• Ordre de position et indicateurs d'activation Stripe

Tables de transactions et paiements

mprexpresscheckout_transactions - Transactions de paiement

• Lie les paniers virtuels aux commandes
• Suivi du type de transaction (express, checkout, terminal, facture, etc.)
• Gestion de l'etat du paiement et suivi des erreurs

mprexpresscheckout_charges - Details des charges Stripe

• Payment Intent et Charge IDs
• Calcul des frais et taux de change
• Scores d'evaluation des risques
• URLs de recus et details des methodes de paiement

mprexpresscheckout_refunds - Enregistrements de remboursement

• Suivi des remboursements complets et partiels
• Attribution employee
• Suivi du statut et du motif de remboursement

mprexpresscheckout_payment_methods - Methodes de paiement sauvegardees

• Details de carte stockes (last4, marque, expiration)
• Liens vers les Stripe Customer IDs

Tables clients et Social Login

mprexpresscheckout_customers - Mapping client Stripe

• Lie les clients PrestaShop aux Stripe Customer IDs
• Suivi email pour les clients invites

mprexpresscheckout_social_customers - Authentification sociale

• Liens de comptes Google, Facebook, Apple, Microsoft
• IDs utilisateur de plateforme et photos de profil

mprexpresscheckout_social_logins - Suivi des connexions mprexpresscheckout_social_registrations - Suivi des inscriptions

Tables de livraison et expedition

mprexpresscheckout_shipping_service - Configuration du transporteur

• Estimations de temps de transit (jours min/max)
• Modes d'affichage et ordre de position
• Indicateurs d'activation separes pour le checkout express et OPC

mprexpresscheckout_shipping_service_lang - Traductions des transporteurs mprexpresscheckout_shipping_service_payment_options - Restrictions de methode de paiement par transporteur mprexpresscheckout_shipping_service_external_modules - Integration de modules de transporteurs tiers

Tables de detail du panier virtuel

mprexpresscheckout_cart_customer - Informations client mprexpresscheckout_cart_product - Produits du panier mprexpresscheckout_cart_address - Adresses de livraison/facturation mprexpresscheckout_cart_rule - Bons/remises appliques

Tables de sessions et suivi

mpr_sessions - Suivi de session partage

• Detection appareil, navigateur, OS
• Suivi de campagne UTM
• Suivi de page d'atterrissage
• Stockage IP et user agent

mprexpresscheckout_admin_preferences - Preferences utilisateur admin mprexpresscheckout_admin_order - Commandes creees par l'admin mprexpresscheckout_sso_codes - Codes d'authentification SMS mprexpresscheckout_customer_vat - Resultats de validation TVA

Tables B2B et entreprise

mpr_customer - Donnees client etendues

• Preferences par defaut (adresse, transporteur, paiement)
• Parametres d'authentification a deux facteurs
• Suivi du consentement marketing (conforme RGPD)
• Statut d'exoneration fiscale

mpr_company - Donnees du compte entreprise

• Numero de TVA et validation
• Statut de verification de l'entreprise
• Liens d'invitation et correspondance de domaine

mpr_company_member - Adhesion a l'entreprise

• Acces base sur les roles (admin/membre)
• Permissions granulaires (mode avance)
• Suivi de la methode d'adhesion (invitation, domaine, TVA, admin)

mpr_company_address - Adresses d'entreprise partagees mpr_company_invite - Invitations d'entreprise par email

Tables de devis/RFQ

mprexpresscheckout_quote - Gestion des devis

• Associations client et boutique
• Totaux de prix (produits, livraison, remises, taxes)
• Dates de validite et tokens de lien de paiement
• Suivi du statut et conversion en commande
• Historique des messages admin/client

mprexpresscheckout_quote_item - Lignes de devis

• References produit avec attributs
• Prix personnalise (prix original vs. prix devis)
• Suivi des quantites et remises
• Taux et montant de taxe

mprexpresscheckout_quote_status - Statuts du workflow de devis

• Nom du statut et code couleur
• Libelles multilingues via la table _lang
• Indicateurs systeme pour les statuts integres
• Ordre de position

mprexpresscheckout_quote_message - Communication de devis

• Messages client et admin
• Horodatages et statut de lecture
• Attribution employee pour les messages admin

mprexpresscheckout_quote_history - Piste d'audit des devis

• Suivi des changements de statut
• Attribution employee
• Journalisation des horodatages

Developpement

Prerequis

Le module necessite un environnement de developpement Docker. Voir CLAUDE.md a la racine du depot pour la configuration complete.

Outils requis:

• PHP 8.4.11 (via Docker dev-tools container)
• Node.js 20.19.2
• npm 9.2.0
• Composer 2.8.12

Commandes de build

Toutes les commandes doivent etre executees via le conteneur Docker:

# Navigate to module directory
cd /mnt/hdd/docker/ps178-mprexpresscheckout/html/modules/mprexpresscheckout

# Install PHP dependencies
sudo docker exec -w "$PWD" dev-tools composer install

# Install Node.js dependencies
sudo docker exec -w "$PWD" dev-tools npm install

# Build all assets (JavaScript + CSS)
sudo docker exec -w "$PWD" dev-tools npm run build

# Watch for changes during development
sudo docker exec -w "$PWD" dev-tools npm run watch

# JavaScript build only
sudo docker exec -w "$PWD" dev-tools npm run js:build
sudo docker exec -w "$PWD" dev-tools npm run js:watch

# Webpack build
sudo docker exec -w "$PWD" dev-tools npm run webpack:build
sudo docker exec -w "$PWD" dev-tools npm run webpack:watch

Systeme de build

Le module utilise un systeme de build hybride:

Gulp - Outil de build principal

• Compilation SCSS vers CSS
• Regroupement JavaScript avec Rollup
• Minification avec Terser
• Surveillance des fichiers source

Webpack - Bundler alternatif

• Regroupement de modules
• Decoupage du code
• Optimisation pour la production

Grunt - Empaquetage de release

• Creation d'archive ZIP pour la distribution

Fichiers source

JavaScript Sources: sources/js/

• Organises par fonctionnalite (checkout, paiement, social, etc.)
• Syntaxe ES6+ avec transpilation
• Compiled to views/js/

CSS Sources: sources/css/

• SCSS avec variables et mixins
• Structure basee sur les composants
• Compiled to views/css/

Qualite du code

# PHP syntax check
sudo docker exec -w "$PWD" dev-tools php -l file.php

# Check PHP version
sudo docker exec dev-tools php -v

# Check installed PHP modules
sudo docker exec dev-tools php -m

Configuration

Pages de configuration admin

Acces via le panneau d'administration PrestaShop sous Modules > Module Manager > MPR Express Checkout.

Onglets principaux:

1. Dashboard - Apercu des transactions et statistiques
2. Configuration - Cles API Stripe, parametres des methodes de paiement, themes d'icones
3. Transactions - Toutes les transactions de paiement avec filtres
4. Charges - Details des charges Stripe et frais
5. Refunds - Interface de gestion des remboursements
6. Payment Options - Activer/desactiver les methodes, definir les restrictions
7. Payment Methods - Methodes de paiement sauvegardees par le client
8. Social Customers - Inscriptions via social login
9. Carts - Sessions de panier checkout express
10. Sessions - Suivi du trafic et de l'attribution
11. Shipping Services - Configuration des transporteurs
12. Quotes - Gestion et creation des devis
13. Quote Statuses - Personnaliser les statuts du workflow de devis
14. Integrity - Verifications de sante du systeme

Configuration des methodes de paiement

Chaque methode de paiement peut etre configuree avec:

• Statut Active/Desactive
• Restrictions par pays (pays specifiques uniquement)
• Restrictions par devise (devises supportees uniquement)
• Restrictions par navigateur (ex: Apple Pay necessite Safari)
• Restrictions par type de page (produit, panier, checkout)
• Contexte boutique/langue/groupe (support multistore)

Parametres de theme d'icones

Configurer dans l'onglet Configuration:

• Theme d'icones: Light Mode, Dark Mode, Light Accent, Dark Accent
• Mode d'affichage des cartes: Icone de carte generique OU icones de marques individuelles
• Marques de cartes: Selectionner les marques a afficher (Visa, Mastercard, Amex, JCB, Cartes Bancaires)

Parametres Stripe

Configuration requise:

• Test Mode API Key (Publishable & Secret)
• Live Mode API Key (Publishable & Secret)
• Webhook Secret (pour les mises a jour du statut de paiement)
• Basculement de mode (Test/Live)

Parametres Social Login

Configurer les identifiants OAuth pour:

• Google - Client ID and Client Secret
• Facebook - App ID and App Secret
• Apple - Service ID, Team ID, Key ID, Private Key
• Microsoft - Client ID and Client Secret

Google Places API

Pour l'autocompletion d'adresse:

• API Key - Google Maps JavaScript API avec la bibliotheque Places activee

Controleurs Frontend

Le module fournit 16 controleurs frontend accessibles via les liens du module:

Controleurs du flux de checkout

Checkout.php - Modal de checkout unifie principal

• Affiche la selection des methodes de paiement
• Gere l'authentification client
• Gere les formulaires d'adresse
• Selection de la methode de livraison
• Revue et confirmation de commande

Processing.php - Gestionnaire de traitement de paiement

• Confirmation du Payment Intent Stripe
• Creation de commande apres paiement reussi
• Redirection vers la confirmation de commande

PaymentStatus.php - Page de resultat de paiement

• Messages de succes/echec
• Affichage des details de commande
• Gestion des erreurs

Controleurs de gestion des clients

Login.php - Connexion client

• Authentification email/mot de passe
• Integration social login
• Fonctionnalite rester connecte

Register.php - Inscription client

• Formulaire de creation de compte
• Inscription sociale
• Verification email

ForgotPassword.php - Recuperation de mot de passe

• Reinitialisation de mot de passe par email
• Generation de code de securite

Account.php - Apercu du compte client Identity.php - Gestion des informations personnelles

Controleurs de gestion des adresses

Address.php - CRUD d'adresse unique

• Ajouter une nouvelle adresse
• Modifier une adresse existante
• Supprimer une adresse
• Integration autocompletion Google Places

Addresses.php - Liste du carnet d'adresses

• Voir toutes les adresses
• Definir les adresses par defaut
• Actions rapides

Controleurs de paiement et panier

Cards.php - Methodes de paiement sauvegardees

• Lister les cartes stockees
• Supprimer les methodes de paiement
• Definir la carte par defaut

Cart.php - Gestion du panier

• Voir le contenu du panier
• Mettre a jour les quantites
• Appliquer les bons

Recover.php - Recuperation du panier

• Recuperer les paniers abandonnes via lien email
• Restaurer la session du panier
• Continuer vers le checkout

Controleurs de devis

Quotes.php - Liste des devis client

• Voir tous les devis avec filtrage par statut
• Pagination et tri
• Actions rapides (voir, telecharger PDF)

Quote.php - Vue detail d'un devis

• Articles du devis avec prix
• Affichage du statut et de la validite
• Actions accepter/rejeter le devis
• Fonctionnalite de demande de modifications
• Messagerie avec l'admin
• Acces au lien de paiement

QuoteRequest.php - Formulaire de demande de devis

• Demander un devis pour un seul produit
• Demander un devis pour tout le panier
• Support pour les clients invites et connectes
• Message personnalise a l'admin

QuotePdf.php - Telechargement PDF du devis

• Generer des devis PDF professionnels
• Telechargement cote client
• Validation securisee par token

Controleurs API

Ajax.php - Gestionnaire de point de terminaison AJAX

• Validation d'adresse
• Calcul des frais de livraison
• Validation de bon
• Listes pays/regions
• Verifications de disponibilite produit

Webhook.php - Recepteur webhook Stripe

• Mises a jour Payment Intent
• Evenements Charge reussi/echoue
• Notifications de remboursement
• Mises a jour automatiques du statut de commande

Controleurs Admin

16 controleurs backend gerent toutes les fonctions administratives:

AdminMPRExpressCheckoutDashboardController - Dashboard principal avec KPIs

AdminMPRExpressCheckoutConfigController - Interface de configuration du module

AdminMPRExpressCheckoutTransactionsController - Liste et details des transactions

• Filtrer par statut, date, montant, client
• Export en CSV
• Voir la chronologie des transactions

AdminMPRExpressCheckoutChargesController - Details des charges

• Payment Intent et Charge IDs
• Ventilation des frais
• Scores de risque
• Liens de recus

AdminMPRExpressCheckoutRefundsController - Gestion des remboursements

• Initier des remboursements complets/partiels
• Voir l'historique des remboursements
• Suivre le statut de remboursement

AdminMPRExpressCheckoutPaymentOptionsController - Parametres des methodes de paiement

• Activer/desactiver les methodes
• Definir les restrictions par pays/devise
• Configurer les regles de contexte
• Reordonner les positions d'affichage

AdminMPRExpressCheckoutPaymentMethodsController - Cartes sauvegardees des clients

• Voir toutes les methodes de paiement stockees
• Supprimer les methodes de paiement
• Association client

AdminMPRExpressCheckoutSocialCustomersController - Suivi des social login

• Voir les inscriptions sociales
• Statistiques de plateforme
• Historique de connexion

AdminMPRExpressCheckoutCartsController - Sessions de checkout express

• Voir les paniers virtuels
• Statut de recuperation du panier
• Correspondance client
• Gestion des expirations

AdminMPRExpressCheckoutSessionsController - Analyse du trafic

• Suivi des sessions
• Donnees de campagne UTM
• Analyse des pages d'atterrissage
• Statistiques appareil/navigateur

AdminMPRExpressCheckoutShippingServiceController - Configuration du transporteur

• Definir les delais de transit
• Configurer les modes d'affichage
• Payment method restrictions
• Integration de modules externes

AdminMPRExpressCheckoutQuotesController - Gestion des devis

• Voir et filtrer tous les devis
• Creer des devis depuis l'admin
• Modifier les articles et prix des devis
• Envoyer des devis aux clients
• Convertir les devis en commandes
• Generer des liens de paiement
• Contacter les clients
• Voir l'historique des devis

AdminMPRExpressCheckoutQuoteStatusesController - Gestion des statuts de devis

• Creer des statuts personnalises
• Modifier les couleurs et libelles des statuts
• Noms de statut multilingues
• Reordonner l'affichage des statuts

AdminMPRExpressCheckoutIntegrityController - Verifications de sante du systeme

• Validation de l'integrite de la base de donnees
• Validation de la configuration
• Verifications de l'integrite des fichiers
• Verification des dependances

AdminMPRExpressCheckoutAjaxController - Point de terminaison AJAX admin

• Mises a jour dynamiques des formulaires
• Suggestions d'autocompletion
• Actions rapides

Points d'integration

PrestaShop Hooks

Le module s'integre a plusieurs points du cycle de vie PrestaShop:

Hooks page produit:

• displayProductAdditionalInfo - Bouton checkout express sur les pages produit
• displayProductActions - Placement alternatif du bouton

Hooks panier:

• displayShoppingCart - Checkout express dans le panier
• displayShoppingCartFooter - Boutons en pied de panier

Hooks checkout:

• displayPaymentReturn - Messages de confirmation de commande
• paymentOptions - Ajouter des methodes de paiement au checkout
• displayOrderConfirmation - Actions post-commande

Hooks client:

• actionAuthentication - Actions post-connexion
• actionCustomerAccountAdd - Actions post-inscription
• actionObjectCustomerUpdateAfter - Synchronisation des donnees client

Hooks commande:

• actionValidateOrder - Suivi de creation de commande
• actionOrderStatusUpdate - Synchroniser le statut de commande avec Stripe
• displayAdminOrder - Ajouts sur la page commande admin

Hooks Header/Footer:

• displayHeader - Charger Stripe.js et les assets du module
• displayFooter - Initialiser les scripts de checkout

Integrations API externes

Stripe API

• API Payment Intents pour le traitement des paiements
• API Customers pour les methodes de paiement sauvegardees
• API Charges pour les details de transaction
• API Refunds pour le traitement des remboursements
• Webhooks pour les mises a jour en temps reel

Google APIs

• Google Sign-In pour l'authentification OAuth
• Google Places API pour l'autocompletion d'adresse

Facebook API

• Facebook Login pour l'authentification OAuth
• Graph API pour les donnees du profil utilisateur

Apple Sign In

• Sign in with Apple pour les utilisateurs iOS/macOS
• Validation de token JWT

Microsoft Identity Platform

• Authentification de compte Microsoft
• Integration Azure AD

VIES API

• Validation de numero de TVA UE
• Verification d'entreprise

Systeme de devis/RFQ

Le module comprend un systeme complet de devis/demande de devis (RFQ) pour le commerce B2B, permettant aux clients de demander des prix personnalises et aux admins de creer des offres sur mesure.

Workflow de devis

Cycle de vie des statuts:

1. Pending - Demande de devis initiale du client
2. Draft - L'admin prepare le devis
3. Sent - Devis envoye au client pour examen
4. Negotiating - Le client a demande des modifications, discussion en cours
5. Accepted - Le client a accepte le devis
6. Rejected - Le client a refuse le devis
7. Expired - Periode de validite du devis expiree
8. Converted - Devis converti en commande
9. Cancelled - Devis annule par l'admin

Fonctionnalites client

Demande de devis:

• Demander des devis depuis les pages produit via le bouton "Demander un devis"
• Demander des devis pour tout le contenu du panier
• Ajouter des messages personnalises expliquant les besoins
• Demandes de devis invite (si active)

Gestion des devis:

• Voir tous les devis dans la section "Mes devis" du compte client
• Voir le badge de compteur de devis en attente
• Voir le devis detaille avec prix detailles
• Accepter ou rejeter les devis en un clic
• Demander des modifications avec message explicatif
• Contacter l'admin directement sur la page detail du devis
• Telecharger la version PDF des devis
• Acceder au lien de paiement pour les devis acceptes

Fonctionnalites admin

Creation de devis:

• Creer des devis depuis le panneau admin
• Importer des produits depuis un panier ou commande existant
• Ajouter des produits avec prix personnalises
• Definir des remises au niveau de l'article
• Configurer les frais de livraison
• Definir la periode de validite du devis

Gestion des devis:

• Voir tous les devis avec filtrage avance
• Modifier les articles et prix du devis a tout moment
• Envoyer des devis aux clients
• Generer des liens de paiement securises
• Voir et repondre aux messages des clients
• Suivre l'historique complet du devis (changements de statut, messages)
• Convertir les devis acceptes en commandes

Statuts de devis:

• 9 statuts integres avec couleurs
• Creer des statuts personnalises
• Libelles de statut multilingues
• Reordonner l'affichage des statuts

Generation de PDF

Les devis PDF professionnels incluent:

• Logo et marque de l'entreprise
• Reference et dates du devis
• Adresses de facturation/livraison du client
• Liste detaillee des produits avec images
• Prix individuels et totaux
• Conditions generales
• Periode de validite
• Texte de pied de page personnalise

Options de configuration

• Activer/desactiver le systeme de devis globalement
• Afficher/masquer le bouton "Demander un devis" sur les pages produit
• Afficher/masquer le bouton "Demander un devis" dans le panier
• Autoriser les demandes de devis invite
• Periode de validite par defaut du devis
• Personnalisation PDF (logo, conditions, pied de page)
• Notifications email pour les evenements de devis

Hooks

Hooks produit/panier:

• displayQuoteButtonProduct - "Request Quote" button on product pages
• displayShoppingCartFooter - "Request Quote" button in cart

Compte client:

• displayCustomerAccount - "My Quotes" link with pending badge

Feuille de route future

Fonctionnalites prevues

Extension des methodes de paiement

• Methodes de paiement regionales supplementaires
• Support des cryptomonnaies (Bitcoin, Ethereum)
• Passerelles de paiement locales au-dela de Stripe

Fonctionnalites B2B ameliorees

• Quote request system ✅ Implemented
• Workflows d'approbation pour les achats entreprise
• Prix personnalises par entreprise/client
• Automatisation des remises par volume
• Application des limites de credit

Recuperation avancee du panier

• Sequences email multi-etapes
• Recuperation de panier par SMS
• Notifications push pour les paniers abandonnes
• Offres de remise dynamiques dans les emails de recuperation

Analyse et reporting

• Analyse du tunnel de conversion
• Comparaison des performances des methodes de paiement
• Cartographie geographique des ventes
• Suivi de la valeur vie client
• Framework de tests A/B pour les variations de checkout

Abonnements et paiements recurrents

• Support des produits d'abonnement
• Facturation recurrente automatique
• Portail de gestion des abonnements
• Gestion de la periode d'essai

Ameliorations multi-devises

• Conversion dynamique de devise au checkout
• Afficher les prix dans la devise locale du client
• Methodes de paiement sauvegardees multi-devises

Integration application mobile

• SDK mobile natif
• Traitement des paiements in-app
• Extension de l'integration des portefeuilles mobiles

Fonctionnalites alimentees par l'IA

• Detection de fraude par apprentissage automatique
• Prevention predictive de l'abandon de panier
• Recommandations intelligentes de methodes de paiement
• Experiences de checkout personnalisees

Optimisations de performance

• Service worker pour la gestion hors ligne du panier
• Checkout en application web progressive (PWA)
• Chargement paresseux des scripts de methodes de paiement
• Integration CDN pour les assets statiques

Conformite et securite

• PSD2 Strong Customer Authentication (SCA)
• Outils d'export/suppression de donnees RGPD
• Reporting de conformite SOC 2
• Regles de prevention de fraude ameliorees

Outils developpeur

Suite de tests

• Tests unitaires pour toutes les classes
• Tests d'integration pour les flux de paiement
• Tests end-to-end avec Puppeteer
• Outils de benchmarking de performance

API & Webhooks

• Public API for headless commerce
• Custom webhook events
• GraphQL API support

Documentation

• Documentation API developpeur
• Guides d'integration pour modules tiers
• Guide de personnalisation de theme
• Tutoriels video

Support et ressources

Documentation: /docs/ directory License: Commercial - restricted domains only Author: mypresta.rocks (info@mypresta.rocks) Repository: https://github.com/myprestarocks/mprexpresscheckout

Specifications techniques

PHP Requirements: 7.1.3+ (Tested with PHP 8.4.11) PrestaShop Version: 1.6 - 1.7.8.11+ Database: MySQL 5.5+ / MariaDB Dependances externes:

• Stripe PHP SDK (via Composer)
• Firebase JWT (pour la validation des tokens social login)
• Google Closure Compiler (dependance de dev)
• Webpack, Gulp, Grunt (dependances de dev)

Support navigateur:

• Chrome 90+ (Google Pay, Samsung Pay)
• Safari 14+ (Apple Pay)
• Firefox 88+
• Edge 90+
• Navigateurs mobiles (iOS Safari 14+, Chrome Mobile 90+)

Taille du module:

• Total de lignes de code: 35 000+ (classes PHP, controleurs, templates)
• Classes principales: 30+ (28 000+ lignes)
• Controleurs: 36 (20 frontend + 16 admin)
• Tables de base de donnees: 34
• SVG Icons: 248
• Langues supportees: 7

Licence

Ceci est un module commercial licence pour une utilisation sur des domaines restreints uniquement. L'utilisation, la distribution ou la modification non autorisee est interdite.

Copyright (c) mypresta.rocks - Tous droits reserves.