Stripe

Connect your Stripe app for OAuth in Paragon.

Setup Guide

You can find your Stripe app credentials by visiting your Stripe Connect Settings

Note: You'll need to create a new Stripe app if you don't already have one.

You'll need the following information to set up your Stripe App with Paragon Connect:

  • Client ID

  • Client Secret

  • Scopes Requested

Add the Redirect URL to your Stripe app

Paragon provides a redirect URL to send information to your Stripe app. To add the redirect URL to your Stripe app:

1. Copy the link under "Redirect URL" in your integration settings in Paragon. The Redirect URL is:

https://passport.useparagon.com/oauth

2. Log in to your Stripe and select Settings from the sidebar.

3. Under Connect > Settings scroll to the Integration heading.

4. Under Redirects, press the + Add URI button.

5. Paste-in the redirect URL from Paragon. The redirect URL can be found in Step 1.

6. Press the blue + Add URI button to confirm your changes.

Add your Stripe app to Paragon

1. Select Stripe from the Integrations Catalog.

2. Under Integrations > Connected Integrations > {YOUR_APP} > Settings, fill out your credentials in their respective sections:

  • Client ID:

    1. Log in to your Stripe dashboard.

    2. Select "Settings" from the sidebar.

    3. Under Connect > Settings, scroll to the Integration heading.

    4. Copy the Client ID from "Live mode client ID".

  • Client Secret:

    1. Log in to your Stripe dashboard.

    2. Click on "Developers" in the left sidebar.

    3. Select "API keys" from the drop-down.

    4. Copy your Secret key to use in Paragon Connect.

  • Permissions: Select the scopes you've requested for your application.

Press the blue "Connect" button to save your credentials.

Note: Leaving the Client ID and Client Secret blank will use Paragon development keys.

Connecting to Stripe

Once your users have connected their Stripe account, you can use the Paragon SDK to access the Stripe API on behalf of connected users.

See the Stripe REST API documentation for their full API reference.

Any Stripe API endpoints can be accessed with the Paragon SDK as shown in this example

JavaScript
JavaScript
// You can find your project ID in the Overview tab of any Integration.
// Authenticate the user
paragon.authenticate(<ProjectID>, <Paragon User Token>);
// Create Customer
await paragon.request("stripe", "/v1/customers", {
method: "POST",
body: {
name: "test",
description: "Create customer for test",
}
});
// Get Customers
await paragon.request("stripe", "/v1/customers", {
method: "GET",
});

Using the Connect Portal

The Connect Portal supports Secret API keys and Restricted API keys. While Secret API keys can be used immediately, some configuration is required for Restricted API keys.

The Restricted API key must allow the rak_connected_account_read permission (called “All Connect resources” in the Resource Types section of configuring a Restricted API key). The Connect Portal cannot save the key if it does not include this permission.