PREMIUM ADD-ON

This integration is only available to users with a specific paying add-on. Please contact us to get access to Salesforce CRM integration.

Object mapping

Lago to Salesforce object mapping

Install Salesforce CRM Package

To gain premium access to our Salesforce Package application, please don’t hesitate to contact us. You can initiate the installation process by clicking on the provided link, which will direct you to the installation page where you can follow step-by-step instructions for a seamless integration. If you have any questions or need assistance during the installation, our dedicated support team is here to help you every step of the way.

Install Lago Salesforce App package

To ensure a successful installation, please follow these steps:

  1. We recommend selecting the “Install for all users” option;
  2. Click on the “Install” button;
  3. Make sure to check the box to grant access to these third-party websites; and
  4. Once completed, you’ll have successfully installed the Lago Salesforce App.

Please note that the installation process may take a few minutes to complete. However, rest assured that you will receive an email confirmation once the installation is finished.

Set up a webhook url to sync real time data

After installation in Salesforce CRM, set up a webhook URL in Salesforce to receive real-time data from Lago. This involves configuring a new “Site” in Salesforce’s setup section. Note that the four main actions described below should be performed by a Salesforce Admin and is only required during the initial setup.

1. Access the Site section in Salesforce

  1. Click the gear icon in the upper right to access Salesforce Setup;
  2. Search and navigate to the Sites section; and
  3. Create a new Site (see picture below).

Create a new Site in Salesforce

2. Create a new Site in Salesforce

When creating a new site, follow these steps:

  1. Set a unique Site Label;
  2. Specify a unique Site Name;
  3. Optionally, add a Site Description;
  4. Ensure the Site Contact and Default Record Owner are filled;
  5. Set the Default Web Address prefix to getPushNotification;
  6. Choose SiteLogin as the Active Site Home Page; and
  7. Don’t forget to save the new site: and
  8. Activate the newly created site by going to the Site Details and clicking the Activate button.

New site creation flow in Salesforce

3. Edit Public Access Settings in Salesforce

To edit Public Access Settings for your new Site:

  1. Visit the site and click Public Access Settings;
  2. In the Enabled Apex Class Access section, click “edit”;
  3. Add LagoWebHookSubscriptionController to Enabled Apex Classes; and
  4. Save your changes.

Edit Salesforce's site Public Access Settings

4. Paste the Webhook URL into Your Lago App

To set up the webhook URL for real-time data syncing between Lago and Salesforce, follow these steps:

  1. Return to your newly created site;
  2. Locate the Custom URLs section;
  3. Copy the domain name (e.g., lago.my.salesforce-sites.com);
  4. Add the https:// prefix to this domain name (e.g., https://lago.my.salesforce-sites.com); and
  5. Append /services/apexrest/lago/api/Webhooks/incoming/pushDetails/ to the domain name (e.g., https://lago.my.salesforce-sites.com/services/apexrest/lago/api/Webhooks/incoming/pushDetails/).

Find Salesforce's site domain name

Now, go to your Lago app and past this webhook into the webhook’s settings:

  1. Within Lago, navigate to Developers;
  2. Visit the Webhooks tab;
  3. Choose HMAC as the mandatory signature type;
  4. Paste your Salesforce webhook URL; and
  5. Save this webhook endpoint.

Congratulations! You’re ready to sync real-time data from Lago to Salesforce! 🎉

Paste Salesforce webhook URL to Lago

Connect Lago to Salesforce CRM

Connect your Lago instance to Salesforce Lago App

To establish a connection between your Lago instance and the Salesforce Package, follow these steps:

  1. Access Salesforce and locate the App Launcher;
  2. Find and open the Lago app you recently installed;
  3. Within the Lago Base Configuration tab:
  • Provide your Lago API Key (located in Lago’s Developer Section)
  • Enter your Lago API base URL. Do not insert the api/v1 at the end of the URL. By default, the valid URL is https://api.getlago.com/. If you want to change the API base URL to another one (e.g., https://api.eu.getlago.com/ or a custom self-hosted one), please follow this guide.
  1. “Save and validate” your connection; and
  2. Click the “Start Sync Data” to finalize the connection between Lago and Salesforce.

Please note that data synchronization is available only for Lago customers with an external_salesforce_id and an existing Salesforce Account.

Real-time data sync from Lago to Salesforce CRM

If your webhook endpoint is configured correctly, your billing data will flow seamlessly in real-time.

1. Customers data

To synchronize Lago Customer data with Salesforce Accounts (native object), ensure that your Salesforce Account is created first, and that the Lago Customer’s external_salesforce_id is explicitly populated.

  1. Begin by creating a new Account in Salesforce or accessing an existing one;
  2. Next, create a customer in Lago and populate the external_salesforce_id field for a Lago Customer with the Salesforce Account Id; and
  3. Finally, your Salesforce Account and Lago Customer are synchronized!

Billing data will not sync unless these requirements are met. Lago does not create Salesforce Accounts. Before syncing billing data, you need to create or retrieve an existing Account in Salesforce and populate the Lago customer field called external_salesforce_id.

Salesforce Account with Lago Customer information

2. Subscriptions data

Sync subscriptions data from Lago to Salesforce

Whenever a subscription is created for a Lago Customer, the subscription details will be automatically synced in real-time with Salesforce using the Lago Subscriptions custom object.

Here is a list of Subscription fields that are automatically synced. Note that this subcription is automatically linked to a Salesforce Account:

  • Subscription Id;
  • Subscription Name;
  • Subscription Start Date;
  • Subscription Status;
  • Subscription Termination Date (synced when the subscription is terminated);
  • Subscription Billing Time (either calendar or anniversary); and
  • Plan Code.

3. Invoices data

Sync invoices data from Lago to Salesforce

Whenever an invoice is issued for a Lago Customer, the invoice details will be automatically synced in real-time with Salesforce using the Lago Invoices custom object.

Here is a list of Subscription fields that are automatically synced:

  • Invoices Number;
  • Invoice Payment Status;
  • Invoice Type (subscription or one-off);
  • Invoice Issuing Date;
  • Invoice Amount;
  • Invoice File Url; and
  • Invoice Currency.

4. Credit notes data

Whenever a credit note is issued for a Lago Invoice, the credit note details will be automatically synced in real-time with Salesforce using the Lago CreditNotes custom object.

Configure your custom API Base URL

If you use your own Lago API base URL (self-hosting) or one for a different server instance, you can customize it directly in Salesforce:

  1. Navigate to Salesforce’s Setup;
  2. Search for and select Remote Site Settings;
  3. Find and access the remote site for the Lago App;
  4. Click the Edit button to modify the remote site’s details;
  5. Update the Remote Site URL with your preferred URL; and
  6. Save the changes.