ProDon:Intégration aux formulaires de dons en ligne

Intégration aux formulaires de dons en ligne

Version imprimable

---

ATTENTION : Ce document est conçu uniquement pour la VERSION 5.0.3.x de ProDon. Pour accéder au document de la version 5.0.2.x, cliquer ici. Pour accéder au document de la version 4.7.3.x, cliquer ici.

ATTENTION! CE DOCUMENT EST INCOMPLET, NE PAS UTILISER.

Définition des 3 méthodes d’intégration possibles

1. Lien

La méthode d’intégration la plus simple vous permettant d’orienter vos donateurs sur vos formulaires de dons en ligne.

Utilisations typiques :

• Intégration à votre site web
• Envoi d’un lien par courriel

Particularités :

• Possibilité d’accéder à la liste de vos formulaires, ou d’accéder directement à un formulaire.
• Pas de programmation requise (ajout d’un hyperlien uniquement)

2. Lien avec envoi d’informations

Une intégration plus avancée permettant de préremplir un formulaire.

Utilisations typiques :

• Intégration à partir d’un microsite
  • Inscription d’équipes / participants
  • Don à une équipe/participant
  • Campagnes virales
• Intégration à partir d’un organisme tiers
  • Firme de télémarketing
  • Firme de développement web
• Intégration à partir d’un système tiers
  • Système maison (gestion de membres, finissants, …)

Particularités :

• Programmation requise (exemples fournis)
• Intégration simple par paramètres GET (crypté) ou par paramètres POST
• Possibilité d’envoyer les informations au formulaire afin de le remplir :
  • Informations nominatives
  • Informations sur la transaction (à l’exception des informations de cartes de crédit)
  • Informations personnalisées du formulaire (ex : nom/ID d’équipe, questions spécifiques, etc.)

3. Lien avec envoi d’informations et récupération de la transaction

Cette intégration inclut les possibilités du « lien avec envoi d’informations » (voir méthode 2) tout en permettant de récupérer la transaction complétée.

Utilisations typiques :

• Intégration à partir d’un microsite en permettant la gestion d’un ou des objectifs
• Permettre au microsite ou à l’organisme tiers de suivre en temps réel la progression des dons

Particularités :

• Programmation requise (exemples fournis)
• Programmation additionnelle requise pour le post-traitement (afin de recevoir les informations de la transaction en format XML)

Explications techniques

1. Lien

Format du lien :

https://www.jedonneenligne.org ou https://www.imakeanonlinedonation.org /REP_ORG[_test] /REP_ORG[_test]/FORM 

Définition :

• REP_ORG : Répertoire de l’organisme sur JeDonneEnLigne ou IMakeAnOnlineDonation
• /REP_ORG : liste des formulaires
• [_test] : Mode test actif (non spécifié = mode production)
• /REP_ORG/FORM : Code du formulaire à appeler

Exemples de liens :

• Liste des formulaires : https://www.jedonneenligne.org/logilys

• Formulaire GEN : https://www.jedonneenligne.org/logilys/GEN
• Formulaire GEN (mode test) : https://www.jedonneenligne.org/logilys_test/GEN

2. Lien avec envoi d’informations

Ce type d’intégration nécessite des capacités de programmation.

• Prototype pour ProDon 5.0.3.x (version 2.1 du site JeDonneEnLigne) :
  • https://www.jedonneenligne.org/tools/integration_prototype/v2.1/integration_prototype.php
  • Téléchargement des sources: https://www.jedonneenligne.org/tools/integration_prototype/v2.1/integration_prototype.zip

Voici la liste des paramètres possibles dans le prototype :

• Clé : Clé de cryptage unique par organisme. Cette clé est générée par Logilys à la demande de l’organisme puis envoyée à l’intégrateur (s’il y a lieu).

