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:
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.
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.
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
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:
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.