> 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/customer-checkout-journey.md).

# The Customer Checkout Journey

A walk through everything your customers see from the basket to the order complete page, so you can support them confidently when they get stuck.

***

This page follows a customer from the moment they add tickets to their basket to the moment they see their ticket numbers. Knowing what they see at each step makes it much easier to answer questions like "where do I put my discount code?" or "why can't I pay with my wallet?".

{% hint style="success" %}
**Tip:** the best way to get to know your checkout is to go through it yourself. Make a customer account on your own site and place a small order. Before you go live, card payments run in test mode so no real money is taken. See [Test and Live Card Payments](https://docs.rafflex.io/getting-started/payment-gateway/test-and-live-card-payments.md).
{% endhint %}

***

### Step 1: Adding Tickets to the Basket

Customers choose how many tickets they want on a competition page and add them to their basket. If the competition has an [entry question](https://docs.rafflex.io/create-your-first-raffle/create-a-competition/entry-questions.md), they must answer it first.

* **Guests can add to the basket without logging in.** They only need to log in when they reach checkout.
* **The exception is a competition with a per customer limit.** If you have set **Max per user** on a competition, customers must be logged in before they can add it to their basket, so the site can check how many tickets they already have. They will see a message asking them to log in so their eligibility can be checked. See [Ticket Limits Explained](https://docs.rafflex.io/create-your-first-raffle/create-a-competition/ticket-limits-explained.md).

Once something is in the basket, a small pulsing dot appears on the basket icon in the site header. Clicking the icon takes the customer to their basket.

***

### Step 2: The Basket

The basket page has the heading **Shopping Cart**. For each competition, the customer sees:

* The competition image and name.
* The ticket price. If a discount applies to the ticket price, the original price is shown crossed out next to the new one.
* A **quantity box**, where they can type a different number of tickets. (Free competitions do not have one.)
* The number of tickets, for example **x10 Tickets**. If a [promotion](https://docs.rafflex.io/marketing/website-tools/promos-and-discounts.md) applies, they also see **Promotion:** with the promotion type, and the number of free tickets added, for example **+2 Free**.
* **Answer:** with their answer to the entry question, if there is one.
* **Your prize choice:** with the prizes they ranked, for example "Your prize choice: 1. Tesla Model 3, 2. £10,000 cash", on a [Prize Choice](https://docs.rafflex.io/create-your-first-raffle/prize-choice.md) competition where they chose.
* A **Remove** link to take the competition out of the basket.

Below the list is the order summary, showing the **Subtotal**, any **Discount**, and the **Order total**, with a note that billing information is added at checkout. The customer clicks **Checkout** to carry on, or **Continue Shopping** to go back to your competitions.

#### Things the basket tidies up automatically

To make sure customers only pay for what is genuinely on sale, the basket and checkout pages both remove a competition and show a message if:

* the competition has been deleted ("This competition is no longer available and has been removed from your basket."),
* the competition has ended or is no longer available ("... is no longer available to purchase and has been removed from your basket"),
* the competition has been rescheduled and has not started yet ("... has not started yet and has been removed from your basket"), or
* the price has changed since they added it ("The price on ... has changed, please re-add your tickets to checkout").

If the basket ends up empty, the customer is taken back to your home page with the message **Your Cart is empty.**

#### Date of birth reminder

If you have switched on **Enforce Date of Birth for Existing Customers**, logged in customers who have no date of birth on file see an amber banner at the top of the basket and checkout pages:

> Please add your date of birth to your account before purchase.

They can click **Quick Set** to add it in a small pop up without leaving the page. See [Player Protections](https://docs.rafflex.io/standards/standards/player-protections.md) for more about date of birth checks.

***

### Step 3: Checkout

Customers must be logged in to reach checkout. If they are not, they are asked to log in or create an account first. There is no guest checkout, and no setting to turn one on, so every customer needs an account before they can pay.

{% hint style="info" %}
Customers who are currently on a self-imposed break from your site (a timeout) are sent back to the home page instead of reaching checkout. See [Safe Play Setting](https://docs.rafflex.io/additional-settings/settings/safe-play-setting.md).
{% endhint %}

The checkout page is laid out from top to bottom like this.

#### Discount code

At the top, next to the **Checkout** heading, is a **Discount Code** button. Clicking it opens a small box where the customer types their code and clicks **Submit**.

Once a code is applied, it appears in the totals as **Discount Code:** with the code and the amount off. The customer can click the small cross next to it to remove the code.

{% hint style="info" %}
**Customers can't find where to enter their code?** This is the most common checkout question. Point them to the **Discount Code** button at the top right of the checkout page. If the code still will not apply, see [Why a Discount Code Will Not Apply](https://docs.rafflex.io/marketing/website-tools/promos-and-discounts/why-a-discount-code-wont-apply.md).
{% endhint %}

#### Tickets and Totals

* **Tickets**. Each competition in the basket, with the number of tickets and the price. Customers can tap a competition to open it and see the image, their answer (shown as **Your Answer:**), their prize choice on a Prize Choice competition, the price per ticket and any promotion.
* **Totals**. The **Subtotal**, any discount code, and the **Total**.

If you offer [cashback](https://docs.rafflex.io/additional-settings/wallet-and-withdrawals/site-credit-and-wallets/cashback-explained.md), a banner below the totals tells the customer how much they will earn, for example "You will earn £1.50 instant cashback from this order!".

#### Billing Address

The customer fills in, or checks, their details:

* **First Name** and **Last Name**
* **Email address**
* **Mobile Phone**
* **Date of Birth** (only if you require it and the customer has not given it before)
* **Street Address**
* **Town / City** and **County**
* **Country** (**United Kingdom** or **Ireland**)
* **Postcode**

These are filled in automatically from the customer's account where possible, and saved back to their account so they are ready next time.

Every one of these is required before the customer can pay (date of birth only when you ask for it). Signing up only asks for a name, email address and password, so a customer's phone number and address are first collected at their first checkout. Only United Kingdom and Ireland addresses can be chosen, and there is no setting to change the countries offered.

{% hint style="info" %}
**Sending a physical prize?** There is no separate delivery address and no postage charge at checkout. The address on an order is the billing address the customer entered. Confirm the delivery address with the winner when you contact them about their prize.
{% endhint %}

#### Marketing consent

Under the address is a tick box: **Receive Discount Codes & Latest Competitions**. It is ticked to start with, unless the customer has unsubscribed from your marketing in the past, in which case it starts unticked. Leaving it ticked signs them up to your email marketing. See [Marketing Consent and Unsubscribes](https://docs.rafflex.io/marketing/sms-and-email/marketing-consent-and-unsubscribes.md).

#### Test mode banner

While card payments are in test mode, customers see a yellow box reading **Card Payment Testing ENABLED. Real Money not taken.** If you see this on your live site, your card payments have not been switched to live yet. See [Test and Live Card Payments](https://docs.rafflex.io/getting-started/payment-gateway/test-and-live-card-payments.md).

#### Choosing how to pay

The payment options a customer sees depend on two things: which options you have ticked under **Payment Gateways** (in the admin panel, open **Settings**, then **Payments**), and how much site credit the customer has.

| Option                        | When the customer sees it                                                                                                                                                                          |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Cards, Apple & Google Pay** | Always, as long as **Cards, Apple & Google Pay** is ticked. This is selected to start with.                                                                                                        |
| **Wallet**                    | When **Wallet** is ticked and the customer's site credit covers the whole order. Their balance is shown on the button.                                                                             |
| **Wallet + Card**             | When **Partial Wallet + Card** is ticked and the customer has some site credit, but not enough for the whole order. A note explains how much comes from their credit and how much is paid by card. |

If the customer has no site credit at all, a greyed out **wallet** box shows their balance but cannot be selected.

For more on these options, see [Payment Gateway](https://docs.rafflex.io/getting-started/payment-gateway.md) and [Site Credit & Wallets](https://docs.rafflex.io/additional-settings/wallet-and-withdrawals/site-credit-and-wallets.md).

{% hint style="info" %}
**Free orders skip payment.** If the order total is zero, for example on a free competition or with a 100% discount code, the payment options are not shown and the button reads **Place Free Order**.
{% endhint %}

#### Terms and paying

The customer must tick **I am over 18 & agree to the terms and conditions** before they can continue. Then they click the **Pay** button, which shows the amount, for example **Pay £10.00**.

#### Upsell pop up

If you have set up [upsells](https://docs.rafflex.io/marketing/website-tools/upsell.md), a pop up may appear on the checkout page suggesting another competition the customer might like to add.

***

### Common Messages at Checkout

These are messages customers may see when they click **Pay**, and what they mean.

| Message                                                          | What it means                                                                                                                                                                                                                                            |
| ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Please check your mobile number**                              | The phone number does not look like a valid mobile number.                                                                                                                                                                                               |
| **Please reselect your country.**                                | The country needs choosing again from the list.                                                                                                                                                                                                          |
| **Please reselect your payment method.**                         | The payment option needs choosing again.                                                                                                                                                                                                                 |
| **Please provide your date of birth to continue.**               | You require a date of birth and the customer has not entered one.                                                                                                                                                                                        |
| **You must be at least 18 years old.**                           | The date of birth entered is under 18.                                                                                                                                                                                                                   |
| **You do not have enough funds in your wallet to pay in full.**  | Their balance no longer covers the order. They can choose **Wallet + Card** or pay by card instead.                                                                                                                                                      |
| **All remaining tickets are currently in checkout...**           | Other customers are holding the last tickets while they pay. If those orders are not paid, the tickets are released, so the customer can try again shortly. See [Pending Tickets](https://docs.rafflex.io/managing-your-site/orders/pending-tickets.md). |
| **Your order is already being processed. Please wait a moment.** | The customer clicked **Pay** twice. The first click is still going through.                                                                                                                                                                              |

Customers may also see a message about a spending limit if one applies to their account. See [Spending Limits at Checkout](https://docs.rafflex.io/additional-settings/settings/safe-play-setting/spending-limits-at-checkout.md).

***

### Step 4: Paying

* **Card, Apple Pay or Google Pay.** The customer is taken to a secure Cashflows payment page, then brought back to your site.
* **Wallet.** The site credit is used straight away. There is no separate payment page.
* **Wallet + Card.** The site credit part is taken first, then the customer pays the rest on the secure card page.

If the customer backs out on the card payment page, they are brought back to their basket with the message **Order Canceled**, and the held tickets are released.

If their card is declined, they are brought back to the checkout page with the message **Payment Declined. Please try again.** They can try again with another card or a different payment option.

Your site is not told why a card was declined. To find out, look the payment up in your Cashflows dashboard, or send the order number to Cashflows support. Common reasons are a card the bank declined or blocked, not enough funds, or a poor connection that let the payment time out.

* **Other customers are paying normally?** Your payment setup is working. Ask the customer to try another card, device or browser.
* **One customer keeps failing?** If it still fails after that, contact Rafflex support with the customer's email address.
* **Lots of payments failing at once?** Contact Rafflex support straight away.

#### The waiting page

Sometimes a payment takes a moment to confirm. If so, the customer sees a **Processing Your Payment** page asking them to wait on the page while the payment is confirmed. The page tells them this can take a minute or two. They do not need to refresh, because the page checks for them every few seconds and moves on by itself:

* **Payment confirmed**: they go to the order complete page.
* **Order refunded to site credit** (for example if 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)): they go back to their basket with a message explaining that the full amount has been added to their site credit.

For some payment methods, the waiting page can also send the customer back to their basket with **Payment Declined. Please try again.** or **This order was canceled. Please try again.** if the payment did not go through.

***

### Step 5: The Order Complete Page

Once payment is confirmed, the customer sees **Order Successful!**, followed by:

* **Order #** and the order number, with the date the order was placed.
* **Each competition** in the order, with its image, title and price, then **Your Tickets** and the quantity (for example **Qty x10**).
* **Answer:** with their entry question answer, if there was one.
* **Promotion** details, if one applied, for example "x10 Tickets + 2 Free".
* **Their ticket numbers.** If a competition has more than 60 tickets on the order, the numbers are tucked behind a **View your 120 Tickets** button (with their own number) to keep the page tidy.
* **The instant win game**, if the competition has instant wins. The customer plays it right there to reveal whether they have won. See [Instant Win Games](https://docs.rafflex.io/create-your-first-raffle/instant-win-games.md).
* **Your prize choice**, on a [Prize Choice](https://docs.rafflex.io/create-your-first-raffle/prize-choice.md) competition where customers rank the prizes, with a **Choose** or **Change** button until choices close.
* **Fancy Another Go?** with a **Repeat This Order!** button. This empties the basket, adds the same competitions and quantities again (with the same answers), and takes the customer straight to checkout. Any competition that is no longer available is left out, with a message telling them which ones.
* **Your own message**, if you have added one in the **Order Complete HTML** setting. This is a good place for a thank you, a social media link, or a reminder of draw dates. See [Advanced Settings](https://docs.rafflex.io/additional-settings/settings/advanced-settings.md).
* **The billing summary**, showing the **Billing address**, **Subtotal**, any **Wallet Credit** and **Discount** used, and the **Order total**.

The customer can see the same order details again at any time by opening the order from **My Orders** in their account, and can see all their tickets under **My Tickets**.

{% hint style="info" %}
**A customer says they paid but never saw their tickets?** Find their order in [Orders](https://docs.rafflex.io/managing-your-site/orders.md) and check its status and order notes. If the order is **complete** but the ticket numbers are missing, see [Re-issue Missing Tickets](https://docs.rafflex.io/managing-your-site/orders/assign-missing-tickets.md).
{% endhint %}

***

### Related Pages

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

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