ProDon:Intégration Encan MaCause : Différence entre versions

De Logilys
Aller à : navigation, rechercher
(Contenu remplacé par « {{Entete_TOC}} {{BasPage_ProDon_Version|5.0.12}} »)
Ligne 1 : Ligne 1 :
 
{{Entete_TOC}}
 
{{Entete_TOC}}
  
==  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: '''<nowiki>https://www.macause.com/#don</nowiki>'''
 
 
Lien de retour (URL) Anglais: '''<nowiki>https://www.mycause.bid/#don</nowiki>'''
 
 
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: '''<nowiki>https://www.macause.com/#paye</nowiki>'''
 
 
Lien de retour (URL) Anglais: '''<nowiki>https://www.mycause.bid/#paye</nowiki>'''
 
 
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 [http://wikifr.logilys.com/index.php/ProDon:Int%C3%A9gration_encan_MaCause#Informations_.C3.A0_transmettre_.C3.A0_.C3.89clipse_Solutions_AV.C2.A0 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.
 
 
<span style="color: rgb(255, 0, 0);">'''À 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 [http://wikifr.logilys.com/index.php/ProDon:Int%C3%A9gration_encan_MaCause#Informations_.C3.A0_transmettre_.C3.A0_.C3.89clipse_Solutions_AV.C2.A0 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 : '''[http://wikifr.logilys.com/index.php/ProDon:Int%C3%A9gration_encan_MaCause#Caract.C3.A9ristique 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 [http://wikifr.logilys.com/index.php/ProDon:Int%C3%A9gration_encan_MaCause#Informations_.C3.A0_transmettre_.C3.A0_.C3.89clipse_Solutions_AV.C2.A0 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 ==
 
<span style="color: rgb(255, 0, 0);">'''Attention ! Si une clé est déjà présente, vous devez utiliser cette clé.'''
 
 
Copier et coller la clé de cryptage dans le [http://wikifr.logilys.com/index.php/ProDon:Int%C3%A9gration_encan_MaCause#Informations_.C3.A0_transmettre_.C3.A0_.C3.89clipse_Solutions_AV.C2.A0 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 : <nowiki>https://www.macause.com/inc/php/transaction_prodon.php</nowiki>
 
 
 
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: ===
 
À : [mailto:yannick@eclipsesav.com yannick@eclipsesav.com]; [mailto:dario@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/DONSMACAUSE/ ''https://www.jedonneenligne.org/Organisme/DONMACAUSE/'']*
 
 
Lien anglais : *[https://www.imakeanonlinedonation.org/Organisme/DONSMACAUSE/ ''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/ ''https://www.jedonneenligne.org/Organisme/MACAUSE/'']*
 
 
Lien anglais : [https://www.imakeanonlinedonation.org/Organisme/MACAUSE/ *''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 « <nowiki>https://www</nowiki> »
 
 
== 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, [[ProDon:Int%C3%A9gration_encan_MaCause_d%C3%A9taill%C3%A9e|cliquez ici]].
 
  
  
 
{{BasPage_ProDon_Version|5.0.12}}
 
{{BasPage_ProDon_Version|5.0.12}}

Version du 18 janvier 2024 à 13:03

Intégration Encan MaCause



Nom du document : ProDon:Intégration Encan MaCause
Version : 5.0.12