> 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/additional-settings/wallet-and-withdrawals/site-credit-and-wallets.md).

# Site Credit & Wallets

How customers earn and spend site credit, what their wallet looks like, and how to add or remove credit, set up cashback and allow withdrawals.

**Site credit** is money held in a customer's wallet on your site. Customers can spend it on competitions at the checkout and, if you allow it, withdraw it to their bank account. This page explains where credit comes from, what customers see, and how you manage it step by step.

For the withdrawal settings, photo ID checks and the customer's withdrawal journey, see [Wallet & Withdrawals](https://docs.rafflex.io/additional-settings/wallet-and-withdrawals.md).

***

### How Customers Can Earn Site Credit

#### Instant Wins

Add instant wins to your competitions and switch on **Site Credit** for the prize. When a customer wins, the credit goes straight into their wallet with no action needed from you. [See how to add Instant Wins](https://docs.rafflex.io/create-your-first-raffle/add-instant-wins.md) and [how site credit instant wins are paid](https://docs.rafflex.io/drawing-winners/managing-payouts/instant-win-site-credit-payouts.md).

#### Site Credit Competitions

Run a competition where the main prize is site credit. When you have drawn the winner, pay the prize by adding credit to their account by hand. [See how to add site credit to a customer.](#add-or-remove-site-credit-for-a-customer)

With [Prize Choice](https://docs.rafflex.io/create-your-first-raffle/prize-choice.md), you can offer site credit as one of several main draw prizes. It is paid into the winner's wallet for you after a TrueNorth draw, or with **Pay prize** otherwise.

#### Cashback

Set a cashback percentage and customers earn site credit back on every completed order. [See how to set up Cashback.](#set-up-cashback)

{% hint style="info" %}
Want to know exactly how cashback is worked out, when it is paid, and what happens to it if you cancel an order? See [How Cashback Works](https://docs.rafflex.io/additional-settings/wallet-and-withdrawals/site-credit-and-wallets/cashback-explained.md).
{% endhint %}

#### Other ways credit arrives

* **Affiliate rewards**, if you run the [Affiliate Referral Scheme](https://docs.rafflex.io/marketing/affiliate-referral-scheme/setting-up-the-scheme.md).
* **Winlink fallbacks**, when a [Winlink prize](https://docs.rafflex.io/create-your-first-raffle/add-instant-wins/winlink-explained.md) cannot be given as free tickets.
* **Refunds to site credit**, when you [cancel an order](https://docs.rafflex.io/managing-your-site/orders/cancelling-and-refunding-orders.md) and choose to refund it to the customer's wallet.
* **Wallet top ups**, where customers add money to their own wallet by card (see [Wallet Top Ups](#wallet-top-ups)).

***

### What Customers See in Their Wallet

Signed in customers see their credit balance in your site's header, next to a small coin icon. Clicking it takes them to **My Wallet** in their account. They can also reach it from their account menu.

The **My Wallet** page shows:

* A **Site Credit** card with their current balance.
  * If withdrawals are switched on, it says **Spend this at the checkout, or withdraw it to your bank account.** and shows a **Withdraw** button.
  * If withdrawals are switched off, it shows a **Spend only** badge and says **Spend this at the checkout. Site credit cannot be withdrawn to your bank.**
  * A **Top Up Wallet** button, if you allow top ups.
* A **Transactions** table listing every movement of credit, newest first, ten at a time with **Previous** and **Next** buttons. Each row has a **Description**, a **Type** and an **Amount**:
  * **Deposit** for money coming in, such as wins, cashback, refunds, top ups and credit you add. These show in green with a plus sign.
  * **Payout** for withdrawals to the customer's bank.
  * **Spent** for credit used at the checkout or removed by you.

{% hint style="success" %}
The **Description** is what the customer reads, so the descriptions you type when adding or removing credit really matter. Keep them clear and friendly, for example "Prize for winning the Weekend Cash Draw".
{% endhint %}

At the checkout, customers choose to pay with their credit using the **Wallet** or **Wallet + Card** option. Credit is never used without them choosing it. See [Paying with the wallet at checkout](https://docs.rafflex.io/additional-settings/wallet-and-withdrawals.md#paying-with-the-wallet-at-checkout).

***

### Allow Customers to Withdraw from Their Wallet

{% hint style="info" %}
If you would rather only winnings could be withdrawn, use the [Cash Wallet](https://docs.rafflex.io/additional-settings/wallet-and-withdrawals/site-credit-and-wallets/cash-wallet.md) instead. It keeps winnings in a separate cash balance, and site credit can then only be spent.
{% endhint %}

1. In the admin panel, open **Settings** in the left-hand menu, then click **Checkout**.
2. In the **Wallet Settings** section, switch on **Allow Users To Withdraw Credit**.
3. Check the **Minimum Withdrawl Value** in the same section. This is the smallest amount a customer can withdraw at once.
4. Click **Save Settings**.

Customers can now request withdrawals from their wallet, and requests appear under **Management**, then **Withdrawals** in your admin panel. For the full guide, including photo ID checks and **One Withdrawal At A Time**, see [Wallet & Withdrawals](https://docs.rafflex.io/additional-settings/wallet-and-withdrawals.md). To pay or reject requests, see [Processing Withdrawals](https://docs.rafflex.io/additional-settings/wallet-and-withdrawals/processing-withdrawals.md). You can also keep a record of requests with the [Customer Withdrawals](https://docs.rafflex.io/managing-your-site/downloads/customer-withdrawals.md) report.

***

### Wallet Top Ups

Top ups let customers add their own money to their wallet by card, ready to spend on competitions later. They are switched on by default.

* Customers click **Top Up Wallet** on their **My Wallet** page, fill in their billing details and a **Top Up Amount**, then click **Top Up** and pay by card.
* A top up is processed like any other order, so it appears in your orders list.
* Top ups are paid by card through your card payment provider, just like entries. If customers cannot top up, first check that card payments work on your site (see [Payment Gateway](https://docs.rafflex.io/getting-started/payment-gateway.md)). If entries go through but top ups still fail, send RaffleX support a screenshot of the error.
* The smallest top up is 10 in your site's currency, in whole amounts. This minimum cannot be changed.
* The **Top Up Wallet** button is hidden for any customer who is currently in a timeout.

To switch top ups off:

1. In the admin panel, open **Settings**, then click **Checkout**.
2. In the **Wallet Settings** section, switch off **Enable Wallet Top Up**.
3. Click **Save Settings**.

{% hint style="info" %}
Turning off top ups is a good idea if you only want customers to earn credit (for example from instant wins) rather than buy it.
{% endhint %}

***

### Add or Remove Site Credit for a Customer

Use this to pay out a site credit prize, give a goodwill gesture, or correct a balance.

1. In the admin panel, open **Management** in the left-hand menu and click **Users**.
2. Find the customer (use the search bar if needed) and open their account. If you need help finding someone, see [Customers](https://docs.rafflex.io/managing-your-site/customers.md).
3. Click the **Actions** button at the top right of the page, then click **Wallet**.
4. The window shows the customer's **Current Wallet Balance** at the top. Choose what you want to do:
   * **Add Site Credit** adds credit the customer can spend on competitions.
   * **Remove Site Credit** takes credit away from their balance. This cannot be undone.
5. Enter the **Amount**, for example 2.00. When removing credit, the box shows the most you can remove, which is the customer's current balance.
6. Type a **Customer Transaction Description**. The customer sees this in their wallet, so explain the reason clearly, for example "Prize for winning the Weekend Cash Draw".
7. If you want the customer to get an email about the change, switch on **Send email notification to customer**. It is off by default.
8. Tick the confirmation box. It repeats what you are about to do, for example **I confirm I want to ADD £5.00 to this user's wallet**. You cannot submit without ticking it.
9. Click **Submit**.

You will see a green **Success** message confirming the amount you added or removed. The change shows in the customer's wallet straight away, and your admin name is saved with the transaction for your records. You can review every movement of the customer's credit in the **Wallet Transactions** list further down their account page. For a full tour of that page, see [Customers](https://docs.rafflex.io/managing-your-site/customers.md).

{% hint style="warning" %}
If you try to remove more than the customer has, you will see an **Insufficient Balance** message and nothing is taken. Check their **Current Wallet Balance** and try a smaller amount.
{% endhint %}

{% hint style="success" %}
Use **Add Site Credit** to pay out competition wins in site credit. Double check the amount before ticking the confirmation box, because the credit is available to spend immediately.
{% endhint %}

***

### Set Up Cashback

Cashback gives customers a percentage of each completed order back as site credit.

1. In the admin panel, open **Settings** in the left-hand menu, then click **Checkout**.
2. In the **Order & Cart Settings** section, find **Cashback Percentage**.
3. Enter the percentage you want to give back, for example **5** for 5%. You can use up to two decimal places, such as **2.5**.
4. Click **Save Settings**.

To switch cashback off, set **Cashback Percentage** to **0** and save.

Once cashback is on, customers see a banner at the checkout telling them how much cashback they will earn, and the credit is added to their wallet when their order completes. For the details, see [How Cashback Works](https://docs.rafflex.io/additional-settings/wallet-and-withdrawals/site-credit-and-wallets/cashback-explained.md).

***

### Change the Wallet Icon (Optional)

The small coin icon next to your customers' credit balance can be replaced with your own branded icon. This is the **Custom Icon** in your branding settings. Upload a square **PNG** with a transparent background, ideally **100 x 100 pixels**.

For step by step instructions, see the **Add a Custom Icon** section of [Add Your Logo](https://docs.rafflex.io/customise-your-site/add-your-logo.md).

***

### Related pages

{% content-ref url="/pages/BcZ3EpDxIjeZXRcgQ2ec" %}
[Wallet & Withdrawals](https://docs.rafflex.io/additional-settings/wallet-and-withdrawals.md)
{% endcontent-ref %}

{% content-ref url="/pages/vZxnYoSVQU0o9GICuAWR" %}
[Processing Withdrawals](https://docs.rafflex.io/additional-settings/wallet-and-withdrawals/processing-withdrawals.md)
{% endcontent-ref %}

{% content-ref url="/pages/NQjbQqrcSh5PKDiMZR7Z" %}
[How Cashback Works](https://docs.rafflex.io/additional-settings/wallet-and-withdrawals/site-credit-and-wallets/cashback-explained.md)
{% endcontent-ref %}
