--- title: Square Integration description: square --- [Skip to content](https://kbhelp.humanitru.com/knowledge/square-integration#main-content) English Show submenu for translations [Contact us](https://kbhelp.humanitru.com/knowledge/kb-tickets/new?hsLang=en) [![Humanitru-logo-green-horiz-lo-rez-web-main-RGB-3.png\]](https://kbhelp.humanitru.com/hs-fs/hubfs/Humanitru-logo-green-horiz-lo-rez-web-main-RGB-3.png?height=40&name=Humanitru-logo-green-horiz-lo-rez-web-main-RGB-3.png)](https://kbhelp.humanitru.com/knowledge?hsLang=en) Open main navigation Close main navigation - English Show submenu for translations - [Contact us](https://kbhelp.humanitru.com/knowledge/kb-tickets/new) Hello. How can we help? - There are no suggestions because the search field is empty. 1. [Help Center](https://kbhelp.humanitru.com/knowledge?hsLang=en) 2. [Integrations](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en) 3. [Square](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#square) # Square Integration This article will walk you through the process of connecting your Square account to your Humanitru database and explain how transaction and constituent data syncs between the two systems. **Before You Start** - You'll need an active Square account. - The following steps can only be completed by users with Admin permissions in Humanitru. - The Square integration must be enabled for your organization before it can be connected. > **Note:** If you do not see the option to connect Square in your database, please contact your Customer Success Manager. **Overview** Your database can be configured to automatically integrate with your Square account, importing transaction and constituent information on a nightly basis. This integration helps eliminate manual imports by automatically bringing completed Square transactions into Humanitru and associating them with the appropriate constituent records. **Setup** To connect your Square account to Humanitru: 1. Log in to your database. 2. Click **Settings** from the left-hand navigation menu. 3. Scroll to the **Integrations** section. 4. Locate **Square** and click **Connect**. 5. Sign in to your Square account when prompted. 6. Review the requested permissions and authorize Humanitru to access your Square data. 7. Once authorization is complete, you'll be returned to Humanitru and your connection status will display as **Connected**. ### How Authentication Works Humanitru uses Square's secure OAuth authentication process. During setup: 1. You'll be redirected to Square's login page. 2. You'll sign in and authorize Humanitru. 3. Square will securely provide Humanitru with authorization credentials. 4. Humanitru will begin syncing eligible transaction data during the nightly sync. **What We Push Into Square** This integration is pull-only. Your database does not send any data back to Square. No constituent, donation, campaign, or transaction information is pushed from Humanitru into your Square account. ### Initial Sync When the integration runs for the first time, Humanitru imports completed transactions from the previous 60 days. If you need to import transactions older than 60 days, please contact your Customer Success Manager. ### Ongoing Syncs After the initial import, Humanitru automatically retrieves newly completed transactions during each nightly sync. ### Transactions That Are Not Imported The integration does not import: - Orders without customer information - Authorization-only transactions - Voided authorizations - Failed or unsettled payments - Transfer and payout activity - Catalog updates - Balance adjustments - Refunds or partial refunds Only transactions associated with **completed orders** are eligible for import. ### Recurring Transactions Recurring subscription payments are imported as separate transactions each time a charge is successfully processed. **Constituent Mapping** The following Square fields are used to create constituent records in the database.  | Square Field | Humanitru Field | | --- | --- | | Email Address | Email | | Given Name | Email Salutation | | Given Name + Family Name | Name | | Phone Number | Phone | | Address (line1, line2, city, state, postal\_code, country) | Address | Note: The fields are only updated if the constituent data is blank. ### Constituent Matching When importing transactions, Humanitru first attempts to locate an existing constituent using: 1. Email Address 2. Name If no match is found, a new constituent record is created. ### Important Note About Existing Data To protect your data, Humanitru only fills in blank constituent fields. Existing constituent information will never be overwritten by Square data during future syncs. For example, if a constituent record already contains an address, Humanitru will not replace that address with updated information from Square. **Transaction Mapping** Imported Square transactions are stored as Actions within Humanitru. Information imported may include: | Square Field | Stored In Humanitru | | --- | --- | | Order ID | Action Notes | | Transaction Date | Action Date | | Transaction Amount | Action Notes | | Purchased Items | Action Notes | | Product Information | Campaign Assignment (when applicable) | ### Campaign Mapping When a transaction includes a Square catalog item, Humanitru can automatically create and associate campaigns based on the purchased item. For products with variations, Humanitru uses the variation name when available. **Example:** Product: Annual Membership Variations: - Individual - Family In this scenario, Humanitru would create campaign associations using: - Individual - Family rather than the parent item name. Custom or free-form line items that are not connected to a Square catalog item are not used for campaign creation. > **Tip:** Action records imported from Square can be converted into Donations, Memberships, or other action types using Smart Automations. **Sync Details** ### Timing **Frequency:** Nightly The Square integration syncs once each night and does not update in real time. ### Action Matching Each imported transaction includes the Square Order ID. This unique identifier helps prevent duplicate transactions from being created, even when sync windows overlap. **Best Practices** To get the most value from the Square integration: ### Collect Email Addresses at Checkout Email addresses significantly improve constituent matching and help ensure transactions are connected to the correct supporter record. ### Use Consistent Product Catalogs Maintaining a structured Square catalog helps create cleaner campaign reporting and more meaningful segmentation inside Humanitru. ### Create Dedicated Donation Products If you process donations through Square, consider using dedicated donation products or catalog items to simplify reporting and automation workflows. **Frequently Asked Questions** ### Does the integration sync in real time? No. The Square integration syncs nightly. ### Will refunds appear in Humanitru? Not currently. Refunds and partial refunds are not imported. ### What happens if a transaction has no customer information? Transactions without associated customer records are skipped during the import process. ### Can Humanitru update constituent information from Square? No. Humanitru only fills blank constituent fields and will never overwrite existing constituent data. ### Can imported transactions be converted into Donations or Memberships? Yes. Smart Automations can be used to convert imported Square actions into other action types within Humanitru. ### Any additional questions? Ask your Customer Success Manager. - [Humanitru Database](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#main-content) - [Getting Started](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#getting-started) - [General Alpine Training](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#general-alpine-training) - [Settings](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#settings) - [Integration](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#integration) - [Dashboard](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#dashboard) - [Constituents](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#constituents) - [Reports](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#reports) - [Actions](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#actions) - [Tags](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#tags) - [Campaigns](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#campaigns) - [Notifications](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#notifications) - [Stewardship Automation](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#stewardship-automation) - [Donor Insights](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#donor-insights) - [Grant Management](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#grant-management) - [Bulk Uploader](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#bulk-uploader) - [Opportunity Pipelines](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#opportunity-pipelines) - [Payment Processors](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#payment-processors) - [Pledge](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#pledge) - [Training By Role: Executive Director](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#training-by-role-executive-director) - [Training By Role: CDO/Director of Development](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#training-by-role-cdo-director-of-development) - [Training By Role: Marketing/Communications](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#training-by-role-marketing-communications) - [Training By Role: Event Coordinator](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#training-by-role-event-coordinator) - [Training By Role: Accounting](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#training-by-role-accounting) - [Training By Role: Program Management](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#training-by-role-program-management) - [Training By Role: Database Admin/Fundraising Coordinator](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#training-by-role-database-admin-fundraising-coordinator) - [Training By Role: Volunteer Management](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#training-by-role-volunteer-management) - [Households](https://kbhelp.humanitru.com/knowledge/humanitru-database?hsLang=en#households) - [Fundraising Pages](https://kbhelp.humanitru.com/knowledge/fundraising-pages?hsLang=en#main-content) - [General](https://kbhelp.humanitru.com/knowledge/fundraising-pages?hsLang=en#general) - [Recurring Donations](https://kbhelp.humanitru.com/knowledge/fundraising-pages?hsLang=en#recurring-donations) - [Evergreen Events](https://kbhelp.humanitru.com/knowledge/evergreen-events?hsLang=en#main-content) - [Getting Started with Evergreen](https://kbhelp.humanitru.com/knowledge/evergreen-events?hsLang=en#getting-started-with-evergreen) - [Event Management](https://kbhelp.humanitru.com/knowledge/evergreen-events?hsLang=en#event-management) - [Volunteer Management](https://kbhelp.humanitru.com/knowledge/evergreen-events?hsLang=en#volunteer-management) - [Program Management](https://kbhelp.humanitru.com/knowledge/evergreen-events?hsLang=en#program-management) - [Integrations](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#main-content) - [ACME](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#acme) - [Active Campaign](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#active-campaign) - [Constant Contact](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#constant-contact) - [DonorSearch](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#donorsearch) - [Eventbrite](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#eventbrite) - [Fundraise Up](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#fundraise-up) - [Galaxy Digital](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#galaxy-digital) - [GoFundMe Pro / Classy](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#gofundme-pro-classy) - [Handwrytten](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#handwrytten) - [Latitude Learning](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#latitude-learning) - [Mailchimp](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#mailchimp) - [Microsoft Outlook](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#microsoft-outlook) - [MinistrySafe](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#ministrysafe) - [NCOA](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#ncoa) - [PayPal](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#paypal) - [Quickbooks](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#quickbooks) - [Roller](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#roller) - [RunSignUp](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#runsignup) - [Sage Intacct](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#sage-intacct) - [Shopify](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#shopify) - [SmartyStreets](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#smartystreets) - [Square](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#square) - [Stripe](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#stripe) - [TicketSpice](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#ticketspice) - [Ticketure](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#ticketure) - [Twilio](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#twilio) - [VolunteerHub](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#volunteerhub) - [Windfall](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#windfall) - [WooCommerce](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#woocommerce) - [Cuseum](https://kbhelp.humanitru.com/knowledge/integrations?hsLang=en#cuseum) - [Product Updates](https://kbhelp.humanitru.com/knowledge/product-updates?hsLang=en#main-content) - [2026](https://kbhelp.humanitru.com/knowledge/product-updates?hsLang=en#2026) [![Chill listening crop-3](https://kbhelp.humanitru.com/hs-fs/hubfs/Humanitru-logo-green-horiz-lo-rez-web-main-RGB-3-1.png?width=100&height=24&name=Humanitru-logo-green-horiz-lo-rez-web-main-RGB-3-1.png "Chill listening crop-3")](http://humanitru.com) Copyright © 2026, Humanitru