Payment Provider: Connect to Stripe

Stripe is a global online payment platform that makes it easy to accept secure payments by card and other methods. In Bilberry Base it is possible to connect to Stripe to handle customer payments seamlessly directly through the system.

To be able to get the connection right, it is needed to copy different keys and codes found in the Stripe login portal, and add them to the Stripe Settings in Base.

You can access support/documentation from Stripe here. Other helpful links:

• Stripe test mode

• Stripe test cards

Step 1: Settings in Stripe

1. Log in to your Stripe account.

3. Click Webhooks in the pop-up menu.

4. Click Add destination.

5. Find the events to listen to by searching for checkout.session.completed and payment_intent.succeeded.

6. Select both of these as events.

7. Click Continue.

8. Click Webhook endpoint to select where you want to send events.

9. Click Continue.

10. Configure destinations:

    1. Destination name: Is auto generated, and no need to do anything more here.

    2. Endpoint URL: Enter your Bilberry instance + /stripe/webhook in the Endpoint URL field. Example: https://zenith.bilberry.app/stripe/webhook

    3. Description: Optional.

11. Click Create destination.

This takes you to the Event destination overview.

12. Copy the Signing secret.

Step 2: Settings in Base

Next steps will ensure the connection from the Bilberry side.

1. Log in to your Base account.

2. Navigate to the Administrator section in the left side menu.

3. Click Settings.

4. Click Payment provider settings.

5. Click Stripe to enter the Stripe settings.

There are three different keys/webhooks from Stripe that have to be copied and pasted into the fields in Base. These have to be collected from the Stripe account.

6. Paste the already copied Signing secret in to the Stripe webhook secret field.

7. Click Save.

Go back to the Stripe account to collect the Stripe key and Stripe secret.

9. Click Overview in the pop-up menu.

10. Find the API keys section and collect the standard keys.

    1. Publishable key: Has to be pasted in to the Stripe key field in Base.

    2. Secret key: Has to be pasted in to the Stripe secret field in Base.

11. Click on the keys to copy them and paste them in to the fields Base.

12. Click Save.

Very important step!

To being able to receive payments through the widgets, you need to change the payment solution on your website by adding this code to the Bilberry configuration code inside the head-tag on your website:

CODE

window.BilberryWidgetsGlobal.paymentProvider = 'stripe';

Test a Payment

If you want to connect to a test environment before you go live, the same process is used as above, but with test keys instead. After you create a Stripe account, you can find a set of test API keys in the Stripe Dashboard. You can use these API keys to create and retrieve simulated data by making requests to the Stripe API.

Before going live by starting receiving real bookings through Base, we suggest contacting our Support Center to get test bookings deleted from the system – to start using the system with a clean slate.