> For the complete documentation index, see [llms.txt](https://docs.rafflex.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rafflex.io/managing-your-site/orders.md).

# Orders

Find any order on your site, see exactly what a customer bought and how they paid, check their ticket numbers, and take action when something needs putting right.

***

Every time a customer goes through checkout, an order is created. The **Orders** area of your admin panel is where you look them up, check what was bought, see how it was paid for and, when needed, re-issue missing tickets or cancel an order.

This page walks you through the orders list, what each part of an order means, and the buttons you can use.

***

### Where to Find Orders

1. Log in to your **admin panel**.
2. In the left-hand menu, find the **Competitions** group.
3. Click **Orders**.

The newest orders are shown at the top.

{% hint style="info" %}
**Can't see Orders in the menu?** If you are logged in as a staff member, your account may have the **Restrict Orders** restriction switched on, which hides the Orders area completely. The site owner can change this on your account. See [Staff Accounts and Access](https://docs.rafflex.io/managing-your-site/customers/staff-accounts-and-access.md) for how restrictions work.
{% endhint %}

***

### The Orders List

Each row in the list is one order. These are the columns you will see:

| Column        | What it shows                                                                   |
| ------------- | ------------------------------------------------------------------------------- |
| **#**         | The order number. This is the number customers see on their order confirmation. |
| **Full Name** | The name the customer entered at checkout.                                      |
| **Source**    | Where the order came from (see below).                                          |
| **Total**     | The amount of the order (see [Totals](#totals) below for what this includes).   |
| **Status**    | Where the order is up to, shown as a coloured badge.                            |
| *(date)*      | The date and time the order was placed. This last column has no heading.        |

#### The Source badge

The **Source** column tells you how the customer found their way to the order:

* **Rafflex Dropped Basket** (blue). The customer came back and paid after receiving one of your [dropped basket reminders](https://docs.rafflex.io/marketing/website-tools/dropped-basket-recovery.md). These rows are also lightly tinted blue so recovered sales stand out as you scroll.
* **A campaign name**, such as `facebook` or `newsletter`. This is the UTM source from the link the customer clicked to reach your site. See [UTM Tags](https://docs.rafflex.io/managing-your-site/analytics/utm-tags.md) to learn how to tag your own links.
* **Direct**. There was no tracked source, for example the customer typed your address in or used a bookmark.

#### Order statuses

| Status         | Colour | What it means                                                                                                                                                                                                                                      |
| -------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **complete**   | Green  | Payment has been confirmed and the customer has their tickets.                                                                                                                                                                                     |
| **pending**    | Grey   | The customer has started checkout but has not finished paying. Their tickets are being held for a short time.                                                                                                                                      |
| **processing** | Grey   | Payment is being confirmed. This usually only lasts a moment.                                                                                                                                                                                      |
| **failed**     | Red    | The payment did not go through, for example the card was declined.                                                                                                                                                                                 |
| **refunded**   | Red    | The order was refunded to the customer's site credit automatically, for example because the competition [sold out while they were paying](https://docs.rafflex.io/create-your-first-raffle/instant-win-games/sold-out-during-checkout-refunds.md). |
| **canceled**   | Grey   | The order was cancelled. This happens when you or a member of staff use **Cancel Order**, when a customer backs out on the payment page, or when an unpaid checkout runs out of time and its held tickets are released.                            |

{% hint style="info" %}
Pending orders are a normal part of checkout. Most of them either turn into complete orders within a few minutes or are cancelled automatically when the customer walks away. To watch them live, use the **Pending tickets** button described below.
{% endhint %}

#### Searching for an order

* **To find an order by number**, type the number into the search box at the top of the list.
* **To find an order by customer name**, use the small search box under the **Full Name** column heading. You can search by first name or last name.

#### Tabs and filters

The list opens on the **Today** tab (or the tab you used last), so older orders are not shown until you switch. Click **All** to see every order, or **This week**, **Pending**, **Failed** or **Refunded**.

To narrow the list, click the filter icon (a funnel) at the top right of the list. You can filter by:

* **Placed from** and **Placed until**, to see orders from particular dates, for example last week.
* **Status**, **Gateway** (how the order was paid) and **Source** (the UTM source of the link the customer clicked).
* **Competition**, to see only orders that include one competition. Start typing its name to find it.
* **Coupon**, and **Recovered dropped baskets**.

{% hint style="info" %}
**Got an order email but cannot find the order?** Make sure you are on the **All** tab, then search for the order number.
{% endhint %}

#### Moving through the list

The list shows 10 orders at a time. Use the **Previous** and **Next** buttons at the bottom of the list to move between pages. You can also change how many orders are shown per page (10, 25 or 50).

{% hint style="info" %}
**There is no "New Order" button, and that is on purpose.** Orders are created by customers going through checkout. If you need to add tickets for someone who has sent in a free postal entry, use the postal entry tools on the competition instead. See [Free Entry](https://docs.rafflex.io/additional-settings/free-entry.md).
{% endhint %}

***

### Buttons at the Top of the Orders List

#### Pending tickets

Opens a live view of every order that is part way through checkout, showing how many tickets each one is holding and how long the customer has been paying. It is useful on busy launch nights or when a competition is close to selling out.

{% content-ref url="/pages/F3bdbv12oU2LKQeCyQK4" %}
[Pending Tickets](https://docs.rafflex.io/managing-your-site/orders/pending-tickets.md)
{% endcontent-ref %}

#### Export

Downloads a quick spreadsheet (CSV file) of orders straight away, without waiting for an email.

1. Click **Export** at the top of the Orders list.
2. Choose a **From** date. This is set to one week ago to start with.
3. Choose a **To** date. This can be up to 7 days after your **From** date.
4. Click **Submit**. The file downloads to your computer right away.

The file includes orders of **every** status (complete, pending, cancelled and so on) placed between those dates, with these columns:

`id`, `user_id`, `email`, `phone`, `postcode`, `Status`, `subtotal`, `discount`, `credit_used`, `total`, `payment_gateway`, `discount_code`, `created_at`, `UTM_Source`, `UTM_Medium`, `UTM_Campaign`

{% hint style="info" %}
**Need more than a week, or only complete orders?** Use the Orders report in **Downloads & Reports** instead. It covers longer date ranges, lets you filter by status and payment method, and adds handy columns for bookkeeping. See [Orders Export](https://docs.rafflex.io/managing-your-site/downloads/orders-export.md).
{% endhint %}

{% hint style="warning" %}
Because this quick export includes every status, remember to filter the **Status** column to `complete` in your spreadsheet before you add up sales.
{% endhint %}

***

### Viewing an Order

To see everything about an order, click **View** at the end of its row. The order page is split into a few sections.

#### Customer and payment details

The top card shows:

* **Name** and **Email**. The details the customer entered at checkout.
* **Payment gateway**. How the order was paid for, shown as a badge:

| Badge                 | What it means                                                                                                                                  |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Cashflows** (green) | Paid in full by card, Apple Pay or Google Pay.                                                                                                 |
| **Wallet** (amber)    | Paid in full with the customer's [site credit](https://docs.rafflex.io/additional-settings/wallet-and-withdrawals/site-credit-and-wallets.md). |
| **Partial** (amber)   | Paid partly with site credit and partly by card.                                                                                               |
| **Free** (grey)       | The order total was zero, for example a free competition or a 100% discount code, so no payment was needed.                                    |
| **Postal** (grey)     | Tickets added by you for a free postal entry.                                                                                                  |

* **Status**. The same coloured status badge you see in the list.
* The date and time the order was placed.
* **Address** and **Phone**. The billing address and mobile number from checkout.

#### Totals

The **Totals** box breaks down the money:

* **Subtotal**. The value of the tickets before any discount.
* **Discount**. Money taken off by a [discount code](https://docs.rafflex.io/marketing/website-tools/promos-and-discounts.md).
* **Credit used**. Site credit the customer spent on this order.
* **Total**. The amount charged.

{% hint style="info" %}
**Understanding the totals.** For a **Partial** order, **Total** is the amount paid by card and **Credit used** is the part paid with site credit, so the full value of the sale is the two added together. For a **Wallet** order, the whole amount came from site credit, so **Credit used** and **Total** show the same amount. Do not add them together, or you will count that sale twice.
{% endhint %}

#### Products

The **Products** section lists each competition in the order, with its image, title, **Quantity**, **Price**, **Discount** and **Total**.

Under each competition is a bar showing how many tickets the customer has, for example **10 Tickets**. On complete orders you can click this bar to open it and see every ticket number. On orders that are not complete, the ticket numbers are not shown.

You can fold the whole **Products** section away if you want to focus on the rest of the page.

#### Tracking

The **Tracking** box, on the right, shows how the customer reached your site before buying. Only the details that were recorded appear:

* **Recovery**. Shows **Rafflex Dropped Basket** if the customer came back from a dropped basket reminder.
* **Source**, **UTM Medium**, **UTM Campaign**, **UTM Term** and **UTM Content**. The campaign tags on the link they clicked.
* **Refferer**. The website they came from, such as a social network or search engine. (The label is spelt this way in the admin panel.)
* **First Landing**. The first page they landed on.

If nothing was recorded for an order, the Tracking box is not shown.

#### Order notes

Below the Tracking box is a running history of the order. Each note has a date and time beside it. Notes are added automatically as the order moves along, for example when checkout starts, when a customer wins an instant win prize (showing the ticket number and prize), when tickets are re-issued, or when the order is cancelled or refunded.

{% hint style="success" %}
**Tip:** the order notes are the first place to look when a customer asks "what happened to my order?". They usually tell you the whole story in a few lines.
{% endhint %}

A note reading **Cashflows Webhook Payment not found, unpaid or canceled.** means Cashflows reported that the payment was not completed, for example because the card was declined or the customer left the payment page. It does not mean a customer paid and the order went missing.

***

### Buttons on the Order Page

Across the top of the order page you will see up to three buttons.

#### Goto user

Takes you straight to this customer's account in **Users**, where you can see their details, other orders and wallet. Handy when you need to check a customer's history or contact details. See [Customers](https://docs.rafflex.io/managing-your-site/customers.md) for everything on that page.

#### Assign tickets

Re-issues tickets on a **complete** order whose tickets have gone missing, checks them for instant wins, and emails the customer their order confirmation again. The button shows on every order, but it only does anything on a **complete** one. You will be asked to confirm before anything happens.

{% hint style="info" %}
Want to know exactly what **Assign tickets** checks, the messages you might see, and when you should or should not use it? See [Re-issue Missing Tickets](https://docs.rafflex.io/managing-your-site/orders/assign-missing-tickets.md).
{% endhint %}

#### Cancel Order

Only shown on **complete** orders. Cancelling deletes the order's tickets, resets any instant wins on it, and lets you choose whether to give the customer their money back as site credit and whether to take back any instant win money they won. It also always takes back any [Prize Choice](https://docs.rafflex.io/create-your-first-raffle/prize-choice.md) prize paid on the order, and does not go through if the winner's balance cannot cover it. A main draw winner on the order stays listed until you delete them.

{% hint style="warning" %}
**Cancel Order does not send money back to a card.** If you want to refund real money, do that in your Cashflows account as well. Read the full guide before you cancel anything.
{% endhint %}

{% content-ref url="/pages/lb15yfM9f1FtPW6uxwMz" %}
[Cancelling and Refunding Orders](https://docs.rafflex.io/managing-your-site/orders/cancelling-and-refunding-orders.md)
{% endcontent-ref %}

***

### Related Pages

{% content-ref url="/pages/km8OLUZVrqJpRp8CqEVt" %}
[The Customer Checkout Journey](https://docs.rafflex.io/managing-your-site/orders/customer-checkout-journey.md)
{% endcontent-ref %}

{% content-ref url="/pages/Z4TSzCF3FaXLpJBjx880" %}
[Orders Export](https://docs.rafflex.io/managing-your-site/downloads/orders-export.md)
{% endcontent-ref %}
