Docs

Stripe

Key Creation (if applicable)

  1. Please log in to your Stripe account.
  2. In your Stripe dashboard, click on Developers.
  3. Click on API Keys.
  4. You can choose to create a new Secret Key if you want to.
  5. Copy the Publishable key and Secret key.

Adding Source on Reveal dashboard

  1. Copy the following keys that we created from the previous steps:
    • Secret Key
    • Publishable Key
  2. Go to your Reveal dashboard for Transactions or Settlements
  3. Click on Sources > Add a new source
  4. Select Stripe
  5. Paste the keys in the relevant fields
  6. Add an alias
  7. Click on Connect

Using Stripe's restricted keys

You can use Stripe's Restricted API keys instead of Secret keys. It is fairly simple to create Stripe-Restricted keys. Here we provide both the TLDR and the elaborate versions of the same.

TLDR version

  1. Navigate to this link OR Developers :arrow_right: Create Restricted Key and give an identifiable name to the restricted key. You may want to name this 'Reveal' and give reveal.io as the website (if Stripe asks for this).
  2. Copy this restricted key and store them in a secure and retrievable place.
  3. On the Reveal dashboard you will be asked for:
    1. Secret Key: Enter the restricted key copied on Step 2.
    2. Publishable Key: Copy the publishable key from Developers >> API keys or this link on the Stripe dashboard.
    3. Alias: Enter an identifier (business name or MID) for this Stripe account corresponding to the keys.

Here is the list of permissions to be provided to every RESOURCE TYPE.

RESOURCE TYPEPERMISSIONSCONNECT PERMISSIONS
All core resourcesReadRead
All Checkout resourcesReadRead
All Billing resourcesReadRead
All Connect resourcesRead-
All Orders resourcesReadRead
All Reporting resourcesReadRead
All webhook resourcesWrite-
Stripe CLI permissionsNoneNone
All Payment Links resourcesNoneNone
All Terminal resourcesReadRead
TaxReadRead
RadarReadRead
All Climate resourcesReadRead

Longform version

**Steps to create restricted keys are as follows: **

  1. Login to your Stripe Account
  2. Go to Developers > Create Restricted Key.
  1. Provide a Key Name. This is an identifier of your choice.
  2. In the resource type, provide Write access to:
    • All Webhook Resources
  3. And in the same resource type section, provide Read access to the following resources:
    • All Core Resources,
    • All Checkout Resources
    • All Billing Resources
    • All connect resources
    • All Order resources
    • Stripe CLI permissions
    • All Payment Link Resources
    • Tax
    • Terminal Resources
    • Radar
    • Climate resources
    • All Reporting Resources
  4. Click on Create Key in the bottom right corner of the screen.
  5. Copy the keys and store it in a secure and retrievable place.
  6. Use this restricted key along with the publishable key in your Reveal dashboard to add Stripe as a source.

Was this article helpful?