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 Stripe Keys
You can register Stripe keys at anytime during project creation or specifically add them into the authorization card. Once added they are reusable without re-entry.
To add them to the authorization card you will need to copy the
Secret Key and
Publishable 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 and Publishable keys into the right boxes. Then, click, Save. XcooBee will save this in a one-way fashion with specific encryption for access for your account only. You will not be able to retrieve it again via the UI. You can only replace the keys 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 Keys
The Stripe keys are used inside each of the consent and payment projects where you have selected the Stripe payment processing option. When you add the Stripe payment section to your campaign or project, or select Stripe as payment provider you will be asked to provide these keys if you have not already authorized them before.
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 consider 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.