![Logo|250](int-sflogo.png) ## Overview This allows you to push data from ChargeOver, to Salesforce. Once you have connected Salesforce to ChargeOver, you can configure ChargeOver to automatically sync data into Salesforce. The sync happens in real-time, so as soon as you create an object in ChargeOver, we're attempting to sync it to Salesforce right away. ## Getting Connected To get connected, you first need to create a **"Connected App"** in Salesforce. 1. Within Salesforce, go to the **Setup** page and choose **Build** then **Create** then **Apps** from the left menu ![](./b6825aa6-85d9-44ef-b8ba-dada199c6b04-fl4.jpg) 2.Make sure you're in the **Connected Apps** section, and click the **\[New\]** button ![](./7d1e8052-9004-435e-82f7-0477d58c1273-o78.jpg) 3. You'll need your ChargeOver + Salesforce **Callback URL** -- you can get this in ChargeOver by going to **Settings** then **Integrations** and clicking **Salesforce** 4. Enter the following information into the **Create an App** in Salesforce - Connected App Name: ChargeOver - API Name: ChargeOver - Contact Email: support@ChargeOver.com - Callback URL: (the callback URL you got from ChargeOver) 5. Move **Access and manage your data (api)** to the **Selected OAuth Scopes** box 6. Move **Perform requests on your behalf at any time (refresh_token, offline_access) to the **Selected OAuth Scopes** box ![](./650335b6-6111-431d-bb63-51af4f874449-bv8.jpg) 7. Once the app has been created in Salesforce, Salesforce will show you a **Consumer Key and Consumer Secret**. You're going to copy and paste these into ChargeOver ![](./564665c4-e2da-4830-b9ca-9a2d6da18dd6--6i.jpg) 8. Copy and paste the Consumer Key and Consumer Secret into ChargeOver - Fill in your **Salesforce Login URL** (the place you go to log in to Salesforce) too ![](./254b07de-b1e5-4750-a0e6-6bd01374e5bb-qsk.jpg) 9. Click the **\[Connect to Salesforce\]** button to connect ![](./5a6b322c-a1c2-4618-984b-48a62301c332-10a.jpg) You should see a confirmation of the connection appear in a blue dialog box after authorizing the connection to Salesforce. ![](./5c146d09-9c5e-4362-aac1-4bb0d4f30b43-esk.jpg) :::note The Salesforce integration is only available on our enterprise plan. ::: ## Choosing What to Sync ### Steps 1. Go to **Settings** and **Integrations** then select **Sync to Salesforce** 2. Select the ChargeOver data you want to sync to Salesforce and then enter in the Salesforce object we're pushing to ![](./synctosf-pmu.jpg) 3. You will immediately be presented with a list of ChargeOver object fields. For each field in ChargeOver you want to sync to Salesforce, enter the "**Salesforce API Field Name"** ![](./synctosf2-bru.jpg) ![](./3ecd809e-620b-417c-bd0a-5225a5b71f0a-cga.png) - You can also sync ChargeOver data to Salesforce custom fields ![](./678cc356-ae8e-433a-b8f8-476e7f46e87a-vqc.png) - Some objects in Salesforce may need a specific date type or data format - you can use the drop-down menu to convert data from ChargeOver into the appropriate Salesforce data format ![](./synctosf4-snw.jpg) 4. Click the **Save Settings** button ### Related Data Points to Sync ChargeOver supports syncing the these objects to Salesforce. - Customers - Quotes - Invoices - Invoice Line Items - Subscription - Subscription Line Items - Transactions - Transaction & Invoice Relationship (how the payment is applied to the invoice) - Contacts - Credit Card details - Bank Accounts ## Sync Logging and Troubleshooting ChargeOver exposes a Salesforce sync log which is sometimes helpful for troubleshooting. You can access this report via the ChargeOver **Report Center**. ![](./a4f9fee2-7e3e-4a70-9406-73b5fcaaa4a1-7mm.png) Of course, feel free to contact us if you need help getting set up/troubleshooting as well! ## Recommended Object Schema Below is a recommended schema for syncing data from ChargeOver, to Salesforce. It uses the built-in Account object in Salesforce for customer data, and provides insight within Salesforce into subscription, invoice, and payment information. ### Invoices Invoices show what a customer owe and has paid. ![](./59092bc8-a41a-4a24-bdf1-bb1675134d05-kkk.png) ### Invoice Line Items Invoice line items contain information about specific products/plans with quantities and rates. ![](./09b3069c-a933-4a53-ae38-8cd1b96bbc64-1c0.png) ### Subscriptions Subscriptions indicate what a customer is subscribed to, and the customer value associated with that. ![](./ee9d2006-616c-4bf3-9343-57250c31c3a9-k48.png) ### Subscription Line Items Subscription line items contain the specific products or plans with quantities or rates for a subscription. ![](./1408da01-db61-4dae-a827-cc4cf19854c1-uek.png) ### Transactions While you can only sync the relationship between invoices & payments, it's also important to sync the transaction itself as well. This will provide you with more options to resync a payment and give you more accurate reporting. Make sure if you're syncing Applied Payments, you're syncing Transactions as well! ### Applied Payments The applied payments object shows payments against specific invoices. ![](./e6a8e146-8d97-45f2-a00e-fbfb37a30f76-zwa.png) ### Products or Plans Product or plan information and relationships. ![](./37843adc-6d25-4c54-83c0-ff06b320b464-lwi.png) ## Video Walk Through If you would like a step-by-step virtual walk through on how to sync data, click on the links below. Each video is about 4 minutes long. - [Part 1 - General Walk Through](https://player.vimeo.com/video/542799816?h=381c65f209) - [Part 2 - Config Personalization](https://player.vimeo.com/video/542800637?h=2e7cc7c079) ## Relationships and Lookup Fields If you have relationships between objects in Salesforce, ChargeOver can sync those relationships to make sure your Salesforce accurately reflects those relationships or lookups. For example, if you have a Salesforce object which references the ChargeOver customer via a lookup field ![](./ae980ee7-872c-44df-8610-4af649103582-6wq.png) You should make sure to tell ChargeOver about this relationship ![](./3f478121-ce00-4971-86ef-c55846aba943-eog.png)