ProDon:Intégration Encan MaCause
Intégration Encan MaCause |
Sommaire
- 1 Introduction
- 2 Ce qu’il faut avoir dans Prodon avant de faire le formulaire :
- 3 Ce qu’il faut avoir dans le Back-office avant de faire le formulaire :
- 4 Les formulaires
- 4.1 Formulaire web de don
- 4.2 Onglet « Configuration du formulaire »
- 4.3 Onglet « Paiements »
- 4.4 Onglet « Transaction »
- 4.5 Onglet « Engagement »
- 4.6 Onglet « Frais administratifs »
- 4.7 Onglet « Courriel »
- 4.8 Onglet « Groupes de questions »
- 4.9 Onglet « Notes »
- 4.10 Onglet « Liste de distribution »
- 4.11 Onglet « Partage sur les réseaux sociaux »
- 4.12 Onglet « Options avancées » / « Configuration »
- 4.13 Formulaire web de paiement des items achetés
- 4.14 Onglet « Configuration du formulaire »
- 4.15 Onglet « Transaction »
- 4.16 Onglet « Engagement »
- 4.17 Onglet « Frais administratifs »
- 4.18 Onglet « Courriel »
- 4.19 Onglet « Groupes de questions »
- 5 Tests
- 6 Clé de cryptage
- 7 Activer l’intégration
- 8 Modifier la validation
- 9 Synchroniser les deux formulaires en production.
- 10 Informations à transmettre à Éclipse Solutions AV
- 11 Informations à transmettre à Paysafe
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 dans Prodon 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
Ce qu’il faut avoir dans le Back-office avant de faire le formulaire :
Thème
Aller changer la mise en page pour Compact
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 la valeur par défaut (Français) pour :
Titre de civilité:
- Français: Appellation (non obligatoire)
- Anglais: Title (not required)
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
Faire une recherche sur la valeur par défaut (Français) pour :
Titre de civilité:
- Français: Appellation (non obligatoire)
- Anglais: Title (not required)
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
- 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 uniquement le mode de paiements Carte de crédit.
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
Prendre en note le ID activité (pour le courriel à envoyer à Éclipse)
Délivrer un reçu pour : Personnel et corporatif
Reçu : Forcer un reçu si le montant minimum est atteint et permettre un reçu si inférieur
Montant minimum (Reçu) : Au choix
Utiliser les reçus Web lors d’un paiement instantané : Oui
Onglet « Engagement »
Activer la section engagement : Non
Onglet « Frais administratifs »
Ne pas activer cette fonction.
Onglet « Courriel »
Vous pouvez laisser votre message standard ou l’adapter à l’événement si vous le souhaitez.
Demandez au client si il y aura une image dans le courriel, si oui lui dire ceci qui est très important: AVANT d'ajouter son image dans les fichiers du Back-office, s'assurer que la largeur n'est pas plus de 500pixels.
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. cellulaire
- 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
Langue Français : Coché
Langue Anglais : Coché
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.
Onglet « Configuration du formulaire »
Dates d’affichage du formulaire : Laisser vide
Dates d'expiration du formulaire : Laisser vide
Back-office:
- Thème et Groupes d'images : Au choix
- Groupe de libellés : MACAUSE
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 « 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 : Ne jamais délivrer de reçus pour ce formulaire
Utiliser les reçus Web lors d'un paiement instantané : Non
Onglet « Engagement »
Activer la section engagement : Non
Onglet « Frais administratifs »
Ne pas activer cette fonction.
Onglet « Courriel »
Vous pouvez laisser votre message standard ou l’adapter à l’événement si vous le souhaitez.
Demandez au client si il y aura une image dans le courriel, si oui lui dire ceci qui est très important: AVANT d'ajouter son image dans les fichiers du Back-office, s'assurer que la largeur n'est pas plus de 500pixels.
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 le ID activité (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 ».
Modifier la validation
Aller dans le formulaire « MACAUSE », pour modifier la validation.
Dans l’onglet « Transaction », cliquer sur le bouton pour modifier l’activité.
Dans l’onglet « Validation », changer la modification de la valeur par défaut pour « Le donateur ne peut pas modifier le montant ».
Synchroniser les deux formulaires en production.
Cliquer sur ce bouton pour synchroniser en production le formulaire.
Il faut faire de même pour l'autre formulaire
Il y aura une question concernant les dons tests, si vous voulez les supprimer, répondez « Oui ».
Il y aura une question pour activer la maintenance puis pour désactiver la maintenance, dans les deux cas il faut répondre « Oui ».
Informations à transmettre à Éclipse Solutions AV
Éclipse Solutions AV auront besoin de certaines informations afin d’utiliser l’intégration.
C’est à cet endroit que les ID pris en note serviront.
Utiliser le modèle ci-bas et modifier les informations en *italique* pour celles de vos formulaires et de votre organisme.
Modèle de courriel à transmettre:
À : yannick@eclipsesav.com; dario@eclipsesav.com
Objet :Intégration MaCause pour *NOM DE VOTRE ORGANISME*
Bonjour Yannick, Bonjour Dario,
Nous venons de compléter la configuration des formulaires pour *NOM DE VOTRE ORGANISME*.
La personne-ressource a été avertie de ne rien modifier dans la configuration des formulaires d'encan, sans nous en avertir.
Clé de cryptage : *Coller la clé de cryptage ici (trouver la clé)*
Pour le formulaire de don : DONMACAUSE
Le lien complet du formulaire :
Lien français : *https://www.jedonneenligne.org/Organisme/DONMACAUSE/*
Lien anglais : *https://www.imakeanonlinedonation.org/Organisme/DONMACAUSE/*
L’ID de l’activité : *999*
Pour le formulaire de paiement : MACAUSE
Le lien complet du formulaire :
Lien français : *https://www.jedonneenligne.org/Organisme/MACAUSE/*
Lien anglais : *https://www.imakeanonlinedonation.org/Organisme/MACAUSE/*
L’ID de l’activité : *999*
L’ID de la question « Encan - Liste des items » : *999*
ATTENTION : il est très important de double cliquer sur l’URL pour avoir le « https://www »
Informations à transmettre à Paysafe
Informer Paysafe de l’évènement, le montant maximum estimé du paiement pourrait être anormalement élevé par rapport aux montants normalement reçus par l’organisme, car la transaction pourrait être refusée pour des raisons de « risque ».
Modèle du courriel à transmettre:
À : risk@paysafe.com
Objet : Évènement d’encan interactif pour *NOM DE VOTRE ORGANISME*
Bonjour,
Le client suivant aura une activité de vente d’articles à l’encan.
*99990000* – NOM DE VOTRE ORGANISME* (disponible sur votre plateforme Paysafe)
Date de l’encan : *DATES DÉTERMINÉES DE L'ENCAN*
On peut donc s’attendre à des transactions plus hautes qu’à la normale (pouvant aller jusqu’à quelques milliers de dollars).
Attention ! Il s’agit d’un évènement annuel, donc ce type de transactions reviendra annuellement (mais pas à la même date précise).
Merci!
Pour consulter la documentation détaillée de l'Intégration encan MaCause, cliquez ici.
Nom du document : ProDon:Intégration Encan MaCause
Version : 5.0.12