Guide

Add Connector - Stripe

Overview

Airbyte is a data integration platform that lets you connect third-party services like Stripe to your data warehouse or lakehouse. By adding a Stripe connector, you enable real-time synchronization of your Stripe payment data—including transactions, balance information, and customer details—into your analytics or operational systems. This workflow walks you through configuring the connector with your Stripe API credentials and optional settings to control which data Airbyte fetches during each sync.

Before you begin

  • Access to your Airbyte workspace (app.airbyte.ai) with permission to add connectors
  • Active Stripe account with API access enabled
  • Stripe Secret Key (obtained from your Stripe Dashboard under Developers > API Keys)
  • Stripe Account ID (your 10-character numeric account identifier, e.g., acct_1A1a1a1a1a)

Step by step

1
ClickAdd Connector

Navigate to the Connectors section in Airbyte and click the 'Add Connector' button to begin the setup process.

Step 1
2
ClickStripe

Select 'Stripe' from the list of available source connectors. Airbyte will open the Stripe connector configuration form.

Tip. If you do not see Stripe in the list, use the search bar to quickly locate it by typing 'Stripe'.
Step 2
3
ClickSecret Key

Click on the 'Secret Key' field to activate the text input box where you will paste your Stripe API credentials.

Step 3
4
TypeSecret Key

Enter your Stripe Secret Key into the field. Obtain this key from your Stripe Dashboard under Developers > API Keys (the key beginning with 'sk_').

Tip. For security, never share this key in code repositories or documentation. Airbyte stores it encrypted.
Warning. Using a restricted or revoked API key will cause authentication failures. Ensure the key is active and has appropriate permissions to read Stripe resources.
5
ClickAccount ID

Click on the 'Account ID' field to activate the text input box where you will enter your Stripe account identifier.

Step 5
6
TypeAccount ID

Enter your Stripe Account ID into the field. This is typically a 10-character identifier starting with 'acct_' (e.g., acct_1A1a1a1a1a), found in your Stripe Dashboard account settings.

Tip. You can find your Account ID in the Stripe Dashboard under Settings > Account or by inspecting your API key details page.
7
Clickgeneric

Click in a neutral area of the form (such as the background) to confirm your Account ID entry and prepare to configure optional settings.

Step 7
8
ClickInclude Balance Transactions

Enable the 'Include Balance Transactions' checkbox if you want Airbyte to sync detailed transaction history from your Stripe account. Leave unchecked if you only need summary data.

Tip. Enabling this option increases sync time and data volume, but provides complete transaction visibility for auditing and analysis.
Step 8
9
Clickgeneric

Click in a neutral area of the form again to confirm the balance transactions setting and proceed to the next optional configuration.

Step 9
10
ClickInclude Balance

Enable the 'Include Balance' checkbox if you want Airbyte to fetch your current account balance information during syncs. Leave unchecked if balance data is not needed.

Tip. Balance data is lightweight and useful for real-time dashboards showing account health and available funds.
Step 10
11
ClickSave

Click the 'Save' button to finalize and save the Stripe connector configuration. Airbyte will validate your credentials and create the connector.

Tip. After saving, Airbyte will test the connection automatically. If validation fails, review your Secret Key and Account ID for accuracy.
Warning. Do not close or navigate away from this page until you see a success confirmation. Incomplete configurations will not be saved.
Step 11

Confirm it worked

  1. 1The Stripe connector appears in your list of configured connectors with a green checkmark or "Connected" status
  2. 2You see a confirmation message stating the connector was successfully saved
  3. 3The connector detail page displays your Account ID and shows the balance transaction and balance inclusion settings you configured
  4. 4You can create a new connection using this Stripe connector in the Connections tab

Common issues

Keep reading