<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><p><strong>In this guide we will cover:</strong></p><p><strong>- What is the GoCardless Integration?</strong></p><p><strong>- Enabling the Module</strong></p><p><strong>- Customer Imports</strong></p><p><strong>- Viewing Payments</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the GoCardless Integration?</span></strong></p><p id="isPasted">GoCardless can be integrated with Halo to import customers, assign custom fields to them, and sync payment statuses.</p><p><br></p><p><strong>The GoCardless integration with Halo does not currently support payment processing, this will be available in the near future.</strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Enabling the Module</span></strong></p><p>To begin integrating with GoCardless, you must enable the integration module in Halo (Configuration > Integrations), by clicking on the + sign on the module.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjYyZjQ2NzBiLWI5NGQtNDk2YS05ODlmLTU4MmQ0ZjQwMTVjZCJ9.5OGWRh0iHw_5o7rsSu1Ti8UF4cSmsODZzeJhXNOh9ds" class="fr-fic fr-fil fr-dib" width="828" height="364"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enabling the GoCardless Module.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Customer Imports</span></strong></p><p>You can match GoCardless Companies to Halo Customers/ Site if they are the same. When the Names are different across GoCardless and Halo, the user will be placed into the "Default Site" which is set on the integration page shown in <strong>Fig 2</strong>.</p><p><strong><br></strong><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdjNzMxMzAwLWRlNTUtNDhkOC05Y2NiLTdlNTdhNzM2ZDA1MSJ9.dqDdVyQx8IQE250CT_9ezd9gzS2wg_YlqX-GHgauX20" class="fr-fic fr-fil fr-dib" width="1219" style="width: 1221px; height: 428.939px;" height="429"></p><p><strong><span style="font-size: 10pt;">Fig 2. Custom Field Mappings.</span></strong></p><p><br></p><p><strong>The site which is synced to when importing users, will be the default site of the customer (The Invoice Site).</strong> After the initial import, you can move users into the correct sites, this will not affect the syncing of users, as the Halo integrator will match onto the user and not the site, when recurring syncs are enabled. </p><p><br></p><p>If you have not yet setup the Halo Integrator, use the following <a href="https://usehalo.com/halopsa/guides/1062/" rel="noopener noreferrer" target="_blank"><strong>guide</strong></a>.</p><p><br></p><p>Halo customers that are On-Prem can setup the <a href="https://usehalo.com/halopsa/guides/1766/" rel="noopener noreferrer" target="_blank"><strong>Halo DB Integrator</strong></a> (This is only for On-Prem customers as hosted customers have this hosted on Halo by default).</p><p><br></p><p>The difference between the Integrator and the DB Integrator is explained in the DB Integrator guide. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjJjN2JhMDgzLTRhZjUtNGEwNy1iZjdjLTU1ZTRlZTEzMmY5MCJ9.t6sqWv2U_R4i5ebfsIqV-Jnr2_aXJV4v7zc7VtMNIIU" class="fr-fic fr-fil fr-dib" width="1210" style="width: 1212px; height: 198.052px;" height="198"></p><p><strong><span style="font-size: 10pt;">Fig 3. Enabling the Halo Integrator for this Integration.</span></strong></p><p><br></p><p>From here you can enter your access token and begin mapping your customers in GoCardless to your users in Halo. There is an import users button for importing users into Halo, the below fields (Shown in <strong>Fig 4</strong>) will be populated based on the customers details in GoCardless. To sync custom fields from GoCardless to Halo, add them via the mappings table.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjIyMmFlYTU3LTFlYzctNGFiMi04MmUzLThlMzFkNGQzMmUyMSJ9.DpmziEezrBY-bIATgs8sMPhEoCPauBONWwhj_QxzisQ" class="fr-fic fr-fil fr-dib" width="1213" style="width: 1215px; height: 257.727px;" height="258"></p><p><strong><span style="font-size: 10pt;">Fig 4. Importing Users from GoCardless.</span></strong></p><p><br></p><p>You can add custom fields to a Customer in GoCardless, and then map to fields in Halo (As shown in <strong>Fig 2</strong>). Within Halo, these will have to be custom fields of type "Text" and Entity: User. The field mapping example is shown in <strong>Fig 2.</strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjJmN2Y0YTE0LTFiMTQtNDliYS1hYTg0LTJkYmM5NjZlMWQ1NSJ9.tgndcc219-aMO0eZBFRf_ip2Uh5S-r3O5Z7TTnJvpLU" class="fr-fic fr-fil fr-dib" width="684" height="286"></p><p><strong><span style="font-size: 10pt;">Fig 5. The "User" Entity for Custom Fields.</span></strong></p><p><br></p><p>Custom Fields can be added to customers in GoCardless.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImY4YzBkMDJiLTY4MTYtNGMxYy1iY2Y2LWRkNWQ1NGVkYWQ0ZCJ9.eB683W5-I_CgO8S7alf4h4f_a0yLN_Ce3QujG1D6UKg" class="fr-fic fr-fil fr-dib" width="768" height="728"></p><p><strong><span style="font-size: 10pt;">Fig 6. Adding Custom Fields in GoCardless.</span></strong></p><p><br></p><p>This will be added to the user in Halo, notice that the custom field mappings will need to be added to for this below field to populate <strong>(Fig 7)</strong>. The import screen does not have custom field columns, this is why you must add to the field mappings table.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImZhOTg0YmQ5LWFmODItNGE4Zi1hNDQyLTJhNDk1ZDYyNWJhZiJ9.Gbzb7apcIklFWpGGz1khax7vS6Jqrb-B3kpkCfXWM0A" class="fr-fic fr-fil fr-dib" width="1205" style="width: 1207px; height: 250.12px;" height="250"></p><p><strong><span style="font-size: 10pt;">Fig 7. The Custom Fields Tab on the User in Halo.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Viewing Payments</span></strong></p><p>You will then be able to view any payments the User has made, this is done via the "GoCardless Payments" tab on their User Details.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImVhY2U2YzU1LWVlZTItNGE0Ni04MWExLWVlY2E2N2VjMmMyNiJ9.joh8xYw1LSmwzSnrRvg_qeu9qPj4yjPwAjXjI9isHbE" class="fr-fic fr-fil fr-dib" width="1213" style="width: 1215px; height: 331.225px;" height="331"></p><p><strong><span style="font-size: 10pt;">Fig 8. GoCardless Payments Tab.</span></strong></p><p><br></p><p>You can double click a Payment to open it in GoCardless.</p>
