How to Integrate Stripe – Your Booking Platform
Payment Integration Guide

How to Integrate Stripe with YBP

Connect your Stripe account to accept online payments and deposits. Clients pay securely at booking — no more chasing payments during appointments.

🔒
Secure Payments
Stripe is PCI compliant. Client payment data is handled entirely by Stripe — never stored in YBP.
💸
Deposits at Booking
Require a deposit percentage upfront when clients book online — reducing no-shows significantly.
⚡
Real-Time Sync
Webhooks keep YBP updated instantly when a payment succeeds — no manual checking needed.
Step 1
Get Stripe API Keys
→
Step 2
Add Keys to YBP
→
Step 3
Set Up Webhook
→
Step 4
Verify & Test
Step-by-Step
1
Stripe Dashboard

Get your API Keys from Stripe

Log in to your Stripe Dashboard at dashboard.stripe.com. Navigate to Developers → API Keys. You'll see two keys — copy both.

dashboard.stripe.com/apikeys
API Keys — Developers
Publishable Key
pk_live_••••••••••••••••••••
Secret Key
sk_live_••••••••••••••••••••
⚠️
Use Live keys only — not Test keys (which start with pk_test_ / sk_test_). Test keys will not process real payments. Keep your Secret Key private — never share it publicly.
2
YBP Settings

Paste your keys into YBP

In your YBP dashboard, go to Settings → Company and scroll to the Stripe Details section. Set Enable Integration to Yes, then paste your keys into the corresponding fields. Click Save Stripe Settings.

yourbookingplatform.com/settings/company
Stripe Details ℹ
Secure connection to your Stripe account for online payments.
Yes ∨
sk_live_••••••••••••••••••••
pk_live_••••••••••••••••••••
💡
Stripe Details has its own Save button. Clicking Update Company at the bottom of the page does NOT save Stripe settings — you must click Save Stripe Settings specifically.
3
Stripe Webhook

Set up the Webhook in Stripe

The webhook tells Stripe to notify YBP whenever a payment succeeds. Without this, YBP won't know when a client has paid. Go to Stripe Dashboard → Developers → Webhooks and click Add Endpoint (or Create Event Destination).

dashboard.stripe.com/webhooks
Add Webhook Endpoint
https://app.yourbookingplatform.com/Booking/Webhook
payment_intent.succeeded
Webhook URL to paste into Stripe:
https://app.yourbookingplatform.com/Booking/Webhook
Event to select:
payment_intent.succeeded
1️⃣
Go to Stripe → Developers → Webhooks
Find the Webhooks section in your Stripe developer dashboard.
2️⃣
Click "Add Endpoint" or "Create Event Destination"
The button name may vary depending on your Stripe version.
3️⃣
Paste the YBP webhook URL in the Endpoint URL field
Copy the URL exactly as shown above — including https:// at the start.
4️⃣
Search for and select payment_intent.succeeded
This event fires whenever a client successfully pays — triggering YBP to confirm the booking.
5️⃣
Click "Add Endpoint" to confirm
Stripe will now send payment notifications to YBP in real time.
4
Verify

Verify the integration is active & test a payment

Go back to YBP → Settings → Company → Stripe Details and confirm the integration shows as active. Then run a test booking with a real (or test) payment to confirm everything is working end-to-end.

✅
Stripe Integration: Active — payments are being processed
⚠️
If payments aren't confirming, double-check the webhook URL and selected event in Stripe
Test with a real booking to confirm end-to-end
Check Stripe webhook logs if payments don't confirm
Deposits activate automatically once Stripe is connected
Refunds are processed directly from the Stripe dashboard
🎉
You're live! Once verified, clients will be charged the deposit percentage you set in Company Settings when they complete a booking online. No manual payment handling needed.
❓ FAQ
Frequently Asked Questions
Common questions about Stripe integration with YBP.
What's the difference between the Publishable Key and Secret Key?
+

The Publishable Key (pk_live_...) is used on the front end to securely collect card details. The Secret Key (sk_live_...) is used on the server side to process payments. Both are needed for YBP's integration. Never share your Secret Key publicly.

Why do I need to set up a Webhook?
+

The webhook is how Stripe tells YBP "a payment just succeeded." Without it, YBP has no way to know that a client paid — so bookings won't be confirmed automatically. The payment_intent.succeeded event triggers this notification in real time.

My Stripe integration saved but payments aren't confirming — what should I check?
+

Check three things: (1) The webhook URL is exactly https://app.yourbookingplatform.com/Booking/Webhook with no typos. (2) The event payment_intent.succeeded is selected in Stripe. (3) You're using live keys, not test keys. Check Stripe's Webhook logs for error details.

How do I set the deposit percentage clients pay at booking?
+

Go to Settings → Company and find the Enter Deposit Percentage field. Enter a number (e.g. 30 for 30%). This percentage is charged automatically when a client books online via Stripe.

How do I issue a refund to a client?
+

Refunds are processed directly from your Stripe Dashboard — go to Payments, find the transaction, and click Refund. YBP does not process refunds directly, but they will be reflected in Stripe's records.

Stripe is connected! 💳

Your clients can now pay securely online at booking — deposits collected automatically, no manual chasing needed.

  • Get API keys from Stripe
  • Paste keys into YBP Settings
  • Add webhook endpoint in Stripe
  • Select payment_intent.succeeded
  • Verify & test
Open Your Dashboard →