On This Page
Stripe is a payment gateway that facilitates payments (in person or online) by transferring money between a merchant account and a payment processor. It can be incorporated into websites and mobile applications and provides technical, fraud prevention and banking infrastructure to facilitate online payments.
For creating Pipelines using this Source, Hevo provides you a fully managed BigQuery data warehouse as a possible Destination. This option remains available till the time you set up your first BigQuery Destination irrespective of any other Destinations that you may have. With the managed warehouse, you are only charged the cost that Hevo incurs for your project in Google BigQuery. The invoice is generated at the end of each month and payment is recovered as per the payment instrument you have set up. You can now create your Pipeline and directly start analyzing your Source data. Read Hevo Managed Google BigQuery.
An active Stripe account with either Administrator or Developer role. Read Teams and user roles.
Either a Restricted API Key or a Secret Key, which allows Hevo to read your Stripe data. Read Creating the API Key.
Configuring Stripe as a Source
Perform the following steps to configure Stripe as a Source in Hevo:
Click PIPELINES in the Asset Palette.
Click + CREATE in the Pipeline List View page.
In the Select Source Type page, select Stripe.
In the Configure Your Stripe Source page, specify the following:
Pipeline Name: A unique Name for your Pipeline.
API Key: The API key that you created in Stripe to enable Hevo to read your Stripe data.
Click TEST & CONTINUE.
Proceed to configuring the data ingestion and setting up the Destination.
Creating the API Key
You may create a Restricted API Key or a Standard Secret API Key and share it with us. The restricted API key gives you more control as to which objects you want to give Hevo access to. If you have an Administrator or Developer role, your API keys are always available in the Stripe Dashboard. Read Stripe’s documentation on API keys.
To create a restricted API Key:
Go to the Developer Dashboard.
Disable the Viewing test data option if it is enabled, in order to view live data.
Scroll down to the Developers menu on the left and click API Keys.
Click Create restricted key.
Specify a unique name for this API Key. For example, Stripe connector for Hevo.
READpermission for each resource category, to apply it to all the resources within it:
Once done, click Create API Keys at the bottom of the page.
On your dashboard under the Restricted Keys section, click Reveal key token for the API keys that you just created, and copy it. You will provide this key while setting up Stripe as a Source in your Hevo Pipeline.
Stripe informs the user of a change in an object in their account through an event. For example, when a charge succeeds, it creates a
charge.succeededevent. Stripe maintains a record of all the events that it created for the past 30 days in an
eventsobject. Hevo refers to this
eventsobject while replicating the data to the Destination to make sure all the deletes and updates are duly accounted for.
Make sure to select Stripe’s
eventsobject while creating your Pipeline, else, Hevo will not be able to capture any updates. To enable Hevo to capture deletes for your Pipeline, you need to contact Hevo Support.
Pausing a Pipeline for more than 30 days can lead to a loss of data, as the
eventsobject tracks updates and deletes of the past 30 days only.
|Default Pipeline Frequency||Minimum Pipeline Frequency||Maximum Pipeline Frequency||Custom Frequency Range (Hrs)|
|30 Mins||15 Mins||24 Hrs||1-24|
Note: The custom frequency must be set in hours, as an integer value. For example, 1, 2, 3 but not 1.5 or 1.75.
Historical Data: Hevo ingests your historical data in reverse order, starting from the latest to the earliest Event for all Pipelines. This enables you to have quicker access to your most recent data.
- For Pipelines created before Release 1.80: Hevo ingests historical data on the basis of the offset selected at the time of creating the Pipeline. By default, it fetches the entire past data associated with your Stripe account.
- For Pipelines created after Release 1.80: You can select the Historical Sync Duration as per your requirement while creating a Pipeline. Default value: 3 Months.
Note: The time taken to fetch the historical data depends on the number of days selected at the time of creating the Pipeline. Hevo defaults this period to 30 days. If required, you may customize it to any number or even select the starting date of your Stripe account.
Incremental Data: Once the historical load is completed, each run of the Pipeline fetches the next available new and modified data. Hevo also fetches the Events object from Stripe, which tracks the updates and deletes made in the last 30 days, in order to sync the related Events with your Destination.
Updated and Deleted Objects
Hevo replicates the updated and deleted records using the Stripe
events object. For the deleted records, Hevo sets the
is_row_deleted column to True and the
deleted_timestamp column to the timestamp when the record was deleted in Stripe, in the ingested data and the Destination.
Hevo identifies the
updated and the
deleted records from the Stripe
events object and replicates that information for the following objects:
|Object Name||Event Type Tracked|
Note: As Hevo also replicates the deleted data now, you might see more Events in your Destination than in the Source.
Schema and Primary Keys
Hevo uses the following schema to upload the records in the Destination:
The following is the list of tables (objects) that are created at the Destination when you run the Pipeline:
|Account||Contains all the properties of a Stripe account, such as its current email address and whether the account is enabled to make live charges.|
|Application Fee||Contains the transaction fee amount collected on top of a charge made for a user.|
|Application Fee Refund||Contains the reference to the application fee collected from the user and the portion of it to be refunded in case of a transfer reversal.|
|Authorization||Contains the information that must be approved for any purchase to be completed successfully from an issued card.|
|Balance transaction||Contains the details of funds moving through an account. It is created for every in-flow and out-flow of funds to and from your Stripe account. Read Balance transaction types.|
|Bank Account||Contains information of the bank accounts connected to the payment methods of the customers object.|
|Card||Contains details such as cardholder, and the month and year of expiry of the physical or virtual cards that are issued to the cardholders.|
|Cardholder||Contains information such as the name, email, and phone number of the individual or business entity who issues a card.|
|Charge||Contains the details of a charge made on a credit or a debit card. You can retrieve and refund individual charges as well as list all charges. They are identified by a unique, random ID.|
|Credit Note||Contains the adjusted or refunded amount to be added to an already finalized invoice instead of recreating the invoice.|
|Credit Note line item||Contains the individual adjustments or refunds that you are adding to a credit note associated with an invoice.|
|Customer||Contains the details of a customer, such as the name, email, default payment method and delinquency status.|
|Customer Balance Transaction||Contains the amount by which a customer’s account balance needs to be incremented or decremented.|
|Coupon||Contains the information about a percent-off or amount-off discount you might want to apply to a customer. It can be applied to invoices or orders.|
|Discount||Contains the information such as the beginning and ending of the discount and the coupon object. It represents the actual application of a coupon to a particular customer.|
|Dispute Balance Transaction||Contains the mapping between each dispute and transaction entities.
It is a custom table generated by Hevo to maintain data sanity.
|Fee Detail||Contains the detailed breakdown of fees paid for each transaction present in the balance transaction table.|
|File Link||Contains a URL that you can use to retrieve the contents of a file without any authentication.|
|Invoice||Contains the statements of amounts owed by a customer. Invoices are either generated one-off or periodically from a subscription.|
|Invoice Line Item||Contains the details of an invoice, such as amount, currency, period and proration. It is stored inside the invoice object.|
|Payment Intent||Contains the guide for the process of collecting a payment from your customer during a particular session.
Read How intents work to know more about the payment flow followed at Stripe.
|Payment Method||Contains the details of the payment method that a customer has used on one or more payment intent(s) along with details. Supported Payment Methods are Card (card/wallet), FPX, and ideal.|
|Payment Method Details||Contains the detailed data for each payment method that is created on your Stripe Account, will be individually stored in your destination to maintain data sanity.
|Payout||Contains the details of the received funds from Stripe. It is created when you initiate a payout to either a bank account or debit card of a connected Stripe account.|
|Person||Contains the details of the person linked to a Stripe account.|
|Plan (pricing)||Contains the details such as the base price, currency and billing cycle for recurring purchases of products. It helps you track the pricing.|
|Price||Contains the details such as the unit cost, currency, and billing cycle for recurring and one-time purchases of the different products you offer to your customers. For example, a standard or premium version of your service.|
|Product||Contains a list of all offers for the product. Each product can have multiple tiers of pricing plans.|
|Promotion Code||Contains a customer-redeemable code that can be used to create single or multiple codes for a coupon.|
|Refund||Contains the details of a charge that is to be refunded due to a dispute, return, or failure to deliver a service.|
|Review||Contains human-added information to supplement automated fraud detection cases.|
|Setup Intent||Contains the guide for the process of saving a customer’s payment credentials for future payments.|
|Source||Contains the details of a customer’s payment methods that can be used with the Stripe API.|
|Subscription||Contains the details of a recurring charge for a customer. Each subscription has multiple line items.|
|Subscription Item||Contains line item data for each subscription. Each line item is associated with a plan.|
|Subscription Schedule||Contains the attributes required to manage the lifecycle of customers’ subscriptions by predefining existing changes.|
|Top-Up||Contains the amount by which customers wish to top up their Stripe account balance.|
|Transaction||Contains details of funds entering or leaving a Stripe account. A transaction object is created whenever an issued card is used for making a purchase or a refund.|
|Transfer||Contains the details to move funds between Stripe accounts such as amount, destination and so on. It is used when you need to directly move a fund from your customer to the seller who’s offering the service through your platform.|
|Transfer Reversal||Contains the amount that is to be deducted from the seller’s account (who originally received it via a successful transfer) and added back to your platform.|
|Usage Record||Contains a report of a customer’s usage and other metrics that are sent to Stripe.|
- For new and existing Pipelines, Hevo replicates only the data that has been deleted after Release 1.86.
Refer to the following table for the list of key updates made to this page:
|Date||Release||Description of Change|
|Apr-11-2022||1.86||- Updated the Data Replication and Source Considerations sections to add information about how Hevo handles deletes in Stripe objects.|
|Mar-07-2022||1.83||Added information about reverse historical load in the Data Replication section.|
|Jan-24-2022||1.80||Added information about configurable historical sync duration in the Data Replication section.|
|Jan-03-2022||1.79||Added objects to section, Data Model.|
|Oct-25-2021||NA||Added the Pipeline frequency information in the Data Replication section.|
|Aug-23-2021||1.70||Added the section, Source Considerations.|