Stripe Manual (your own keys)

Stripe Manual connects your own existing Stripe account to Pay2Book. It is available on the Pro plan and gives you full control of your Stripe account. To set it up you give Pay2Book two things from Stripe: a restricted API key (so Pay2Book can create checkouts and refunds on your account) and a webhook signing secret (so Stripe can tell Pay2Book the moment a payment succeeds).

You do all of this in Settings → Stripe in your Pay2Book console.

Tip

Most owners are better off with Stripe Connect, which needs no keys or webhook. Choose Manual only if you specifically want to use your own Stripe account directly.

Caution

Without the webhook, a booker can pay but the booking is never confirmed. Both the key and the webhook are required.

1. Create a restricted API key

A restricted key gives Pay2Book only the permissions it needs - nothing more.

1. Open your Stripe API keys page: dashboard.stripe.com/apikeys.

2. Select Create restricted key.

3. Give it a name (for example, Pay2Book) and set these permissions:

   Resource	Permission
   Checkout Sessions	Write
   PaymentIntents	Write
   Refunds	Write
   Balance	Read
   Webhook Endpoints	Read

   Leave every other permission as None.

4. Create the key and copy it (it starts with rk_).

5. In Pay2Book, go to Settings → Stripe and paste the key into Secret key.

Tip

Use a test-mode key while you are testing, and a live-mode key when you go live. The webhook (below) must be created in the same mode.

2. Add the webhook

The webhook is how Stripe tells Pay2Book that a payment has succeeded.

1. In Pay2Book’s Settings → Stripe, copy your Webhook URL (it is unique to your account).

2. In Stripe, open Workbench → Webhooks → Add destination, or go straight to dashboard.stripe.com/workbench/webhooks/create.

3. For events, choose Your account, then All events. Search for and tick both of these, then Continue:

   • checkout.session.completed
   • payment_intent.created

4. For the destination type, choose Webhook endpoint. Paste your Pay2Book Webhook URL as the Endpoint URL, then Create destination.

5. Open the new destination and copy its signing secret (it starts with whsec_).

6. Back in Pay2Book’s Settings → Stripe, paste it into Webhook signing secret and save.

3. Test the connection

Once the key and webhook secret are saved, open the Health page in your Pay2Book console and run Test setup. It checks that the key works, the webhook is registered, and the right events are subscribed - all without taking a real payment.

The results show exactly what is and is not working. Fix anything it flags - in the example above, the key is fine but the webhook still needs adding.

Note

If the test reports a missing endpoint or the wrong events, re-check step 2 - the most common issues are using the wrong Stripe mode (test vs live) or missing one of the two events.