Prérequis
- Clé API SignCloud (Compte → API & Webhooks).
- PrestaShop 1.7 → 8.x, boutique en HTTPS publique.
Installation & mise en route (3 étapes)
- Modules → Téléverser un module → sélectionnez le .zip → installez.
- Collez votre clé API puis cliquez Tester la connexion, puis Configurer le webhook. (La clé est conservée : une fois enregistrée, le champ reste vide mais la clé est bien mémorisée — laissez-le vide pour la garder.)
- Choisissez le Contrat à faire signer et Quand faire signer ? (Avant le paiement, Pendant = commande retenue jusqu'à signature, ou Après la commande). Enregistrez. C'est tout — le reste est en « Réglages avancés » avec des valeurs par défaut.
Choisir le contrat à faire signer
Nouveau (v1.1) : le menu « Contrat à faire signer » liste automatiquement vos modèles SignCloud (formulaires à variables et PDF pré-balisés). Sélectionnez celui que vos clients doivent signer — CGV, NDA, mandat, contrat particulier — il est pré-rempli avec les données de la commande. Créez vos modèles dans SignCloud → Modèles / Formulaires. Laissez « HTML personnalisé » pour saisir votre propre contenu.
Balises reconnues (au choix, FR ou EN) : [NOM]/[NAME], [EMAIL], [SOCIETE]/[COMPANY], [COMMANDE]/[ORDER], [MONTANT]/[AMOUNT], [ARTICLES]/[ITEMS], [ADRESSE], [VILLE], [BOUTIQUE]/[SHOP], [DATE]…
Signer AVANT le paiement (comme des CGV)
Nouveau (v1.3) : activez « Bloquer le paiement tant que non signé » et choisissez un contrat d'entrée (générique : CGV, NDA…). Quand le client clique sur « Commander », il est envoyé sur une page dédiée où il doit signer avant d'accéder au paiement — impossible de valider la commande sans signer. Comme le contrat est générique, il n'a pas besoin des données de la commande.
Signé une seule fois, il reste valable la durée choisie (ex. 12 mois) ; ensuite une nouvelle signature est demandée automatiquement. Nécessite une adresse client avec mobile (vérification SMS).
Où placer la signature dans le tunnel
Réglez le statut déclencheur (quand envoyer) puis le Déroulé :
- Après paiement — la commande suit son cours normal, le contrat part à signer en parallèle.
- Bloquant — la commande est retenue au statut « En attente de signature » (non préparée, non facturée) et n'avance vers le statut après signature qu'une fois le contrat signé. Idéal pour faire signer avant de préparer ou d'expédier.
Faire signer à la création du compte
Nouveau (v1.1) : activez « Signature à la création du compte » et choisissez un modèle (ex. accord de confidentialité). Dès qu'un nouveau client enregistre sa première adresse (le moment où son mobile est disponible pour la vérification SMS), le contrat lui est envoyé — sans commande. Un seul envoi par client (anti-doublon).
Où le client voit-il la signature ?
La signature est proposée à plusieurs endroits, pour ne jamais être manquée :
- E-mail + SMS — le client reçoit le lien de signature (canal principal).
- Dans le tunnel (mode bloquant) — un bandeau au-dessus du paiement prévient qu'une signature sera requise.
- Page de confirmation — un encadré « Signer maintenant » (obligatoire et proéminent en mode bloquant).
- Espace client — un rappel « contrat à signer » reste visible tant que ce n'est pas fait, plus l'encadré sur le détail de chaque commande.
Note : le contrat étant pré-rempli avec les données de la commande, il est envoyé juste après la validation ; en mode bloquant, la commande reste gelée (« En attente de signature ») jusqu'à la signature — elle ne peut donc pas être traitée sans signer.
Fonctionnement
Un contrat pré-rempli est envoyé à signer au moment choisi. La fiche commande (admin) affiche le statut, le lien de signature, le PDF signé et un bouton Relancer.
Endpoint webhook : index.php?fc=module&module=signcloud&controller=webhook.
Dépannage
- Le signataire doit avoir un e-mail et un mobile (adresse de facturation, ou première adresse pour la signature « compte »).
- Vos modèles n'apparaissent pas dans le menu ? Enregistrez d'abord une clé API valide, testez la connexion, puis rouvrez la configuration.
- Signature HMAC vérifiée : le secret doit être renseigné (bouton Configurer le webhook).
Changelog
- 1.14.0 — Conservation 10/20/50 ans, vérification renforcée et créations idempotentes avec reprise réseau.
- 1.8.0 — Infos légales du vendeur pour les CGV : [NOM DE LA SOCIÉTÉ] et [ADRESSE DE LA SOCIÉTÉ] récupérées automatiquement depuis la boutique ; [RCS], [SIRET], [TVA], [CAPITAL], [REPRÉSENTANT LÉGAL], [QUALITÉ] saisissables en back-office. Alias « société du client » ajoutés.
- 1.7.2 — Remplissage des balises en « langage naturel » ([NOM DE LA BOUTIQUE], [URL DU SITE], [NOM DU CLIENT]…) et tolérance espaces/underscores/accents ([CODE POSTAL] = [CODE_POSTAL]). Fini les crochets non remplacés dans les CGV.
- 1.7.1 — Mode « avant » : la commande n'est plus figée « en cours » — au paiement, si le contrat d'entrée est signé, elle passe au statut « Après signature » choisi et reçoit une note.
- 1.7.0 — Noms de documents personnalisables (balises {ref}/{customer}/{shop}/{date}) ; le contrat « création de compte » n'affiche plus l'ID brut. Nouvelles balises
[URL_SITE] / [SITE_URL]. Contrats signés téléchargeables dans l'espace client (« Mes contrats signés » + PDF sur le détail commande). - 1.6.0 — Mobile rendu obligatoire dans le tunnel quand le mode « avant » est actif (en plus du garde-fou sur la page de signature) pour garantir la vérification SMS. Rappel : les modèles « formulaire » se pré-remplissent automatiquement (nom, adresse…), les « PDF » sont envoyés tels quels.
- 1.5.0 — Option « Désactivé » dans « Quand faire signer ? » (activer/couper facilement). Distinction claire modèle formulaire (pré-rempli) vs PDF (envoyé tel quel).
- 1.4.0 — Configuration simplifiée : un seul choix « Quand faire signer ? » (avant / pendant / après), le reste en réglages avancés avec valeurs par défaut automatiques. Correctif : la clé API est désormais conservée à l'enregistrement (ne se vide plus). Retour automatique du client sur la boutique après signature (5 s).
- 1.3.0 — Contrat d'entrée de commande : signature obligatoire AVANT le paiement (comme des CGV), page de signature dédiée qui bloque l'accès au tunnel, valable une durée configurable (ex. 12 mois) puis re-signature. Champs de configuration élargis.
- 1.2.0 — Signature visible partout : bandeau dans le tunnel (au-dessus du paiement), encadré obligatoire sur la page de confirmation en mode bloquant, rappel persistant « contrat à signer » dans l'espace client et sur le détail de chaque commande.
- 1.1.0 — Choix d'un modèle SignCloud (formulaire ou PDF) avec pré-remplissage automatique et balises FR/EN ; réglage Déroulé « après paiement » / « bloquant » (nouveau statut « En attente de signature ») ; signature à la création du compte (déclenchée à la première adresse).
- 1.0.0 — Contrat automatique à la commande, suivi et PDF signé dans l'admin, webhook HMAC.