Skip to content
Last updated

Stripe integration

Stripe is a payment processing platform that provides APIs for accepting payments, managing subscriptions, and handling invoices. Integrating Stripe with Frontegg allows your application to manage customers, charges, payment intents, invoices, products, prices, subscriptions, and refunds on behalf of your users through API key authentication.


Prerequisites

  • A Stripe account (free or paid plan)
  • Access to the Stripe Dashboard

Connect Stripe

Step 1: Open the API keys page

Log in to your Stripe Dashboard. In the bottom toolbar, click Developers, then select the API keys tab. This page displays your existing keys and allows you to create new restricted keys.

Stripe API keys page

Step 2: Create a restricted key

In the Restricted keys section, click the Create restricted key button. A dialog appears asking how you will use this API key. Select Building your own integration and click Continue.

Create a restricted key dialog

Step 3: Name the key

On the Create restricted API key page, enter Frontegg Integration (or any descriptive name) in the Key name field.

Key name field

Step 4: Set Core permissions

In the Core section of the permissions table, set the following resource types to Write (which also grants Read access):

Resource typePermission
CustomersWrite
Charges and RefundsWrite
Payment IntentsWrite
ProductsWrite

Leave all other Core resource types set to None.

Stripe Core permissions

Step 5: Set Billing permissions

Scroll down to the Billing section and set the following resource types to Write:

Resource typePermission
InvoicesWrite
PricesWrite
SubscriptionsWrite

Minimum required permissions

For read-only access, set the resource types above to Read instead of Write. Write permission is required for creating or modifying records.

Stripe Billing permissions

Step 6: Create the key

Scroll to the bottom of the page and click Create key. The restricted key is now created and appears in the Restricted keys section of the API keys page.

Keep your credentials secure

You can only reveal a restricted API key once. Copy it immediately after creation and store it in a safe location. Never share or commit your API key to version control.

Stripe restricted key created

Step 7: Copy the key token

Click the copy icon next to the restricted key token to copy it to your clipboard. You will need this key to configure the integration in the Frontegg portal.

Configure the Frontegg portal

Once you have your restricted API key from the steps above, enter it in the integration configuration page of the Frontegg portal:

  1. Open the Frontegg portal and navigate to [ENVIRONMENT] → Integrations → Stripe.
  2. Enter the API key in the corresponding field.
  3. Select the required scopes.
  4. Click Save.

Additional resources