> For the complete documentation index, see [llms.txt](https://docs.yaycommerce.com/bookster/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yaycommerce.com/bookster/other-links/troubleshooting.md).

# Troubleshooting

When a booking, payment or change doesn't go through, Bookster shows a message and can write the details to its log. This page explains the messages and what to send us if you need help.

If the booking form looks wrong (layers on buttons, solid icons, spaced-out letters), see [Theme style conflicts](https://docs.yaycommerce.com/bookster/other-links/theme-conflicts.md).

## Read the Bookster Logs

The log is for site admins only.

1. In WordPress, go to **Tools › Bookster Logs**.
2. Bookster writes nothing until you set a level. Set **Log Level** to **Warning** (or **Debug** when we ask for it) and click **Save**.
3. Repeat what went wrong.
4. Reload the log. The newest rows are at the top, with their **Level**, **Type**, **Object ID**, **Message** and **Created** time.

<figure><img src="https://3654694329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOokiT38oKvyMtYds88Kp%2Fuploads%2Fgit-blob-1bd3de3f00dacd68c34bf420e43492f32f6d113b%2Fbookster-logs.webp?alt=media" alt="Bookster Logs page with a warning row and the Log Level setting"><figcaption><p>Tools › Bookster Logs, with the Log Level setting.</p></figcaption></figure>

When you're done, set **Log Level** back to **None**. **Clean Old Logs (30+ days)** removes old rows.

## What to send support

Before you write, check the steps on [Support](https://docs.yaycommerce.com/bookster/other-links/support.md). Then send us:

* Your site URL.
* The versions of WordPress, Bookster and each Bookster addon (**Plugins** page).
* The log rows from the time it happened: copy the **Message** and **Created** columns.
* The steps that lead to the problem, and who did them (customer, agent or admin).
* Screenshots of the message on screen.

## Messages and what to do

### Customers in the booking form

| Message                                                                      | What it means                                                                                           | What to do                                                                                                                                                |
| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "This time is no longer available. Please pick another time."                | Someone booked that time first.                                                                         | The customer picks another time.                                                                                                                          |
| "Some of these times are no longer available. Please check the dates again." | One date of a series or part of a bundle was taken while the customer booked.                           | The customer goes back to the date step; Bookster checks the dates again.                                                                                 |
| "This time is not available for the series. Pick another time."              | The first date of a repeat booking is taken.                                                            | Pick another time. See [Let customers repeat a booking](https://docs.yaycommerce.com/bookster/orders-and-packages/orders-and-packages/repeat-booking.md). |
| "The price changed. Please check the new amount and confirm again."          | The price changed while the customer was paying (a coupon, an extra or a setting). Nothing was charged. | The customer checks the new amount and confirms.                                                                                                          |
| "Sorry, we're processing another request for this time. Please try again."   | Two bookings for the same agent arrived at once.                                                        | Try again a moment later.                                                                                                                                 |
| "This payment was already used or has expired. Please check out again."      | The payment window was used or timed out.                                                               | The customer goes through checkout again.                                                                                                                 |
| "PayPal did not take the payment. Please try again."                         | PayPal declined the payment. Nothing was booked.                                                        | Try again, or use another payment method.                                                                                                                 |
| "This payment method cannot pay for a series."                               | The payment addon is older than Bookster 3.4.                                                           | Update the payment addon.                                                                                                                                 |
| "Online booking is unavailable right now. Please contact us to book."        | No payment method is available in the form.                                                             | Check **Settings › Payment** and update payment addons.                                                                                                   |
| "Booked together with other dates or services — contact us to change it."    | The booking is part of a series or a bundle, so the customer can't reschedule it alone.                 | Move it for them from the calendar.                                                                                                                       |

### Admins and agents in the admin

| Message                                                                         | What it means                                                  | What to do                                                                                                                                                      |
| ------------------------------------------------------------------------------- | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "This booking is part of Order #N. Apply this change to the whole order."       | The change applies to every booking in the order.              | Make it from the order. See [Manage orders and their payments](https://docs.yaycommerce.com/bookster/orders-and-packages/orders-and-packages/manage-orders.md). |
| "This booking is part of Order #N and cannot be changed this way."              | Orders don't allow this change on one booking.                 | Cancel the booking instead, or cancel the order and book again.                                                                                                 |
| "Service, length, price and payment are managed on the order."                  | These fields are locked on a booking of an order.              | Change the date or status here; take payment from the order.                                                                                                    |
| "Delete — part of an order, cancel instead"                                     | Bookings of an order can't be deleted.                         | Set the status to **Canceled**.                                                                                                                                 |
| "Cannot move here: You have another appointment"                                | An agent tried to move a booking onto a busy time.             | Click **Move** on the message and pick a free time. Only managers can **Move Anyway**.                                                                          |
| "Some appointments in this series are not available."                           | A date of a new series has a conflict.                         | Click **Book anyway**, or change the dates.                                                                                                                     |
| "\[Addon name] needs an update to take payments with this version of Bookster." | A payment addon is too old; the booking form doesn't offer it. | Click **Update now**.                                                                                                                                           |

### Refund these payments by hand

If a booking fails after the customer has paid, Bookster refunds the payment at once. When that refund fails too, admins see the notice **Bookster: refund these payments by hand**, with the amount, payment method, payment reference and date of each payment.

1. Refund each payment in your payment provider's dashboard (Stripe or PayPal).
2. Click **I have refunded these** to clear the notice.

A Stripe bank payment that is still processing can't be refunded yet. Refund it once it settles.
