29,131
edits
Changes
m
no edit summary
Line 10:
Line 10:
−=Prerequisites=
−This module requires an instance of Dolibarr version 20 or +.
1) First go on the setup page of HelloAsso module in Dolibarr+
+
+
+== Setup for sandbox mode ==+* Client organization test with the organization defined in your HelloAsso sandbox profile
−* Client id test key
−* Client secret test key
−The two keys can be found on your HelloAsso-sandbox account in the menu My Account > Integrations and APIs+[[File:HelloAssoKeyApi.png|thumb]]+
+
+
+
+
+
+
|webbuy=
|webbuy=
|status=development
|status=development
−|minversion=20
+|minversion=21
|note=
|note=
}}
}}
=Features=
=Features=
−Add into Dolibarr, a HelloAsso online payment page (credit/debit cards). This can be used to allow your customers to make ad-hoc payments or payments related to a specific Dolibarr object (invoice, order etc...)
+Add into Dolibarr a HelloAsso online payment page (credit/debit cards). This can be used to allow your customers to make ad-hoc payments or payments related to a specific Dolibarr object (invoice, order etc...).
−=Installation=
=Installation=
Line 27:
Line 24:
−==Setup of HelloAsso Api==
+Generate the two API keys required to make online payment with HelloAsso. They can be found on your HelloAsso dashboard:
+* First go on the page of the Association (create one from menu '''My login - Administer association - Add an association'''.
+* Once you are on the page of an association, go into the menu '''My Account > Integrations and APIs'''
+[[File:HelloAssoKeyApi.png|alt=|border]]
+==Setup of Dolibarr module==
+1) Create a bank account to record any payment done using HelloAsso.
−2) Go on the setup page of HelloAsso module in Dolibarr and set the created bank account as the default bank account.
−2) Next you need to fill 3 fields:
−==Setup for sandbox mode==
−3) Next you need to connect to your HelloAsso-sandbox account to get and fill 3 fields in Dolibarr:
−== Setup for live mode ==
+*Client Organization test with the organization you want the checkout to be done
+*Client ID test key (Blue square on the image)
+*Client Secret test key (Red square on the image)
+The two keys (Client ID and Secret) can be found on your HelloAsso-sandbox account in the menu '''My Account > Integrations and APIs''' in the page of the Organization.
+==Setup for live mode==
+3) The next thing you need to do is enable the Live mode by setting On Helloasso live enabled button.
+4) Next you need to connect to your HelloAsso account to get and fill 3 fields in Dolibarr:
+*Client Organization live with the organization you want the checkout to be done
+*Client ID live key (Blue square on the image)
+*Client Secret live key (Red square on the image)
+The two keys (Client ID and Secret) can be found on your HelloAsso-sandbox account in the menu '''My Account > Integrations and APIs''' in the page of the Organization.
=Usage=
=Usage=
+The only thing to do to use the module is to use any Dolibarr default link to make an online payment. All the links provided by Dolibarr to make online payment will support payment using HelloAsso.
+Here is an example of customer payment page:
+
+[[File:Exemple payment page Helloasso.png|border|968x968px]]<br />
=Development and contributions=
=Development and contributions=
The development of this Open Source application is not included inside the standard GIT repository of Dolibarr but inside a repository dedicated to modules not supported by the Dolibarr development team but supported by {{TemplateURLDoliCloud}} on GitHub:
The development of this Open Source application is not included inside the standard GIT repository of Dolibarr but inside a repository dedicated to modules not supported by the Dolibarr development team but supported by {{TemplateURLDoliCloud}} on GitHub:
−*Repository: https://github.com/DoliCloud/DoliMods.git
+*Repository: https://github.com/Dolibarr/dolibarr-community-modules
+*The documentation of HelloAsso API are available here: https://centredaide.helloasso.com/association?question=comment-fonctionne-l-api-helloasso
Your Pull request for fixes or enhancements are welcome.
Your Pull request for fixes or enhancements are welcome.
=Troubleshooting=
=Troubleshooting=