• Répertoire : Répertoire de l’organisme sur JeDonneEnLigne. Ajoutez « _test » pour activer le mode test.
• FrmUID : Numéro du formulaire à utiliser pour l’envoi d’informations.
• Informations nominatives démontrées en exemple : Pays, Appellation, Prénom, Nom, Adresse, Ville, Province (FrmProvinceUID), Code Postal, Email, Téléphone résidence.
• Informations sur la transaction démontrées en exemple : Montant, Activité (FrmActUID), Mode de paiement (FrmPaiUID) et Reçu (FrmReceipt).
• Les paramètres « UID » de FrmCountryUID (liste des pays) et FrmProvinceUID (liste des provinces) sont globaux, ils peuvent être facilement trouvés en inspectant le code source du formulaire.
• Les autres paramètres « UID » sont spécifiques au formulaire, ils peuvent être facilement trouvés en inspectant le code source du formulaire.

Vous pouvez aussi télécharger les sources complètes du prototype en cliquant sur « download sources ». Voici le contenu du fichier zip :

• integration_prototype.php : le code source du prototype
• integration_js_prototype.php : autre exemple, mais en java script
  • encode64.js, mcrypt.js, rijndael.js : utilisé par integration_js_prototype.php
• parameters.xls : descriptions sommaires des paramètres possibles.
• callback.php, callback.txt : exemple de code afin de récupérer la transaction (voir point 3).

3. Lien avec envoi d’informations et récupération de la transaction (URL de post-traitement)

Voir au préalable les explications techniques du « lien avec envoi d’informations ». Cette intégration permet de récupérer la transaction par la suite.

Les informations sur la transaction vous seront transmises (POST) en format XML sur l’URL de votre choix (configuré dans ProDon, voir ici-bas).

Configuration d'un URL de post-traitement dans ProDon

Pour configurer votre URL de post-traitement, à partir de la fiche de modification d'un formulaire Web avec ProDon, allez dans "Options avancées", "Intégration à JDEL" puis "Configuration de l'adresse URL pour l'intégration post-traitement".

Paramètre additionnel entrant (facultatif) à passer lors de l’appel au formulaire :

• PersonalId (non crypté) : Identifiant unique pour votre transaction, exemple : &PersonalId=00000001 (non crypté).

Paramètres sortants envoyés sur l'URL de post-traitement :

• trx_xml (crypté) : xml de la transaction. Voir le fichier « callback return xml example.txt » dans les sources du prototype pour un exemple
• mode (non crypté) : Contient « TEST » ou « PROD » selon si la transaction a été effectuée en mode test ou production
• PersonalId (non crypté) : Votre identifiant unique.
• Attention : L'appel est effectué avec le « UserAgent » suivant : Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:40.0) Gecko/20100101 Firefox/40.1.0 Waterfox/40.1.0.

Mise à jour à partir de ProDon 5.0.2.x

Si vous avez déjà une intégration fonctionnelle avec ProDon 5.0.2.x, veuillez prendre connaissances des changements à effectuer :

1. La clé de cryptage pour l'intégration est maintenant configurable dans ProDon. Allez dans "Gestion des formulaires Web" / "Configurer votre site Web" / "Accès JeDonneEnLigne" / "Clé de cryptage". Si vous aviez déjà une clé de cryptage, vous la verrez à cet endroit, sinon il vous sera possible d'en générer une.
2. Attention, le paramètre PersonalUrl n'existe plus, pour configurer un URL de post-traitement, vous devez avoir une clé de cryptage (tel qu'expliqué ci-dessus), et vous devez configurer votre URL dans le ou les formulaires en question. À partir de la fiche de modification d'un formulaire Web avec ProDon, allez dans "Options avancées", "Intégration à JDEL" puis "Configuration de l'adresse URL pour l'intégration post-traitement"
3. Attention, avec ProDon 5.0.2.x, le UserAgent était vide, mais maintenant nous utilisons le UserAgent suivant lors du POST sur l'URL de post-traitement : Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:40.0) Gecko/20100101 Firefox/40.1.0 Waterfox/40.1.0.

---

Nom du document : ProDon:Intégration aux formulaires de dons en ligne

Version imprimable