This guide walks you through connecting a payment gateway and enabling customer tipping on a booking widget in CaptainBook.
After setup, customers see tipping options at checkout and payments route through your connected gateway.
Step 1: Open the Payments gateways page
From the sidebar, go to Payments. The Payments gateways page lists every connected processor and lets you add new ones.
Step 2: Add a new payment gateway
Click Add a new payment gateway in the top right. The Select a payment gateway modal opens with the available providers.
Available providers
Stripe — fully available.
Viva.gr — coming soon.
Worldline — coming soon.
Step 3: Connect Stripe
Click Stripe. You are redirected to Stripe's OAuth flow where you authorize CaptainBook to connect to your Stripe account. You need a real Stripe account to complete this step. Once authorized, the gateway appears on the Payments gateways page.
Step 4: Open your widget's Payments tab
In the sidebar, go to Channel manager → Direct bookings.
Click your widget (for example, Default widget).
Click the Payments tab in the widget sub-navigation.
Step 5: Configure tipping
In the Tipping card, open the strategy dropdown and choose one:
Only ask for tips after the booking
Always ask for tips
Never ask for tips
Enter the percentage for Good threshold (for example,
10).Enter the percentage for Great threshold (for example,
15).Enter the percentage for Amazing threshold (for example,
20).
Step 6: Save tipping preferences
Click Update tipping preferences to save the configuration for this widget.
Step 7: Assign a payment gateway to the widget
In the Payments card on the same tab, select the connected gateway you want this widget to use, then click Update payment gateway. If no gateway is connected, use the inline link to return to the Payments gateways page and add one.