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

# Wallet System

> Allow your users to store funds on their account and use it to pay for their Subscription and Prepaid plans

<Warning>Wallet System is part of SaaS features, hence it requires you to have Extended License</Warning>

## Introduction

Wallet system allows your users to redeem **Gift Cards** that you generate for them, which they can use to pay for Subscription and Prepaid plans, and also transfer between each other if needed.
Wallet system provides you full control of gift card generation, analytical data on how, when and by whom they were used.

## Wallet System configuration

To active **Wallet System** and let your users earn along with you, follow the steps listed below.

<Steps>
  <Step title="Step 1">
    Go to the **Marketplace** in **Admin Panel** and install **Wallet** extension.

    <img src="https://mintcdn.com/magicads/srGibq66qvweFJdz/images/saas/wallet/wallet-1.png?fit=max&auto=format&n=srGibq66qvweFJdz&q=85&s=295ec0bb87dfc38fb3acbc506161ef85" width="403" height="286" data-path="images/saas/wallet/wallet-1.png" />
  </Step>

  <Step title="Step 2">
    After installation is completed, go to **AI Settings** page in Admin Panel and click on **Extensions** tab there. Click on **Wallet System** tab there.

    <img src="https://mintcdn.com/magicads/srGibq66qvweFJdz/images/saas/wallet/wallet-2.png?fit=max&auto=format&n=srGibq66qvweFJdz&q=85&s=992778016b15c5bc53ee525d89122363" width="518" height="105" data-path="images/saas/wallet/wallet-2.png" />
  </Step>

  <Step title="Step 3">
    From here you can **Enable** or completly **Disable** wallet feature for all users by toggling `Enable/Disable Wallet System Feature` checkbox. Once done with configuration, click on the **Save** button.

    <img src="https://mintcdn.com/magicads/srGibq66qvweFJdz/images/saas/wallet/wallet-3.png?fit=max&auto=format&n=srGibq66qvweFJdz&q=85&s=5a27433932deb62be80d59a4cb9ef9b1" width="570" height="329" data-path="images/saas/wallet/wallet-3.png" />
  </Step>

  <Step title="Step 4">
    <Check>
      Congratulations! You now have completed setting up your Wallet System.
    </Check>
  </Step>
</Steps>

## Gift Cards Generation

As user with Admin credentails, you can generate gift cards for your users which they can redeem via their profile page.

<Steps>
  <Step title="Step 1">
    To generate new **Gift Cards**, go to **Finance Management** tab in Admin Panel and click on **Gift Cards** tab.

    <img src="https://mintcdn.com/magicads/srGibq66qvweFJdz/images/saas/wallet/wallet-4.png?fit=max&auto=format&n=srGibq66qvweFJdz&q=85&s=df121982cb8f3da6943c994c905e80f5" width="272" height="423" data-path="images/saas/wallet/wallet-4.png" />
  </Step>

  <Step title="Step 2">
    Next, click on **Create New Gift Card** button.
  </Step>

  <Step title="Step 3">
    You will be shown Gift Card creation page, fill in the fields as you prefer and click **Create** button.

    <img src="https://mintcdn.com/magicads/srGibq66qvweFJdz/images/saas/wallet/wallet-5.png?fit=max&auto=format&n=srGibq66qvweFJdz&q=85&s=2c88ea521707a36ea701903343c81fbf" width="642" height="632" data-path="images/saas/wallet/wallet-5.png" />
  </Step>

  <Step title="Step 4">
    Under **All Gift Cards** table, you can see each and every created gift card, full information about them and `edit` or `delete` as needed

    <img src="https://mintcdn.com/magicads/srGibq66qvweFJdz/images/saas/wallet/wallet-6.png?fit=max&auto=format&n=srGibq66qvweFJdz&q=85&s=62984ea744b720e642dab0e7ebbc5523" width="1349" height="595" data-path="images/saas/wallet/wallet-6.png" />
  </Step>

  <Step title="Step 5">
    Under **Transfers by Users** table, you can track each transfer made between your users and view record information.

    <img src="https://mintcdn.com/magicads/srGibq66qvweFJdz/images/saas/wallet/wallet-7.png?fit=max&auto=format&n=srGibq66qvweFJdz&q=85&s=f2331ac85422162cdec13a902cca3de8" width="1346" height="556" data-path="images/saas/wallet/wallet-7.png" />
  </Step>

  <Step title="Step 6">
    You can also **export** all your created gift cards via **Export Gift Cards** button. You have full flexibity to filter out needed gift cards, and export in one of the following file formats: **csv, xlsx, pdf**

    <img src="https://mintcdn.com/magicads/srGibq66qvweFJdz/images/saas/wallet/wallet-8.png?fit=max&auto=format&n=srGibq66qvweFJdz&q=85&s=117b790313a468474b2d25fec9f81201" width="447" height="689" data-path="images/saas/wallet/wallet-8.png" />
  </Step>

  <Step title="Step 7">
    <Check>
      This completes the Gift Card creation process.
    </Check>
  </Step>
