Stripe (Transactions) Integration

This article covers how to synchronize transactions from Stripe-powered pages into your Alpine Database

Overview

Your Alpine database can be configured to automatically integrate with your Stripe account, pulling transactions and customers on a nightly basis into your database. Accepting donations via Stripe? Humanitru has you covered—no need to manually export Stripe reports and upload them into Humanitru; this integration will save you time and make sure every supporter (and gift) is accounted for.

What we push into Stripe

Since the goal of this integration is to pull information from Stripe, your Humanitru Alpine database will not push any information into your Stripe account—it will only pull information.

What we pull from Stripe

Every night, Humanitru Alpine database will retrieve a list of Stripe users and completed transactions to synchronize with your database, including their contact details such as email and name.

Constituent Mapping

Stripe Field	Humanitru Alpine Field
Name	Name
Email	Email
Address (line1, line2, city, state, postal_code, country)	Address
Phone	Phone

Action Mapping

Stripe Field	Humanitru Alpine Field
Date Created	Action Date
Amount	Amount
Charge ID	Added to the Notes section
On Behalf Of	Added to the Notes section
Status	Added to the Notes section
Receipt Number	Added to the Notes section
Statement Descriptor: The description that will appear on the user's credit card statement	Added to the Notes section
Statement Descriptor Suffix: Suffix is the suffix that will appear on the user's credit card statement. (If any)	Added to the Notes section

 

Setup Process

Before you can begin syncing transactions from Stripe into your Alpine database, you will first need to reach out to our Support Team (support@humanitru.com) with your Stripe Secret API Key, or your Restricted API Key so that we can create the Stripe integration in your Humantiru database. Please note that those keys do not start with "pk"

Creating the integration means that the field to connect to Stripe will appear on the Settings page under the Integrations section when logged into your Humantiru database. 

Creating a Restricted Key in Stripe

Once enabled, to connect the integration and start syncing transactions follow these steps.

1. Log into your organization's Stripe account
2. Navigate to the API keys page
3. Click Create restricted key and enter a name in the Key name field e.g. Humanitru Key
4. Next, under the Resources section, make sure that the “Charges” Resource is set to “Read”.
5. Click Create key.
6. The dialog displays the new key value. Copy it by clicking it.
7. Save the key value. You can’t retrieve it later.
8. In the Add a note field, enter the location where you saved the key and click Done.
   
   

Connecting Stripe to Alpine

1. Copy and paste the newly created restricted key into the Stripe field in Alpine.
   
   
2. Click Connect.

Once connected, the integration will sync constituent records and successfully completed transactions made from Stripe pages to your Alpine database on a nightly basis.