ProDon:Intégration Encan MaCause
Intégration Encan MaCause |
Sommaire
- 1 Introduction
- 2 Ce qu’il faut avoir avant de faire le formulaire :
- 3 Les formulaires
- 3.1 Formulaire web de don
- 3.2 Onglet « Configuration du formulaire »
- 3.3 Onglet « Paiements »
- 3.4 Onglet « Transaction »
- 3.5 Onglet « Engagement »
- 3.6 Onglet « Courriel »
- 3.7 Onglet « Groupes de questions »
- 3.8 Onglet « Notes »
- 3.9 Onglet « Liste de distribution »
- 3.10 Onglet « Partage sur les réseaux sociaux »
- 3.11 Onglet « Options avancées » / « Configuration »
- 3.12 Formulaire web de paiement des items achetés
- 3.13 Onglet « Configuration du formulaire »
- 3.14 Onglet « Transaction »
- 3.15 Onglet « Courriel »
- 3.16 Onglet « Groupes de questions »
- 4 Tests
- 5 Clé de cryptage
- 6 Activer l’intégration
Introduction
L’intégration avec MaCause.com, de Eclipse Solutions AV, permet l’utilisation de deux formulaires cachés afin d’accepter les dons via la plateforme MaCause et également le paiement des items achetés.
Ce qu’il faut avoir avant de faire le formulaire :
Occasion
Code : MACAUSE
Description: Encan MaCause
Activité de don
Code : DONMACAUSE
Description : Don
Type de transaction : Standard
Délivrer un reçu : Oui
Provenance : 1 - Don Configurer l'affectation comptable appropriée si désirée, dans l'onglet « Aff.compt. ».
Activité d'achat d'articles à l'encan
Code : ENCAN
Description : Articles achetés à l'Encan
Type de transaction : Standard
Délivrer un reçu : Oui (si vous désirez délivrer un reçu pour la portion admissible)
Provenance : 2 - Activité bénéfice
Configurer l'affectation comptable appropriée si désirée, dans l'onglet « Aff. compt. ».
Caractéristique
Caractéristique : Encan - Liste des items
Emplacement : Gestion des transactions
Type : Texte long
Cocher : Permettre une seule valeur par enregistrement
Cocher : Voir dans la grille de gestion
Configuration des libellés
Il est important de mettre le lien de retour en français et en anglais, car les pages d'encan et de don de MaCause sont utilisés dans les deux langues.
Ajout de groupes de libellés
Nom: DONMACAUSE
Utiliser ce groupe par défaut: Non
Modifier certains libellés
Faire une recherche sur le mot RETOUR.
Lien de retour Français: Retour à l'encan
Lien de retour Anglais: Back to the auction
Lien de retour (URL) Français: https://www.macause.com/#don
Lien de retour (URL) Anglais: https://www.mycause.bid/#don
Sauvegarder et mettre en production.
Ajouter un autre groupe de libellés
Dupliquer le groupe de libellés créé précédemment.
Nom: MACAUSE
Utiliser ce groupe par défaut : Non
Lien de retour (URL) Français: https://www.macause.com/#paye
Lien de retour (URL) Anglais: https://www.mycause.bid/#paye
Sauvegarder et mettre en production.
Les formulaires
Formulaire web de don
Code : DONMACAUSE
Langue Français: Coché
Langue Anglais: Coché
Nom du formulaire (visible pour le donateur) Français : Don
Nom du formulaire (visible pour le donateur) Anglais: Donation
Description du formulaire Français: Ce formulaire vous permet de faire un don avec macause.com
Description du formulaire Anglais: This form allows you to donate with mycause.bid
Onglet « Configuration du formulaire »
Date d’affichage du formulaire : Laisser vide
Date d'expiration du formulaire : Laisser vide
Back-office :
- Thème et groupe d’images : Au choix
- Groupe de libellés : DONMACAUSE
Page d'accueil :
- Groupe français : Laisser vide
- Groupe anglais : Laisser vide
Position de la section transaction : Avant la page des informations personnelles (recommandé)
Type de donateurs :
- Donateur personnel : Oui
- Donateur corporatif : Oui
Onglet « Paiements »
Il est recommandé de mettre les modes de paiements Carte de crédit et/ou Virement bancaire.
Onglet « Transaction »
Activer la section transaction : Oui
Occasion : Choisir l’occasion MACAUSE ou celle de votre événement préalablement créé.
Affichage des activités : Afficher un menu déroulant (1 choix d’activité)
Activité
Ajouter ou modifier l’activité DONMACAUSE / Don.
Activité : Choisir l'activité de don.
Libellé utilisé pour la description de l’activité sur les reçu don en ligne:
Français : Don
Anglais : Donation
Libellé utilisé devant le montant ou la quantité:
Français : Montant du don
Anglais : Donation amount
Afficher le montant autre : Oui
Délivrer un reçu pour : Personnel et corporatif
Reçu : Au choix
Montant minimum (Reçu) : Au choix
Utiliser les reçus Web lors d’un paiement instantané : Oui
Prendre en note le ID activité, pour mettre dans le courriel à envoyer à Éclipse
Onglet « Engagement »
Activer la section engagement : Non
Onglet « Courriel »
Vous pouvez laisser votre message standard ou l’adapter à l’événement si vous le souhaitez.
Onglet « Groupes de questions »
Il n’est pas recommandé d’en utiliser.
Onglet « Notes »
Ne conserver que les notes essentielles.
Onglet « Liste de distribution »
Au choix (si vous avez le module PubliCourriel)
Onglet « Partage sur les réseaux sociaux »
Avertissement : Il ne faut pas partager ce formulaire sur les réseaux sociaux.
Pour éviter le partage:
- Utiliser des réseaux sociaux différents de ceux de la page d’accueil : Oui (coché)
- Titre : Vide
- Description : Vide
- Réseaux sociaux : Tous décochés
Si vous n'utilisez pas les réseaux sociaux:
- Utiliser des réseaux sociaux différents de ceux de la page d’accueil : Non (décoché)
Onglet « Options avancées » / « Configuration »
Afficher sur la page d’accueil : Non
Donateur par défaut : Demander au donateur
Date de naissance : Ne pas afficher
Niveau de sécurité du captcha : « Modéré (Recommandé) »
Afficher le libellé OBNL : Oui
Utiliser le format d’adresse bloc libre : Oui
Courriel obligatoire : Oui
Confirmation du courriel : Non
Envoyer un courriel de confirmation : Oui
Afficher le commentaire : Non
Cacher la Logizone : Oui
Cacher les informations transactionnelles : Non
Téléphones :
- Mettre à « Afficher »;
- Donateur personnel: tél. mobile
- Donateur corporatif: tél. travail
Exiger au moins un téléphone : Oui
Une fois que le formulaire est terminé, il faut l'activer.
Formulaire web de paiement des items achetés
Il est préférable de dupliquer le formulaire DONMACAUSE et de simplement modifier les éléments suivants ou s'assurer que les informations soient les bonnes.
À noter : Si vous utilisez le mode de paiement Square ou autre lors de l'encan, vous devez tout de même créer ce formulaire, car le site MaCause.com a un bouton « Faire un don » par défaut, donc il faut avoir un formulaire de don pour éviter les erreurs.
Code : MACAUSE
Nom du formulaire (visible pour le donateur) :
- Français : Paiement de vos items
- Anglais : Payment of your purchases
Description du formulaire Français : Ce formulaire permet le paiement d'articles achetés lors d’un encan macause.com
Description du formulaire Anglais : Payment form for items purchased through mycause.bid auction.
Langue Français : Coché
Langue Anglais : Coché
Onglet « Configuration du formulaire »
Dates d’affichage du formulaire : Laisser vide
Dates d'expiration du formulaire : Laisser vide
Back-office Thème : Au choix
Back-office Groupe d’images : Au choix
Back-office Groupe de libellés : MACAUSE
Page d'accueil Groupe français : Laisser vide
Page d'accueil Groupe anglais : Laisser vide
Position de la section transaction : Avant la page des informations personnelles (recommandé)
Type de donateurs Donateur personnel : Oui
Type de donateurs Donateur corporatif : Oui
Onglet « Transaction »
Activer la section transaction : Oui
Occasion : Choisir l’occasion MACAUSE ou celle de votre événement préalablement créé.
Affichage des activités : Afficher un menu déroulant (1 choix d’activité)
Activité
Activité : Articles achetés à l’encan
Libellé utilisé pour la description de l’activité sur les reçu don en ligne et dans la liste déroulante d'activités si l’affichage n’est pas en tableau:
- Français : Encan
- Anglais : Auction
Libellé utilisé devant le montant ou la quantité:
- Français : Montant à payer
- Anglais : Amount to be paid
Afficher le montant autre : Oui
Prendre en note le ID activité (pour le courriel à envoyer à Éclipse)
Délivrer un reçu pour : Personnel et corporatif
Reçu : Permettre au client de choisir s'il veut un reçu, mais suggérer selon le montant minimum
Utiliser les reçus Web lors d'un paiement instantané : Non
Onglet « Courriel »
Vous pouvez laisser votre message standard ou l’adapter à l’événement si vous le souhaitez.
Onglet « Groupes de questions »
Ajouter un groupe de questions qui permettra à MaCause d’afficher la liste des items achetés.
Nom : Encan – Liste des items
Libellé : Laisser vide
Emplacement : Transaction
Positionnement : Au-dessus des activités
Onglet « Question »
Après avoir ajouté le groupe de question, il faut ajouter une question pour la liste des items.
Onglet « Info. générales »
Champ : Ajouter la caractéristique précédemment créée : Encan – Liste des items
Libellé:
- Français : Contenu du panier
- Anglais : Your cart
Valeur: Lecture seule : Oui
Onglet « Web »
Nb. lignes affichées: 5
Prendre en note l'ID de la question pour le courriel à envoyer à Éclipse.
Une fois que le formulaire est terminé, il faut l'activer.
Tests
En mode test, faire des transactions avec les formulaires « MACAUSE » et « DONMACAUSE » dans toutes les langues disponibles.
NOTE: Il est normal à cette étape que le « Contenu du panier » soit vide, dans le formulaire « MACAUSE ».
Remplir toutes les informations nécessaires afin de faire un test.
Numéro de carte de crédit test
Visa : 4000 0000 0000 0002 exp. : 01/année suivante CVV : 123
Master Card : 5200 0000 0000 0007 exp. : 01/année suivante CVV : 123
Cliquer sur le bouton « Retour à l'encan » pour s’assurer que le retour vers l’encan MaCause fonctionne.
Refaire les mêmes étapes avec le formulaire de don ainsi que la version anglaise.
Clé de cryptage
Attention ! Si une clé est déjà présente, vous devez utiliser cette clé.
Copier et coller la clé de cryptage dans le courriel à envoyer à Éclipse.
Si aucune clé n’est présente, vous devez appuyer sur le bouton « Générer une clé de cryptage ».
Envoyer la configuration du portail en production.
Cliquer sur « Synchroniser la configuration du portail », puis « Synchroniser en production » et « La configuration du portail ».
Activer l’intégration
Cette étape permet à MaCause de communiquer avec les formulaires que vous venez de créer.
Pour pouvoir inscrire l’intégration dans le formulaire « DONMACAUSE », onglet « Options avancées », puis « Configuration ».
Cliquer sur le bouton « Intégration à JDEL ».
Sélectionner « Configuration de l’adresse URL pour l’intégration post-traitement ».
Coller l’adresse suivante : https://www.macause.com/inc/php/transaction_prodon.php
Répéter la même chose dans le formulaire « MACAUSE ».
Nom du document : ProDon:Intégration Encan MaCause
Version : 5.0.12