1. Home
  2. Docs
  3. How To
  4. Setup Stripe Keys

Setup Stripe Keys

If you are collecting payments through XcooBee and Stripe integration you need to setup your connection to Stripe.

XcooBee will process the setup of your Stripe customer creation, payment subscriptions, and cancellations. This will mirror users interactions with their consent and you will see this reflected in the consent center as well.

Your Stripe account has generally two sets of keys: test keys and production keys, each with its own key-pair of Publishable key and Secret Key.

You can access them from the Stripe dashboard. The following image shows you where you can find your live keys.

The key pairs work in concert and you will need both.
Your test keys will have the characters “test” in the content of the key while your production keys will normally have the characters “live” in the content of the key.

Using The Secret Key

You will need to copy the Secret Key to the XcooBee Stripe Authorization card. You access the XcooBee authorization screen from the Settings:Authorizations area of your account. The settings are normally found under the drop down menu with your name on the top right corner of your XcooBee dashboard.

Here is a direct link:
https://app.xcoobee.net/user/settings/authorizations

Click on the Connect button inside the Stripe box and paste your Secret Key. Then, click, Save. XcooBee will save this in a one-way fashion with specific encryption for access for your account processes. You will not be able to retrieve it again via the UI. You can only replace the key by repeating this process.

A fully authorized setup would look like this.

You can disconnect or delete your Stripe connection, by hovering over the Connect button until you see the label change to a red Disconnect. Clicking on the Disconnect button will start the de-authorization process for you.

Using the Publishable Key

The Publishable key is used inside each of the consent campaigns and your XcooBee projects with Stripe payments. When you add the Stripe payment section to your campaign data, or select Stripe as payment provider you will be asked to provide this key.

Process

We recommend that you start by connecting your test keys and switch to your production keys once you have tested your processes.

When you copy and paste your keys, please ensure that you do not copy extra spaces or line feeds at the beginning or end.

Once you connect your production keys in your authorization, all your test keys will stop working. Please coordinate accordingly.

Restricted keys

We recommend that you look at creating restricted keys for use with XcooBee. These will take the place of your Secret Key.

To access the Stripe API Key Manager, click on the text “API keys” for either your Test or Live keys dashboard tile.

Here is an example how to reach your test API Key Manager:

Please refer to the Stripe documentation on keys how to do create a restricted key:

https://stripe.com/docs/keys

You will need to enable the following permissions:

  • Charges: Write
  • Customers: Write
  • Products: Write
  • Sources: Write
  • Plans: Write
  • Subscriptions: Write
  • Webhook Endpoints: Write

All other permissions can be left at their default.

Was this article helpful to you? Yes No

How can we help?