Synchroniser vos formulaires web externes (WordPress, WPForms, Fluent Forms) avec Qomon via Stripe

Si vous utilisez des formulaires externes sur votre site web (comme WPForms, Fluent Forms ou d'autres plugins WordPress) pour collecter des adhésions ou des dons directement via votre compte Stripe connecté, vous avez peut-être remarqué que ces transactions n'apparaissent pas automatiquement dans Qomon.

Cela se produit parce que Qomon a besoin d'un identifiant spécifique pour savoir quel type de contact, d'adhésion ou de don est en train d'être traité.

Pourquoi mes paiements externes n'apparaissent-ils pas dans Qomon ?

Quand un contact paie via une page native de Qomon, notre outil gère tout en arrière-plan. En revanche, lorsqu'un paiement est généré directement sur votre site web via un plugin externe, il crée une intention de paiement (Payment Intent) directe dans Stripe, sans abonnement ni facture Stripe classique.

Pour que Qomon puisse importer automatiquement ces paiements directs, notre moteur de synchronisation analyse les métadonnées (Metadata) associées à la transaction Stripe.

La Règle : Qomon requiert une clé nommée qomon_price_id (ou price_id) dans les métadonnées du paiement Stripe. Si cette clé est manquante, Qomon ne sait pas comment catégoriser la transaction (par exemple, s'il s'agit d'une adhésion annuelle ou d'un don unique) et ignorera le paiement.

Ce que vous devez faire

Pour corriger cela de manière définitive, vous devez configurer le plugin de formulaire de votre site web pour qu'il injecte le qomon_price_id dans Stripe au moment précis où le paiement est créé.

Votre formulaire envoie probablement déjà des métadonnées par défaut à Stripe, qui ressemblent à ceci :

JSON

{   "form_id": "5",   "form_title": "Annual Membership",   "submission_id": "894",   "wp_plugin": "Fluent Forms Pro" }

Pour que cela fonctionne avec Qomon, vous devez ajouter une paire clé-valeur personnalisée supplémentaire dans ce même bloc, au sein des paramètres de votre formulaire :

Clé (Key) : qomon_price_id
Valeur (Value) : [Votre ID de prix Qomon spécifique]

Votre bloc de métadonnées final devrait ressembler à ceci :

JSON

{   "qomon_price_id": "votre_id_de_prix_d_adhesion_ici",   "form_id": "5",   "form_title": "Annual Membership",   "submission_id": "894",   "wp_plugin": "Fluent Forms Pro" }

Erreurs courantes à éviter

N'ajoutez pas les métadonnées aux "Produits" Stripe : Ajouter des métadonnées à un "Produit" dans votre tableau de bord Stripe ne se répercute pas sur les intentions de paiement (Payment Intents) individuelles. Cela ne déclenchera pas la synchronisation.
Ne comptez pas sur l'ajout manuel après coup : Mettre à jour manuellement les métadonnées d'un paiement après qu'il a déjà été traité ne le poussera pas automatiquement vers Qomon. En effet, le moteur de synchronisation détecte principalement l'événement de création initiale du paiement.

Comment configurer la synchronisation (Étape par étape)

Étape 1 : Récupérer votre ID de prix Qomon (Price ID)

Connectez-vous à votre espace Qomon ou contactez votre CSM Qomon pour obtenir la chaîne exacte du qomon_price_id correspondant au niveau d'adhésion ou de don que vous souhaitez suivre (ex: membership_simple, open_donation, ou une chaîne de prix API spécifique à Stripe).

Étape 2 : Configurer le plugin de formulaire de votre site

Allez sur le back-office de votre site (ex: WordPress), ouvrez les paramètres de votre formulaire (WPForms, Fluent Forms, etc.), et accédez à l'onglet des paramètres d'intégration Stripe / Paiement. (Note : Il ne s'agit pas forcément de WordPress. Il peut s'agir d'un serveur web personnalisé qui appelle directement Stripe ou de bien d'autres configurations).

Étape 3 : Associer les métadonnées personnalisées

Trouvez la section "Metadata" dans les paramètres Stripe de votre formulaire. Ajoutez un nouveau champ personnalisé. Définissez la clé méta sur qomon_price_id et collez votre ID de prix Qomon spécifique dans le champ de valeur. Enregistrez les modifications de votre formulaire.

Étape 4 : Corriger les anciens paiements manquants (Optionnel)

Si vous avez des transactions passées qui ne se sont pas synchronisées, connectez-vous à votre tableau de bord Stripe, ouvrez ces paiements spécifiques, et ajoutez manuellement la clé de métadonnée qomon_price_id avec sa valeur correcte.

Note sur les dons : Si vous traitez des dons récurrents mensuels standard ou des liens de dons Stripe natifs directement via des abonnements Stripe, ceux-ci correspondent généralement automatiquement grâce à leurs ID de prix Stripe internes et ne nécessitent pas de configuration manuelle des métadonnées du formulaire web.

Besoin d'actualiser vos données historiques ?

Une fois que vous aurez ajouté avec succès les métadonnées aux paiements passés dans votre tableau de bord Stripe, ceux-ci ne se synchroniseront pas immédiatement de manière automatique.

Veuillez envoyer un court message au support Qomon :

"Nous avons mis à jour les métadonnées de nos paiements de formulaires web manquants, merci de déclencher une synchronisation historique de Stripe pour nous."

Notre équipe lancera alors une boucle de synchronisation manuelle pour importer ces contacts et transactions directement dans votre base de données !

Stripe et Formulaires Externes