ProDon:Intégration Encan MaCause

Intégration Encan MaCause

Version imprimable

---

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

Version imprimable