ProDon:Intégration encan MaCause

De Logilys
Aller à : navigation, rechercher
Intégration encan MaCause


ATTENTION : Ce document est présentement en rédaction/révision, il est possible que certaines parties soient manquantes ou désuètes.

Introduction

ATTENTION : Prodon doit être à la version 5.0.5.x ou supérieure afin d’être compatible avec l’intégration MaCause.com.

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.

Fonctionnement général

Concernant le paiement des items achetés, une transaction sera créée dans Prodon, associé à l’acheteur, au montant total déboursé. Le détail des items achetés et le montant payé pour chaque item seront importés dans une caractéristique de la transaction.

Aucun reçu ne sera émis en ligne pour les items achetés, après l’importation dans Prodon, il sera possible de modifier la transaction pour ajuster le montant du reçu selon l’item acheté. Pour les dons, il sera possible d’émettre le reçu directement.

Ce qu’il faut avoir avant de faire le formulaire :

Occasion

Pour commencer, on doit créer l'occasion. Cliquez ici pour avoir plus d'information sur comment créer une occasion.

Pour ce faire, dans le menu cliquez sur « Transactions », puis sur « Occasions ».
ProDon 5 Module Don en ligne Intégration encan MaCause 001.png
Il faut avoir une occasion et une activité.

Il est possible de créer les activités d’encan dans votre occasion pour laquelle vous avez l’encan, sinon il est aussi possible de créer une occasion spécifique « MACAUSE ».

ProDon 5 Module Don en ligne Intégration encan MaCause 002.png
A : Inscrire le code de l'occasion. B : Inscrire la description de l'occasion.
C : Permets d'ajouter les activités de don et d'achat à l'encan

L'activité de don

Ajouter les activités suivante, selon les paramètres suggérés :
ProDon 5 Module Don en ligne Intégration encan MaCause 003.png
A : Code : DONMACAUSE B : Description : Don
C : Type de transaction : Standard D : Délivrer un reçu : Oui
E : Provenance : 1 - Don
Configurer l'affectation comptable appropriée si désirée, dans l'onglet « Aff. compt. ».

L'activité d'achat d'articles à l'encan

ProDon 5 Module Don en ligne Intégration encan MaCause 004.png
A : Code : ENCANB : Description : Don
C : Type de transaction : StandardD : Délivrer un reçu : Oui (si vous désirez délivrer un reçu pour la portion admissible)
E : Provenance : 2 - Activité bénéfice
Configurer l'affectation comptable appropriée si désirée, dans l'onglet « Aff. compt. ».

Caractéristique

On doit créer une caractéristique pour la liste des items qui seront vendus à l'encan. Cliquez ici pour plus d'informations sur la gestion des caractéristiques
Pour accéder à la « Gestion des caractéristiques », allez dans le menu « Configuration », « Personnalisation », puis « Caractéristiques ».
ProDon 5 Module Don en ligne Intégration encan MaCause 005.png

