Payments
Settings > Payments turns online payments on and sets up the payment gateways. For the whole setup, from the currency to the first test payment, see Enable online payments.
General
| Setting | What it does | Default |
|---|---|---|
| Enable online payments | Lets customers pay online through the active gateways. | Off |
| Pending payment expiration time | How long a customer has to complete an online payment, from 5 minutes to 24 hours. It appears when online payments are on. See Which reservations expire. | 1 hour |
| Payment gateways | A card for each gateway: Stripe, PayPal, and Mollie. Enable a gateway on its card, then enter its keys in its own menu item. | All off |
Which reservations expire
A reservation expires when this time passes and all of these are true:
- it is still Pending, and not paid;
- its service has How payment is required set to Online;
- its price is above zero, after any discount;
- online payments are on, with an active gateway.
This includes a reservation that also waits for approval. Bookings of Local or Discretionary services, and free reservations, never expire. An expired reservation appears as Expired in Reservations, until the cleanup job deletes it, without emails. See Payments and refunds.
Do not choose a very short Pending payment expiration time: the confirmation of a payment can reach your site with some delay, and the reservation must not expire meanwhile.
A gateway is active only when its keys are valid and it supports the currency. The menu item of each gateway appears under Payments when online payments are on and the gateway is enabled.
In the menu item of a gateway, enter the keys first: the other options appear once the gateway is active.
Options of every gateway
| Setting | What it does |
|---|---|
| Redirect URL | Where customers return after paying, when TheBooking cannot bring them back to the page with the booking widget. Empty: the home page of the site. A service with its own Redirect uses that address instead. |
| Use sandbox / Use test mode | Takes payments with the test keys, so no real money moves. Turn it off before you go live. |
Stripe
| Setting | What it does | Default |
|---|---|---|
| Publishable Key, Secret Key | The live keys, from the API keys page of the Stripe dashboard. | Empty |
| Publishable Key (test), Secret Key (test) | The test keys, used with Use sandbox. | Empty |
| Send receipt to the customer | Stripe emails a receipt to the email address of the booking form. | Off |
| IDEAL support | Offers iDEAL besides cards. | On |
| Przelewy24 support | Offers Przelewy24 besides cards. | Off |
| Load Stripe.js library | Loads the Stripe library on the page. Turn it off only if another plugin already loads it. | On |
| Stripe webhook URL | The address where Stripe sends payment notifications, once TheBooking has registered it in Stripe. If it differs from the address shown, change it in the Stripe dashboard. | — |
iDEAL works only with the euro, and Przelewy24 only with the euro and the Polish złoty. With another currency, TheBooking turns them off when you save, and shows a warning.
PayPal
| Setting | What it does | Default |
|---|---|---|
| Account email | The PayPal account that receives the payments. With the sandbox, use an email address created in the PayPal sandbox, or payment notifications fail. | Empty |
| Primary email (optional) | The primary email address of the PayPal account, when payments go to another address of the same account. Payments are checked against it. | Empty |
| API Client ID, API Client Secret | Needed to refund payments from TheBooking. | Empty |
| API Client ID (test), API Client Secret (test) | The same, for the sandbox. | Empty |
| Debug (IPN) | Records the payment notifications that PayPal sends, to investigate a problem. Turn it off when you are done. | Off |
Use a Business or Premium PayPal account: Personal accounts are not meant for commercial payments.
Mollie
| Setting | What it does | Default |
|---|---|---|
| Live API key | From Developers > API keys in the Mollie dashboard. | Empty |
| Test API key | The key for test payments. With only the test key, test mode is on. | Empty |
| Mollie webhook URL | The address TheBooking sends to Mollie with each payment, so Mollie can notify its status. | — |