</Steps>

## How it Works for User

After you shared a gift card with your users, they can redeem them via their profile page once they are logged in.

<Steps>
  <Step title="Step 1">
    In the User Panel, go to the **My Account** tab. And click on **My Wallet** tab there.

    <img src="https://mintcdn.com/magicads/srGibq66qvweFJdz/images/saas/wallet/wallet-9.png?fit=max&auto=format&n=srGibq66qvweFJdz&q=85&s=e6c62ddab5ee264928c9804df55b6caf" width="306" height="238" data-path="images/saas/wallet/wallet-9.png" />
  </Step>

  <Step title="Step 2">
    Once you are on your My Wallet page, under the **Redeem Gift Codes** section, enter your gift card code and click **Redeem** button.

    <img src="https://mintcdn.com/magicads/srGibq66qvweFJdz/images/saas/wallet/wallet-10.png?fit=max&auto=format&n=srGibq66qvweFJdz&q=85&s=4fb58c548c90052a96c95fe791d02881" width="989" height="260" data-path="images/saas/wallet/wallet-10.png" />
  </Step>

  <Step title="Step 3">
    You can also transfer your wallet funds to existing users on the platform via **Transfer Your Wallet Balance to Frieds** section. Make sure you know their emails first.

    <img src="https://mintcdn.com/magicads/srGibq66qvweFJdz/images/saas/wallet/wallet-11.png?fit=max&auto=format&n=srGibq66qvweFJdz&q=85&s=9b8dd24a015df628a42238a9ca2c2237" width="988" height="352" data-path="images/saas/wallet/wallet-11.png" />
  </Step>

  <Step title="Step 4">
    You can see full statistics of redeemed funds, etc as well.

    <img src="https://mintcdn.com/magicads/srGibq66qvweFJdz/images/saas/wallet/wallet-12.png?fit=max&auto=format&n=srGibq66qvweFJdz&q=85&s=cfa9608b86fda033319abcdd2e56c5e7" width="997" height="108" data-path="images/saas/wallet/wallet-12.png" />
  </Step>

  <Step title="Step 5">
    Users can also see their previous redeemed gift cards in a read-only mode.

    <img src="https://mintcdn.com/magicads/srGibq66qvweFJdz/images/saas/wallet/wallet-13.png?fit=max&auto=format&n=srGibq66qvweFJdz&q=85&s=2ce2077087056ecc28209e93a71b578f" width="992" height="404" data-path="images/saas/wallet/wallet-13.png" />
  </Step>

  <Step title="Step 6">
    <Check>
      Congratulations! You now have successfully redeemed your first Gift Card.
    </Check>
  </Step>
</Steps>

## Pay for Prepaid | Subscription plans

As admin, you can allow/disable using wallet system for paying for Subscription and Prepaid plans upon checkout just like with any other payment gateway.

1. Go to the **Admin Panel** -> **Finance Management** -> **Finance Settings** page and select **Wallet** from the list.

<img src="https://mintcdn.com/magicads/srGibq66qvweFJdz/images/saas/wallet/wallet-14.png?fit=max&auto=format&n=srGibq66qvweFJdz&q=85&s=0b14f58a227611cc44dcce700fbd4553" width="463" height="103" data-path="images/saas/wallet/wallet-14.png" />

2. **Turn on/off** checkboxes as you prefer for both Prepaid and Subscription plans. Once you are done with the configuration, click on the **Save** button.

<img src="https://mintcdn.com/magicads/srGibq66qvweFJdz/images/saas/wallet/wallet-15.png?fit=max&auto=format&n=srGibq66qvweFJdz&q=85&s=54536282f8d8b3c212061be6fe88111d" width="751" height="312" data-path="images/saas/wallet/wallet-15.png" />

3. Now, all users will see Wallet in the list of payment options upon checkout, and if they have sufficient funds in their wallets, they will be able to pay with it for their selected subcription or prepaid plans.
4. <Check>
     Congratulations! This completes the configuration of wallet system for payment.
   </Check>