Ajouter une caractéristique qui contiendra la liste des items achetés à l’encan (si elle n'existe pas déjà).

ProDon 5 Module Don en ligne Intégration encan MaCause 006.png
A : Caractéristique : Encan - Liste des items B : Emplacement : Gestion des transactions
C : Type : Texte long D : Cocher : Permettre une seule valeur par

enregistrement

E : Cocher : Voir dans la grille de gestion

Configuration des libellés

Il faut créer deux groupes de libellés, afin de personnaliser l’URL de retour pour rediriger le client sur la bonne page de MaCause.

Cliquez ici pour plus d'information sur comment se connecter au Backoffice.

Note : 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.
Aller dans le « Backoffice », puis cliquez « Groupes de libellés ».
ProDon 5 Module Don en ligne Intégration encan MaCause 007.png

L'ajout de groupes de libellés

Pour commencer, ajouter un groupe de libellés de type « Groupes de libellés formulaire », pour chacun des formulaires.

Vous pouvez dupliquer le groupe « Client / Transaction ».

ProDon 5 Module Don en ligne Intégration encan MaCause 008.png
Nommer le groupe de libellés pour la page de dons :

Nom: DONMACAUSE

Utiliser ce groupe par défaut: Non

ProDon 5 Module Don en ligne Intégration encan MaCause 009.png
On doit modifier certains libellés.
ProDon 5 Module Don en ligne Intégration encan MaCause 010.png
Rechercher: Lien de retour et Lien de retour (URL)

Lien de retour Français: Retour à l'encan

Lien de retour Anglais: Return 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.

Ensuite, il faut ajouter un autre groupe de libellés. Dupliquer le groupe de libellés DONMACAUSE.
Pour faire cela, vous devez cliquez sur le bouton « Ajouter » puis sélectionner DONMACAUSE et faire le bouton « Dupliquer ».
ProDon 5 Module Don en ligne Intégration encan MaCause 021.png
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

Il faudra créer deux formulaires, un pour recevoir les dons et l'autre pour l'achat des items d'encan. Comme le site de MaCause est bilingue, il faudra faire les formulaires en français et en anglais pour éviter la confusion. Vous n'êtes pas obliger de traduire le texte, simplement copier et coller votre texte français dans les portions anglaises.

Formulaire web de don

Ajouter un formulaire de type transaction, pour des dons effectués lors de l’encan. Vous pouvez dupliquer un formulaire associé à l’événement ou le formulaire de don général.Cliquez ici pour plus d'informations sur l'ajout de formulaires web.

À 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.
ProDon 5 Module Don en ligne Intégration encan MaCause 011.png
Avertissement : Comme pour les libellés il faudra utiliser les formulaire en français et en anglais, même si vous n’utilisez pas cette langue normalement.
A : Code : DONMACAUSE B : Nom du formulaire (visible pour le donateur) Français : Don

Nom du formulaire (visible pour le donateur) Anglais: Donation

C : 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

D : Langue Français: Coché

Langue Anglais: Coché

Configuration du formulaire

ProDon 5 Module Don en ligne Intégration encan MaCause 012.png
A : Date d’affichage du formulaire : Laisser vide

Date d'expiration du formulaire : Laisser vide

B : Back-office :

Thème et groupe d’images : Au choix

Groupe de libellés : DONMACAUSE

C : Page d'accueil :

Groupe français : Laisser vide

Groupe anglais : Laisser vide

D : Position de la section transaction : Avant la page des informations personnelles (recommandé)
E : 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.

ProDon 5 Module Don en ligne Intégration encan MaCause 013.png

Onglet « Transaction »

ProDon 5 Module Don en ligne Intégration encan MaCause 014.png
  • 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
ProDon 5 Module Don en ligne Intégration encan MaCause 015.png
ProDon 5 Module Don en ligne Intégration encan MaCause 016.png
A. Activité : Choisir l'activité de don.
B. Libellé utilisé pour la description de l’activité sur les reçu (…) si l’affichage n’est pas en tableau
  • Français : Don
  • Anglais : Donation
C. Libellé utilisé devant le montant ou la quantité
  • Français : Montant du don
  • Anglais : Donation amount
D. Afficher le montant autre : Oui
ProDon 5 Module Don en ligne Intégration encan MaCause 017.png
A. Délivrer un reçu pour : Personnel et corporatif B. Reçu : Au choix
C. Montant minimum (Reçu) : Au choixD. Utiliser les reçus Web lors d’un paiement instantané : Oui
ProDon 5 Module Don en ligne Intégration encan MaCause 018.png
Prendre en note le ID activité (pour le courriel à envoyer à Éclipse (inséré lien vers modèle courriel)

Note : La colonne d’ID est peut-être placée plus à droite dans la fenêtre d’activité

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. Donc pour éviter le partage :

ProDon 5 Module Don en ligne Intégration encan MaCause 019.png
Si vous utilisez le partage sur les réseaux sociaux sur la page d’accueil
  • 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 »

ProDon 5 Module Don en ligne Intégration encan MaCause 020.png
A. Afficher sur la page d’accueil : NonB. Donateur par défaut : Demander au donateur
C. Date de naissance : Ne pas afficher D. Niveau de sécurité du captcha : « Modéré (Recommandé) »
E. Afficher le libellé OBNL : OuiF. Utiliser le format d’adresse bloc libre : Non
G. Courriel obligatoire : Oui H. Confirmation du courriel : Oui
I. Afficher le commentaire : NonJ. Cacher les informations transactionnelles : Non
K. Téléphones : Mettre à « Afficher » un type de téléphone par catégorie de client : Perso., tél. domicile ou mobile / Corpo., tél. travail ou mobileL. Exiger au moins un téléphone : Oui
Activer le formulaire.

Formulaire web de paiement des items achetés 

Ajouter un formulaire de type transaction pour le paiement des dons fait lors de l’encan. Dupliquer le formulaire DONMACAUSE. Simplement modifier les éléments suivants ou s'assurer que les inf.
À noter : Si que vous utilisez le mode de paiement Square ou autre lors de l'encan, vous devez tout de même de 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.
Cliquez ici pour plus d'informations sur l'ajout de formulaires web.
À ajouter : Comment dupliquer un formulaire
image
Avertissement : Comme pour les libellés il faudra utiliser les formulaire en français et en anglais, même si vous n’utilisez pas cette langue normalement.
A. Code : MACAUSE
  • Français : Coché
  • Anglais : Coché
B. Nom du formulaire (visible pour le donateur) :
  • Français : Paiement de vos items
  • Anglais : Payment of your purchases
C. Description du formulaire :
  • Français : Ce formulaire permet le paiement d'articles achetés lors d’un encan macause.com
  • Anglais :   Payment form for items purchased through mycause.bid auction.

Configuration du formulaire

image
A. Dates :
  • d’affichage du formulaire : Laisser vide
  • d'expiration du formulaire : Laisser vide
B. Back-office :
  • Thème et groupe d’images : Au choix
  • Groupe de libellés : MACAUSE
C. Page d'accueil :
  • Groupe français : Laisser vide
  • Groupe anglais : Laisser vide
D. Position de la section transaction :
  • Avant la page des informations personnelles (recommandé)
E. Type de donateurs :
  • Donateur personnel : Oui
  • Donateur corporatif : Oui

Onglet « Transaction »

Image
  • 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é : Modifier l’activité pour Articles achetés à l’encan
Image
Image
A. Activité : Choisir l'activité d'achat; Articles achetés à l’encan
B. Libellé utilisé pour la description de l’activité sur les reçu (…) si l’affichage n’est pas en tableau
  • Français : Encan
  • Anglais : Auction
C. Libellé utilisé devant le montant ou la quantité
  • Français : Montant à payer
  • Anglais : Amount to be paid
D. Afficher le montant autre : Oui
image reçu
A. Délivrer un reçu pour : Personnel et corporatif B. Reçu : Ne jamais délivrer de reçus pour ce formulaire
Image id activité
Prendre en note le ID activité (pour le courriel à envoyer à Éclipse (inséré lien vers modèle courriel)

Note : La colonne d’ID est peut-être placée plus à droite dans la fenêtre d’activité

Onglet « Courriel »

  •  Vous pouvez laisser votre message standard ou l’adapter à l’événement si vous le souhaitez.

Onglet « Groupes de questions »

image groupe de questions

Cliquez ici pour plus d'information sur les groupes de questions

  • Ajouter un groupe de question 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 »

  • Ajouter une question 
  • Champ : Ajouter une caractéristique (si elle n’existe pas déjà)  Caractéristique : Encan – Liste des items 
    • Type : Texte long 
    • Permettre une seule valeur par enregistrement : Oui 
    • Voir dans la grille de gestion : Oui 
Image
Question suite
  • Libellé 
  • Français : Contenu du panier 
  • Anglais : Your cart 
  • Valeur 
  • Lecture seule : Oui 
Prendre en note le ID de la question pour le courriel à envoyer à Éclipse (la colonne d’ID est peut-être placée plus à droite dans la fenêtre des questions)
Activer le formulaire.

Tests 

En mode test, faire des transactions avec les formulaires « MACAUSE » et « DONMACAUSE » dans toutes les langues disponibles. Il est normal à cette étape que le « Contenu du panier » soit vide, dans le formulaire « MACAUSE »

Clé de cryptage 

‹Ajouter img clé›
Gestion des formulaires Web → Configuration du portail → Accès JeDonneEnLigne 
La clé de cryptage est documentée en bas de cette section.  

Attention ! Si une clé est déjà présente, vous devez utiliser cette clé.

Si aucune clé n’est présente et seulement si aucune clé n’est présente, vous devez appuyer sur le bouton «  Générer une clé de cryptage ». Si vous appuyez sur le bouton alors qu’une clé est présente, il y a risque de briser une autre intégration. 

Envoyer la configuration du portail en production. 

Activer l’intégration 

Configurer l’intégration, cette étape permet à MaCause de communiquer avec les formulaires que vous venez de créer.
‹Ajouter img intégration›
Dans le formulaire « DONMACAUSE » 
  • Options avancées 
  • Intégration à JDEL → 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 dans le formulaire « MACAUSE »

Modifier la validation

‹Ajouter img validation›
Dans le formulaire « MACAUSE » 
  • Transaction 
  • Modifier l’activité → Onglet « Validation » → « Modification de la valeur par défaut » Choisir : Le donateur ne peut pas modifier le montant
Synchroniser les deux formulaires en production.

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 du courriel à transmettre
À : yannick@eclipsesav.comdario@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*

Clé de cryptage :  *Coller la clé de cryptage ici (trouver la clé)*

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!


Nom du document : ProDon:Intégration encan MaCause