> ## Documentation Index
> Fetch the complete documentation index at: https://bookingspotapp.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Take appointment payments with Shopify

> Publish a service and its appointment options as a Shopify product, then choose how shoppers reach checkout.

Use this guide after [connecting the Booking Spot Shopify app](https://bookingspotapp.com/docs/getting-started/shopify.md). Paid services need a connected store with checkout permissions.

## Publish a service as a Shopify product

1. Assign a professional with working hours in **Team**.
2. Open **Services → Add service**. In **Service setup**, enter the service name, duration, and price. Choose **Shopify checkout** under **Payment collection**. Add appointment options if customers can book different durations or prices. Assign the professional and click **Save service**.
3. In **Settings → Shopify storefront**, enable **Accept appointments** and save. [Create a dedicated booking product template](https://bookingspotapp.com/docs/booking-pages/shopify-blocks.md#create-a-booking-product-template) with the **Booking selector** and make that template available in your live theme.
4. Open the service’s **Shopify settings** tab. Select sales channels, any manual collections, the Shopify location, and the product template.
5. Click **Review and publish**. Check the sales channels, template, and variant prices in the confirmation box, then click **Publish product**. Booking Spot creates one product with a Shopify variant for each appointment option.
6. Use **View product page** to check how customers book or **Open in Shopify** to view the product in Shopify Admin. After editing prices or appointment options, save the service, then use **Shopify settings → Review update** to sync the existing product.

![Shopify settings showing sales channels, Experiences collection, Shopify location, the booking-spot template, and Review update.](https://mintcdn.com/booking-spot/2EJbXjxHT-JWnMMf/assets/screenshots/shopify-service.png?fit=max\&auto=format\&n=2EJbXjxHT-JWnMMf\&q=85\&s=59fa7606a00b093d577be7ebd324b040)

Choose where the Shopify product appears and which template customers see.

![Confirmation box showing product settings and the Signature 30 and Extended 60 appointment variants.](https://mintcdn.com/booking-spot/2EJbXjxHT-JWnMMf/assets/screenshots/shopify-publish-confirmation.png?fit=max\&auto=format\&n=2EJbXjxHT-JWnMMf\&q=85\&s=c7a4d71b318275d817ed8259dbc01ebc)

Review the Shopify settings, durations, and prices before committing an update.

Use the booking selector for reservations. Direct sales through Shopify POS appear in Shopify only. If Shopify discounts or currency conversion change the checkout amount, review the checkout before sending customers to the storefront.

## Product publishing options

**Available on Free:** publish or link your one active service and take payments through Shopify checkout. No paid subscription is required. Starter and Pro support multiple active services.

![Free service Shopify product publishing options with the review action circled.](https://mintcdn.com/booking-spot/2EJbXjxHT-JWnMMf/assets/screenshots/free-shopify-publishing.png?fit=max\&auto=format\&n=2EJbXjxHT-JWnMMf\&q=85\&s=2b46f3d7d18d63622dea1a885e7aaf01)

Shopify publishing stays available on Free.

Open **Services → \[service] → Shopify settings** after saving the service. The same controls appear after **Publish** at the end of onboarding.

| Option | How to use it |
| - | - |
| **Sales channels** | Select at least one. Online Store is selected by default for a new product when available. Other channels shown come from your Shopify store. Selecting POS or Shop does not add a time-selection widget to those channels. Use the storefront selector for reservations. |
| **Collections** | Search and select one or more **manual** Shopify collections. Leave empty for none. Create collections in Shopify first. Automated collections use their Shopify rules and are not edited here. |
| **Shopify location** | Choose an available Shopify location or **Shopify default**. This controls the Shopify product's fulfillment/inventory location; it does not set professional working hours or the appointment address. |
| **Product template** | Choose the template with Booking selector, usually `booking-spot`. New products prefer the onboarding template when available. Existing products retain their saved selection. |
| **Review and publish** | Opens a summary before creating the product. Nothing changes until **Publish product**. |
| **Review update** | Opens a summary for the existing published product. Confirm with **Update product**; a success toast confirms the write. |

To change product details, update and save the service first, then review the Shopify update. Changing a selection in the options form alone does not update Shopify. A **Shopify update needed** badge indicates prices that need syncing. If an update succeeds but the page cannot refresh, reload before trying again to avoid creating a duplicate action.

### Appointment duration and price options

**Starter or Pro is required for additional options.** In **Service setup**, choose **Shopify checkout**. Enter **Default option name**, such as Standard, then **Add option** for another duration or price. Each option has **Option name**, **Duration (minutes)** and **Price**. The remove icon deletes an added option. The base service is the first option; up to 24 additional options are available. Save the service, then review and publish/update the product. Each option maps to its own Shopify variant and uses the service's team, resources and booking limits.

### Collections, locations and appointment addresses

A **collection** organizes products in Shopify. A **Shopify location** is a Shopify inventory/fulfillment setting. A **Location label**, **Appointment location** and street address under **Settings → Hosted pages** describe where a customer attends. A **resource** under **Business and policies → Rooms and equipment** prevents shared-room conflicts. These controls serve different purposes; selecting a Shopify location does not create separate availability for a branch.

### Link an existing Shopify product

For a service with a single fixed-price variant, open **Shopify settings → Link an existing product**. Enter its numeric product and variant IDs and click **Save product link**. Match the same price and currency in **Service setup**.

## Choose how customers reach checkout

Go to **Booking Spot → Settings → Payments**. Choose a **Shopify purchase flow**, then click **Save settings**. This applies to paid Shopify services on the storefront.

| Setting | What the customer does |
| - | - |
| **Direct to checkout** (default) | Selects a time, accepts your policy, and clicks **Continue to Checkout** to open Shopify checkout for the appointment. |
| **Add to cart** | Selects a time, accepts your policy, and clicks **Add to cart**. The appointment joins any items already in the Shopify cart. The customer clicks **Checkout** in the cart. |

![The Shopify purchase flow setting outlined under Settings, Payments, with Add to cart selected.](https://mintcdn.com/booking-spot/2EJbXjxHT-JWnMMf/assets/screenshots/shopify-purchase-flow.png?fit=max\&auto=format\&n=2EJbXjxHT-JWnMMf\&q=85\&s=7ce617522a716f8986f9110806714671)

Change the purchase flow in the Payments tab.

The storefront must load the Booking Spot app block for **Add to cart** to use that store’s cart. Hosted booking pages and private waitlist checkouts open checkout directly.

> [tab] Direct to checkout
>
> ![The Booking Spot widget showing an appointment review with the Continue to Checkout button outlined.](https://mintcdn.com/booking-spot/2EJbXjxHT-JWnMMf/assets/screenshots/shopify-widget-checkout.png?fit=max\&auto=format\&n=2EJbXjxHT-JWnMMf\&q=85\&s=5f6a2ae3e702350c3126edce23f63836)
>
> The appointment review opens Shopify checkout.

> [tab] Add to cart
>
> ![The Booking Spot widget showing an appointment review with the Add to cart button outlined.](https://mintcdn.com/booking-spot/2EJbXjxHT-JWnMMf/assets/screenshots/shopify-widget-cart.png?fit=max\&auto=format\&n=2EJbXjxHT-JWnMMf\&q=85\&s=8ce4bada531e8a741da210120878941b)
>
> The appointment review adds the booking to the storefront cart.

## Verify a test order

1. Use a Shopify development store or a store with a [test payment gateway](https://help.shopify.com/en/manual/checkout-settings/test-orders/processing-test-order) enabled. Confirm that the paid service appears on a draft theme’s appointment product.
2. Choose a time with the professional and review the appointment. With checkout contact collection enabled for an eligible paid Shopify booking, name and email are entered at checkout; required questions and consent remain in the widget. For **Add to cart**, add a regular item first so you can verify both items appear together in the cart. If the widget asks for contact details, use the same email there and at checkout. Checkout must collect an email address for booking confirmations.
3. Pay using test details before the reservation expires. Find the paid order in **Shopify Admin → Orders**, then check the appointment in the Booking Spot **Calendar**. If the service requires approval, look for a pending appointment and approve it. If confirmation emails are enabled, verify the customer receives the email.

The time is held temporarily. Booking Spot confirms availability and matches the Shopify order to the appointment before confirming. A cart may still contain an appointment item after its hold expires. If this happens before payment, remove that line and select a new time. If payment arrives after the hold expires or the order details do not match, open **Booking Spot → Workflows** and check the checkout status. Review the original Shopify order before refunding or asking the customer to book again.

![Two completed Shopify checkouts in Booking Spot Workflows, with the first order number outlined.](https://mintcdn.com/booking-spot/2EJbXjxHT-JWnMMf/assets/screenshots/shopify-order-status.png?fit=max\&auto=format\&n=2EJbXjxHT-JWnMMf\&q=85\&s=99300715be7cbdd6d4df93429ab19fca)

The Shopify checkouts section in Workflows shows the matched order and payment status. This example uses simulated orders.

## Private checkout from the waitlist

A waitlist invitation can offer a specific time through a private Shopify draft checkout when the store has draft-order access. The customer accepts the policy before the private checkout is created. Booking Spot rechecks availability before taking the reservation. [Set up manual or automatic waitlist offers](https://bookingspotapp.com/docs/appointments/waitlist.md#offer-a-private-shopify-checkout).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.