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

# Checkout Packages

> Build pre-event and post-event packages with photo and video clip prices.

> [!WARNING]
>
> 9Pic Checkout is a **Business plan** feature. You need a payment gateway assigned before creating packages. See [Checkout configuration](https://docs.9pic.ai/products/checkout/configuration.md).

## Overview

A **package** is what buyers purchase at checkout. Each event has one package per **sale phase** (pre-event and post-event). A package holds one or more **prices** for photos, video clips or both, and has a **status** that controls whether buyers see it.

Open the package builder from **Configuration → Packages**: select **Set up pre-event package** or **Set up post-event package** on an empty row, or **Edit details** in a package's menu. **Set up a package** on the Overview checklist opens the same builder.

## How the builder works

The builder has four steps, shown in a step bar at the top: **1. When**, **2. What**, **3. Prices** and **4. Details**. You choose each step yourself: the sale phase on **When**, then Photos, Video clips or both on **What**. **Prices** then gives each product you chose an empty **Single item** price to fill in.

* Select an earlier step in the step bar, or use **Back**, to change your choices. **Change** next to the sale phase on the Prices step opens **When**.
* When you set up a package from an empty row, or edit an existing package, the sale phase is fixed and the builder starts on **What**.
* Nothing is saved until you select **Create package** (or **Save changes** when editing) on the **Details** step.

## Sale phase

Choose when the package is meant to sell:

| Phase | Typical use |
| - | - |
| **Pre-event** | Early access, bib-linked passes, bundles, or a video clip pass sold before the event |
| **Post-event** | Photo sales after the event — the most common case |

A new package from the Overview checklist starts on post-event, or pre-event if a post-event package already exists. A phase that already has a package can't be chosen again; edit that package instead.

## Products

The **What** step offers **Photos** and, for events with 9Pic Motion turned on in Event Config, **Video clips**. Pick one or both. In the **post-event** package clips are priced per clip, as bundles or as all clips. In the **pre-event** package clips are sold as a **clip pass**: one **All items** price for every clip of the buyer, paid before the event videos are published and claimed afterwards, so the clip row offers no other pricing mode. An older pre-event package with a per-clip or bundle clip price must have it switched to All items (or removed) before it can be saved. You can price clips as soon as Motion is on; they go on sale once a watermark is added, and no video needs to be processed first. Until then buyers see them as "coming soon". See [Selling Motion Clips](https://docs.9pic.ai/products/checkout/overview.md#selling-motion-clips).

If Motion was turned off after you saved clip prices, the builder still shows **Video clips** with those prices and explains that Motion is off. Turn Motion back on in Event Config, or remove the clip prices (deselect **Video clips**, or select the bin next to each price). A published package must lose them before you can continue; a draft or paused package can keep them for later, but enabling it needs Motion on.

## Prices

The **Prices** step shows a column for each product, marked **Selling** or **Not selling**. Select **Add a photo price** (or **Add a clip price**) to start selling that product, and **Add another photo price** to offer more options. Removing a product's last price stops selling it in this package.

Choose the package **currency** at the top of this step. It only lists currencies that every assigned gateway accepts. If you changed gateways after creating the package and they can't take its saved currency, the builder says so (for example "AFS Gateway and BENEFIT can't take PHP") and you must choose a supported currency before you can continue. Prices can't have more decimals than the currency allows: 2 for most currencies, 3 for BHD (for example BD 3.125).

For each price, choose a **pricing mode**:

| Mode | What buyers get | Example |
| - | - | - |
| **Single item** | One photo or clip at a set price | \$5 per photo |
| **Bundle** | A set number of items for one price (set the **Bundle size**) | 10 photos for \$40 |
| **All items** | Everything the buyer finds of themselves for a flat fee | All photos for \$99 |
| **Quantity discounts** | A per-item **Base price** with a percentage off at quantity tiers | 10% off from 5 photos |

Each product can have one per-item price (**Single item** or **Quantity discounts**), one **All items** price, and any number of bundles of different sizes. Modes already used show **(added)** in the list. If two bundles have the same size, the builder shows an error until you change or remove one. After you enter a price, a worked example under it shows what a buyer pays.

**Video clips** is offered once 9Pic Motion is turned on for the event in Event Config. Before Motion setup is finished, you can still set clip prices: the column lists the remaining Motion steps and buyers see clips as "coming soon". Once Motion is ready, publishing the post-event package with clip prices puts clips on sale. Clips stay locked behind the purchase only while that package is published and its sale hasn't ended. Pausing it, setting it to draft, archiving it or removing its clip prices stops clip sales and unlocks buyers' clips as free downloads (watermarked once a watermark is set up); enabling it sells them again.

## Package details

Finish the package on the **Details** step:

| Field | Purpose |
| - | - |
| **Package name** | Label shown in the dashboard and referenced in orders |
| **Package state** | New packages: **Published (live)**, **Draft (not live)** or **Paused**. When editing, change it with **Pause** or **Enable** on the package row instead |
| **Starts at (optional)** / **Ends at (optional)** | The sale window. Leave blank to start now and keep selling |

> [!TIP]
>
> Gateways support different currency lists. The builder only shows currencies valid for every gateway on your event.

## Package states

| State | Visible to buyers? | Typical use |
| - | - | - |
| **Draft** | No | Work in progress |
| **Published** | Yes | Live for purchase |
| **Paused** | No | Temporarily hidden without archiving |
| **Archived** | No | Retired; historical orders kept |

At least one **published** package is required before you can **Turn on checkout**. On the package row, **Pause** hides a published package and **Enable** publishes it again; **Archive package** in the row's **⋯** menu retires it, and **Restore** brings an archived package back as a draft.

For a package with clip prices, the **Pause** and **Archive** confirmations say that clip sales stop too, and a paused or draft clip package says its clips aren't on sale. **Enable** stays unavailable while 9Pic Motion is off for the event, or while a pre-event package still has a per-clip or bundle clip price; the row says what to change. A published pre-event clip pass row says buyers pre-book now, or that pre-booking closed once the event videos were published.

## Coupons from a package

When editing a package, the **Details** step offers **Add a coupon for this package**. This opens the coupon builder with the package pre-selected. See [Coupons](https://docs.9pic.ai/products/checkout/coupons.md).

## Common Questions

> [accordion] Can I offer both pre-event and post-event packages?
>
> Yes. Set up one package in each row, **Pre-event** and **Post-event**, each with its own pricing.

> [accordion] What happens if I pause a published package?
>
> Buyers no longer see it at checkout. Existing orders are unaffected. If it prices video clips, clip sales stop too and buyers can download their clips for free (watermarked) until you enable it again.

> [accordion] Can I change pricing on a live package?
>
> Edit the package in the builder. Be mindful that new buyers see updated prices; completed orders keep their original pricing snapshot.

## Next Steps

> [card] [Checkout Configuration](https://docs.9pic.ai/products/checkout/configuration.md)
>
> Turn on checkout once a package is published.

> [card] [Coupons](https://docs.9pic.ai/products/checkout/coupons.md)
>
> Attach discounts to packages or the whole event.

> [card] [Buyer photo options](https://docs.9pic.ai/products/checkout/buyer-photo-selection.md)
>
> Optional library and curated pool for buyers.


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