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. 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.
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:
2) Choose and configure payment methods
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.
Click on Create secret key.
Choose Powering an integration you build and click continue.
Give it the name "beabee live".
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 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.
Copy the publishable API key and paste it into the table in Google Drive.
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.
If you already have a configured beabee instance and would like to activate a new payment method, please contact support@beabee.io.
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.
If the payment method is not visible in your list, you may need to complete your account verification first.
Credit/debit card (with possible Apple Pay and Google Pay)
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.
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.
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.
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.
SEPA: Euro direct debit
Go to your payment methods settings, search for SEPA Direct Debit, and click enable to activate it.
Also, you need to verfiy your SEPA account. Request the verification via the payment method settings and stripe guides you through the verification flow.
Finally, request recurring payments for SEPA.
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.
BACS: UK direct debit
Go to your payment methods settings, search for BACS, and click enable to activate it.
Also, you need to verfiy your BACS account. Request the verification via the payment method settings and stripe guides you through the verification flow.
Finally, request recurring payments for BACS.
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.
PayPal
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.
After that, go to your payment methods settings, search for PayPal, and click Enable to activate it.
Next, connect your PayPal account to Stripe by following the guided setup process.
Finally, request approval for recurring payments through Stripe.
The verification of your PayPal account can take up to 5 days.
Ideal: Dutch payment method
Go to your payment methods settings, search for Ideal, and click enable to activate it.
3) Optional: Configure how you want subscriptions to handle things like failed payments
Go to settings, billing and click on subscriptions and emails.
Scroll down to manage failed payments for subscriptions.
We recommend marking subscriptions as unpaid if a payment fails as this means Stripe will continue to try to bill a user next month.
Done! Wait for the beabee team to fully complete the setup of your Stripe integration.
Optional: Stripe sends automatic emails, which you can configure as needed. You can find more information here.
Last updated