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+
+
+
+[[File:HelloAssoKeyApi.png|alt=|border]]+=Usage=+
+
|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:
−2) Then you need to set the Bank account for payments to be saved
+* 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.
==Setup for sandbox mode==
==Setup for sandbox mode==
3) Next you need to connect to your HelloAsso-sandbox account to get and fill 3 fields in Dolibarr:
3) Next you need to connect to your HelloAsso-sandbox account to get and fill 3 fields in Dolibarr:
−*Client organization test with the organization you want the checkout to be done
+*Client Organization test with the organization you want the checkout to be done
−*Client id test key (Blue square on the image)
+*Client ID test key (Blue square on the image)
−*Client secret test key (Red square on the image)
+*Client Secret test key (Red square on the image)
−The two keys can be found on your HelloAsso-sandbox account in the menu My Account > Integrations and APIs
+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==
==Setup for live mode==
Line 45:
Line 51:
4) Next you need to connect to your HelloAsso account to get and fill 3 fields in Dolibarr:
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 Organization live with the organization you want the checkout to be done
−*Client id live key (Blue square on the image)
+*Client ID live key (Blue square on the image)
−*Client secret live key (Red square on the image)
+*Client Secret live key (Red square on the image)
−The two keys can be found on your HelloAsso account in the menu My Account > Integrations and APIs
+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.
−==HelloAsso Api page==
+=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=