# Set up payment provider

### Overview

beabee integrates with Stripe for recurring payments. New payments, updates and cancellations are synced from Stripe to beabee so community organisers can track the revenue from their community. Emails such as payment failed and expired payment methods are automatically sent.

***

### Setup

**Before you get started, it is important to note** that beabee does not collect payments from your community and then pay them out to you, but connects your own Stripe account to the software. To start setting up Stripe for beabee, you must first set up an account on [www.stripe.com](http://www.stripe.com). In order to make payments, the account must be verified, i.e. all the necessary information (e.g. your account details) must be stored. Once your account is ready, you can start setting it up. <br>

In your onboarding checklist in Google Drive, you’ll find a table under **Onboarding > Payment Service Provider Linked** containing all the necessary information. At the end of the process, enter all relevant data into the table.

**The process consists of three steps:**

[1) Create an API key](#id-1-create-an-api-key)

[2) Choose and configure payment methods](#id-2-choose-and-configure-your-payment-methods)

[3) Optional: Configure how you want subscriptions to handle things like failed payments](#id-3-optional-configure-how-you-want-subscriptions-to-handle-things-like-failed-payments)

***

#### 1) Create an API key

1\. Create a new secret API key. To do so, go to *Settings*, *Developers* and click on *Manage* *API keys*.

<figure><img src="/files/H8O2Ggn8aczMsinIH7XE" alt=""><figcaption></figcaption></figure>

2. Click on *Create secret key*.

<figure><img src="/files/ItWkCVpTGXgcQ4SBR9rg" alt=""><figcaption></figcaption></figure>

2. Choose *Powering an integration* you build and click *continue*.

<figure><img src="/files/fB2zKLsBqHjjqglFE00s" alt=""><figcaption></figcaption></figure>

3. Give it the name "beabee live".

![](/files/rKSFpMh8PmXagudHzXas)

4. Copy the secret API key and send it to the beabee team. **Important:** **This token must be kept strictly confidential. Anyone with access to it can set up payments on your Stripe account.** For this reason, do not use a Google Doc to share the key. Instead, use [**Onetime Secret**](https://onetimesecret.com/) to transmit the information securely. There, you can generate a secure link containing the key, which you can then send to <support@beabee.io>. The link can only be opened once.

![](/files/bPcEzUjAYXKT8B3d8iO3)

4. Copy the publishable API key and paste it into the table in Google Drive.&#x20;

<figure><img src="/files/xeTUzvCdxlFbTjgNM7lY" alt=""><figcaption></figcaption></figure>

### 2) Choose and configure your payment methods

Now, you need to decide which **payment methods** you would like to offer. beabee currently supports:

* Card: Credit/debit card (with possible Apple Pay and Google Pay)
* SEPA: Euro direct debit
* BACS: UK direct debit
* PayPal
* Ideal: Dutch payment method

Please choose the payment methods you would like to use and **add them to the table in Google Drive**. The beabee team will handle the setup of these payment methods in beabee.

{% hint style="warning" %}
If you already have a configured beabee instance and would like to activate a new payment method, please contact <support@beabee.io>.
{% endhint %}

However, the **activation of the payment methods in Stripe must be completed by you**. To do this, go to *Settings* → *Payments* → *Payment Methods* in your Stripe account. There, you will find all available payment methods.

{% hint style="info" %}
If the payment method is not visible in your list, you may need to complete your account verification first.
{% endhint %}

<figure><img src="/files/CJGY2tXy00tvdEvNg3xi" alt=""><figcaption></figcaption></figure>

<details>

<summary><strong>Credit/debit card (with possible Apple Pay and Google Pay)</strong></summary>

1. In your Stripe account, you can check whether this payment method is already enabled. If it is not enabled yet, click on *View Details* and *enable*.
2. If you would like to use Apple Pay or Google Pay, it is important to add your instance to the **Payment Method Domains**. Click on *Payment Method Domains* and *add the domain* of your beabee instance. Please make sure the domain is entered correctly.

<figure><img src="/files/fO7JySstI4gv5xXGdFfE" alt=""><figcaption></figcaption></figure>

3. After adding you doamin, you need to enable Apple Pay and Google Pay separately. You can also find these options in the list of payment methods. Click on *enable* and Stripe will guide you through the verification flow.
4. In your beabee instance, you can choose whether to **display the Apple Pay and Google Pay icons** in the card button in your Membership Builder. To enable them, log in to your beabee instance, open the *Membership Builder* from the left sidebar, check the option *Show Apple and Google Pay payment icons*, and click *Save*.

</details>

<details>

<summary><strong>SEPA: Euro direct debit</strong></summary>

1. Go to your payment methods settings, search for *SEPA Direct Debit*, and click *enable* to activate it.&#x20;
2. Also, you need to verfiy your SEPA account. Request the verification via the payment method settings and stripe guides you through the verification flow.
3. Finally, request recurring payments for SEPA.

{% hint style="warning" %}
**Note: SEPA Direct Debit** has weekly **processing limits.** New accounts typically start with a limit of **€10,000/week**, but Stripe will show your specific limit during setup. If you expect a significant increase in processing volume, request a limit increase in advance to avoid blocked payments.
{% endhint %}

</details>

<details>

<summary><strong>BACS: UK direct debit</strong></summary>

1. Go to your payment methods settings, search for *BACS*, and click *enable* to activate it.&#x20;
2. Also, you need to verfiy your BACS account. Request the verification via the payment method settings and stripe guides you through the verification flow.
3. Finally, request recurring payments for BACS.

{% hint style="warning" %}
**Note:** For BACS Direct Debit transactions, there is a **limit of £100,000 per transaction**. New users also have a **weekly limit of £10,000**, which can be increased quickly as you process more BACS Direct Debit payments. If you require higher limits, please contact the stripe support.
{% endhint %}

</details>

<details>

<summary><strong>PayPal</strong></summary>

1. To enable PayPal, it is important to add your instance to the Payment Method Domains. Click on *Payment Method Domains* and *add the domain* of your beabee instance. Please make sure the domain is entered correctly.

<figure><img src="/files/fO7JySstI4gv5xXGdFfE" alt=""><figcaption></figcaption></figure>

2. After that, go to your payment methods settings, search for *PayPal*, and click *Enable* to activate it.
3. Next, connect your PayPal account to Stripe by following the guided setup process.
4. Finally, request approval for recurring payments through Stripe.

{% hint style="warning" %}
**The verification of your PayPal account can take up to 5 days.**
{% endhint %}

</details>

<details>

<summary><strong>Ideal: Dutch payment method</strong></summary>

Go to your payment methods settings, search for *Ideal*, and click *enable* to activate it.&#x20;

</details>

#### 3) Optional:  Configure how you want subscriptions to handle things like failed payments

1. Go to *settings*, *billing* and click on *subscriptions and emails*.

<figure><img src="/files/IAS0sdjxNqclg1IGlHOt" alt=""><figcaption></figcaption></figure>

2. Scroll down to *manage failed payments for subscriptions*.
3. We recommend marking subscriptions as unpaid if a payment fails as this means Stripe will continue to try to bill a user next month.

<figure><img src="/files/pyumMnm1aNpTBcAVcHef" alt=""><figcaption></figcaption></figure>

Done! Wait for the beabee team to fully complete the setup of your Stripe integration.

{% hint style="info" %}
Optional: Stripe sends automatic emails, which you can configure as needed. You can find more information [here](broken://pages/LsiYt2tvxe0sQJeuP88c).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.beabee.io/help-center-english/onboarding-guide/set-up-payment-provider.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.