The Payment > Billing feature of the Registration module must be enabled. To manage your features, refer to this article
Enabling the billing feature allows you to set up an invoice generation system and will make the payment settings appear in the Event section of the navigation menu in your back office, Integration tab. To manage billing, we work with our provider Zoho.
Zoho CRM API is authenticated with standard OAuth2, so it is mandatory to register and authenticate your client app with Zoho.
Browser
⚠️ To correctly generate your token, make sure you are logged into the Zoho account for your event and use the same browser for Eventmaker and Zoho when configuring your billing.
Register on Zoho
Go to the site accounts.zoho.com/developerconsole and create an account
Select the Server-based Applications option
View of the Zoho Invoice API area
Fill in the following fields :
Client Name : Eventmaker
Homepage URL : https://app.eventmaker.io
Authorized Redirect ULR : https://app.eventmaker.io/receive_zoho_grant_token
Information to enter into the Zoho API Console
Click on CREATE
If necessary, click on your application to edit it and go to Client Secret
Copy the Client ID and the Client Secret into the corresponding sections of the Payment tab
Go to Settings and check the box before Generating a new token
Check the Multi-DC option
Create your Invoice account
The next step is to create your organization on Invoice to customize your billing from this link.
You also have the option to create your invoice template, also from Zoho Invoice in order to test the previously configured customization.
Once this is done, return to your Zoho integration on Eventmaker.
Click on Generate a new token to allow Eventmaker to access your Zoho data
Accept the information sharing before being redirected to Eventmaker
Save your changes on Eventmaker and you have finished configuring billing.
⚠️ The region will vary in your configuration depending on your Zoho account. To verify this, when you click the Generate a token button, the url in the screenshot above will be either .COM or .EU.
Add the billing block to a registration process
Go to the category of your choice and add the Zoho Billing.
⚠️ You can only add the Zoho Billing block if Payment has been added in the registration process of your category.
In this block, you can configure the fields that will appear on the invoices sent to your customers. Here is an example :
💡 Electronic invoicing
For an invoice to move from Draft status and receive a final invoice number, certain information must be provided for the contact associated with the invoice. This includes:
the customer type: Business or Individual;
the SIRET number for Business customers;
the VAT number, if applicable;
a complete billing address: street, city, postal code, and country.
If any required information is missing, Zoho may reject the invoice finalization. The invoice will then remain in Draft status and no final invoice number will be generated.
New mapping fields available
New mapping fields are now available in Eventmaker to send the required information to Zoho:
customer type;
VAT number;
SIRET number.
The SIRET number uses the Business identification number field already available on the participant profile.
It is also now recommended to use the full country name rather than its three-letter country code.
Invoice stuck in Draft status
⚠️ If an invoice remains stuck in Draft status, it generally means that some required information is missing or incorrect.
The error message returned by Zoho is now displayed more clearly in Eventmaker, particularly from the relevant participant profile and cart.
Here are some examples of possible causes:
missing SIRET number;
missing country in the billing address;
incomplete billing address;
missing customer type;
information rejected by Zoho.
Once the information has been corrected, you can restart the process using the Retry sending invoice action.
This action restarts the remaining steps of the process:
invoice generation;
payment registration, if required;
request to send the invoice by email from Zoho.
Customers outside France
Invoicing for businesses located outside France, whether within or outside the European Union, is not yet covered by these changes. By default, the customer type is therefore sent as Individual to avoid unnecessarily blocking invoice generation. Business is sent only if:
the participant selected this customer type;
their country is France;
the billing country configured for the event is also France.