Knowledge Base

Cookie Alert Banner Settings

This section allows you to enable and customize a cookie consent banner on your website. This is essential for complying with privacy regulations like GDPR.

rn
• Enable Cookie Alert Banner: Check this box to display the cookie consent banner to new visitors.
rn
• Cookie Alert Message: The text that will be displayed within the banner. You can use HTML to format the message and, most importantly, to link to your Privacy Policy page.
  Example with a link:rn

  We use cookies to enhance your experience. To learn more, please read our <a href="/page/privacy-policy">Privacy Policy</a>.

  rn
rn

When enabled, the banner will typically be shown at the bottom of the screen until the user accepts or dismisses it.

System Settings: E-Commerce Logic

This section controls the core financial and operational rules for your marketplace, such as taxes, shipping, and user permissions.

Tax & Pricing

rn
• Default Tax Rate (%): Enter a default tax percentage that will be applied to orders. Set to 0.00 if you do not wish to apply a default tax.
rn
• Price Entry Method: Choose how you will enter product prices in the admin panel.rn
  rn
  • Prices Entered Exclude Tax: Choose this if your product prices do not include tax. The tax will be calculated and added at checkout. (e.g., $100 + 10% tax = $110 total).
  rn
  • Prices Entered Include Tax: Choose this if your product prices already have tax factored in. The system will calculate how much of the total price is tax. (e.g., $110 total includes $10 of tax).
  rn
  rn
rn

Shipping

rn
• Default Shipping Type: Select the pre-selected shipping method that will appear in the user

System Settings: Legal Documents & Comments

This section is crucial for managing your site

Managing Languages

This section allows you to add new languages to your site, making your platform truly multilingual. You can also manage existing languages by setting a default, editing translations, or deleting them.

How to Add a New Language (Easy Copy Method)

Our system is designed to make adding new languages incredibly simple. When you add a new language, the system automatically copies all existing text keys from your default language (English), so you only need to translate the values.

rn
1. Language Name: Enter the full name of the language you want to add (e.g., German, French, Spanish).
rn
2. Language Code: Enter the official 2-letter language code (e.g., de for German, fr for French, es for Spanish).
rn
3. Click the "Add Language & Copy Keys" button.
rn

That

Translating Language Text

After adding a new language, this is where you perform the actual translation. The system uses a "key-value" pair structure. You only need to change the text (value), not the identifier (key).

Understanding the Interface

rn
• Language Tabs: At the top, you

Managing Blockchain Networks

This section is the foundation of your marketplace

Managing Payment Currencies

This page allows you to specify which cryptocurrencies your customers can use for payments. You can add both native coins (like ETH, BNB) and tokens (like USDT, USDC).

rn

CRITICAL WARNING: DO NOT MODIFY

rn

The contract addresses listed below are fundamental to the operation of your marketplace. They handle payment routing, transaction verification, and fee collection.

rn

Altering, editing, or deleting these addresses will cause an immediate and total failure of the payment system. Customers will not be able to make purchases, and you will not receive any funds. These values should only ever be changed if you are explicitly instructed to do so in an official update from our team.

rn

Understanding the Currency List

rn
• Name: The full name and symbol of the currency (e.g., "USDT (Tether USD)").
rn
• Network: The blockchain network on which this currency operates. This must be one of the networks you configured in the "Networks" section.
rn
• Type:rn
  rn
  • Native: The primary currency of a blockchain used to pay for gas fees (e.g., ETH on Ethereum, BNB on BSC).
  rn
  • Token: A separate smart contract deployed on a blockchain (e.g., USDT, USDC, or your own custom token).
  rn
  rn
rn
• Token Address: This is the smart contract address of the token. For "Native" currencies, this is not applicable (N/A). It is critical that you enter the correct token address. You can find the official address on block explorers like Etherscan or BscScan.
rn
• Status: "Active" means customers can select this currency for payment.
rn

Core Smart Contract Addresses & Payment Logic

This page lists the core smart contract addresses that are integral to the payment processing logic of the platform. These addresses belong to the web3cart crypto payment platform and are essential for the system to function correctly.

rn

CRITICAL WARNING: DO NOT MODIFY

rn

The contract addresses listed below are fundamental to the operation of your marketplace. They handle payment routing, transaction verification, and commission processing.

rn

Altering, editing, or deleting these addresses will cause an immediate and total failure of the payment system. Customers will not be able to make purchases, and you will not receive any funds. These values should only ever be changed if you are explicitly instructed to do so in an official script update.

rn

Default XPAyr Contract Addresses

rn
• Ethereum Mainnet:
  0x856386E0f4c0A2566C7E95A3D19861f55A339611
  View on Etherscan
rn
• BSC Mainnet:
  0x384cD2f5Ce9Aa55d71D60fFb3d4cab33642eBb21
  View on BscScan
rn
• Sepolia Testnet:
  0x2b2d9e2F7bD23BE1d62D8C3aaEe3D1cbDEFA37aB
  View on Sepolia Etherscan
rn
• BSC Testnet:
  0xA1C35F2Da8531ec051B91542a01C0166275b8036
  View on BSC Testnet Scan
rn

How Payments Work with web3cart

To process cryptocurrency payments, Web3 e-Commerce uses the smart contracts of web3cart, one of the industry

Reviewing KYC Submissions

This page is your central hub for managing all user identity verification (KYC - Know Your Customer) submissions. Here, you can review, approve, or reject the documents provided by your users to ensure compliance and platform security.

Understanding the Submissions Table

rn
• KYC ID: A unique identification number for each submission attempt.
rn
• User / Email: The user who submitted the documents.
rn
• Document Type: The type of document submitted (e.g., ID Card, Passport). "N/A" means the user has not yet submitted a document.
rn
• File: A direct, clickable link to the document file that the user uploaded.
rn
• Upload Date: The date and time the document was submitted.
rn
• Status: The current state of the verification process.rn
  rn
  • Awaiting Document: The user has been prompted for KYC but has not uploaded a file yet.
  rn
  • Pending Review: The user has uploaded a document, and it is waiting for your approval.
  rn
  • Approved: You have successfully verified the user

KYC Settings: Transaction Thresholds

This section allows you to define automated rules for when a user is required to complete the KYC verification process. A threshold is a cumulative transaction limit for a specific cryptocurrency. When a user

AML (Anti-Money Laundering) Rule Settings

This advanced section helps you configure automated rules to detect and flag potentially suspicious activities on your platform, contributing to Anti-Money Laundering (AML) compliance.

Block Explorer API Keys

To analyze transactions on the blockchain, the system needs API keys from block explorer services. These keys allow the platform to fetch transaction data automatically. You can obtain free API keys from the official websites linked below:

rn
• Etherscan API Key: For Ethereum Mainnet. Get Key Here.
rn
• BscScan API Key: For BSC Mainnet. Get Key Here.
rn
• BaseScan API Key: For Base Mainnet. Get Key Here.
rn
• PolygonScan API Key: For Polygon Mainnet. Get Key Here.
rn

Transaction Rules

These rules define thresholds for flagging transactions based on value and frequency.

rn
• High Value Threshold (USD): Any single transaction exceeding this value (in USD equivalent) will be automatically flagged for review.
rn
• Rapid Transfer Count: The number of transactions within a specific time window that will trigger a flag.
rn
• Rapid Transfer Window (Hours): The duration (in hours) for the "Rapid Transfer Count" rule.
rn

Example: With a Count of 5 and a Window of 24, any user who makes more than 5 transactions in any 24-hour period will be flagged.

New Wallet Rules

These rules apply additional scrutiny to newly created or first-seen wallet addresses, which can be higher risk.

rn
• New Wallet Threshold (Days): A wallet is considered "new" for this many days after its first transaction on your platform.
rn
• High Transaction Count Threshold: The maximum number of transactions a "new" wallet can make within the defined period before being flagged.
rn

After configuring these rules, click "Save Settings" to apply them system-wide.

Homepage Modules Management

This powerful page gives you complete visual control over your website

Introduction to Adding Products

The "Create Product" page is your starting point for listing items on the marketplace. Before you can add a product, you must first register your wallet as a seller on the specific blockchain network where you intend to list the item.

rn

IMPORTANT: Seller registration is a one-time process for each blockchain network. This action links your wallet to our smart contract on that network, authorizing you to create products and receive payments.

rn

Step 1: Seller Registration on a Network

If you have not registered as a seller on a specific network yet, you will be prompted to do so.

rn
1. Select Your Network: From the dropdown menu, choose the blockchain network where you want to add your product (e.g., BSC Mainnet, Ethereum Mainnet).
rn
2. Connect Wallet: Click the "Connect Wallet" button.
rn
3. Choose Your Wallet: A pop-up will appear with a list of compatible wallets (MetaMask, Keplr, etc.). Select the wallet you want to register.
rn
4. Approve Transaction: Your wallet will ask for confirmation to interact with our smart contract. Approve the transaction to complete the registration.
rn

Once confirmed, you will see a "Registration Confirmed!" message. You are now a registered seller on that specific network.

Note: If you later wish to add a product on a different network (e.g., you registered on BSC Mainnet but now want to sell on Ethereum), you must return to this page, select the new network, and complete the registration process again for that network.

Step 2: Choose Your Product Type

After successful registration, you will be asked to choose the type of product you want to add:

rn
• Physical Product: Select this for tangible items that require shipping to the customer. This form includes stock management options.
rn
• Digital Product: Select this for items that are delivered electronically, such as software, e-books, music, or design files. This form includes options for downloadable files.
rn

After selecting a product type, you will be taken to the detailed product creation form. Please refer to our guides on "Creating a Physical Product" or "Creating a Digital Product" for an explanation of all the fields.

Adding a New Physical Product

This form contains all the necessary fields to create a listing for a physical item that requires shipping.

rn
• Name & Permalink: Enter the product name. The permalink (URL slug) will be generated automatically, but you can edit it for SEO purposes.
rn
• Media: Upload a main "Featured Image," multiple "Gallery Images," and optionally add a "Video Link" from a platform like YouTube.
rn
• Description: The "Short Description" is a brief summary, while the "Full Description" is for detailed information, specifications, etc. Both fields support rich text formatting.
rn
• Pricing:rn
  rn
  • Price & Currency: Set the main price and the cryptocurrency it will be sold for.
  rn
  • Previous Price: An optional field to show a "slashed" original price, indicating a discount.
  rn
  • Special Price: An optional discounted price. You can set a start and end date to run a limited-time promotion.
  rn
  rn
rn
• Options: Toggle "Is featured?" to display this product in "Featured Products" sections on your homepage.
rn
• Organization: Assign the product to a "Brand" and one or more "Categories."
rn
• Collections: Add the product to special collections like "Best Sellers" or "Special Offers."
rn
• Labels: Add visual labels like "Hot," "New," or "Sale" that will appear on the product card.
rn
• Stock Management: Enter the "Total in stock" quantity for this product. The system will track inventory as sales are made.
rn
• Tax: Select a tax rate to apply to this product at checkout.
rn
• -
rn
• SKU: Enter a unique Stock Keeping Unit (SKU) to identify the product internally.
rn
• Tags & SEO: Add relevant tags for searching and fill in the "SEO Meta Title" and "SEO Description" to improve your ranking in search engines.
rn

Once you have filled in all the details, click "Create Product" to list your item.

Adding a New Digital Product

The form for adding a digital product shares most of its fields with the physical product form. Please refer to our "Creating a Physical Product" guide for details on the common sections like Name, Media, Description, Pricing, Organization, etc.

This guide will focus on the sections unique to digital products.

The "Downloadable Product" Section

This is the most important section for a digital item. It controls how your customer receives the file after purchase.

rn
• Download Type:rn
  rn
  • File Upload: Choose this to upload the file directly to your server. The file will be stored securely.
  rn
  • URL: Choose this if your file is hosted on an external service (like Amazon S3, Google Drive, or Dropbox). You will then provide a direct download link.
  rn
  rn
rn
• Choose File / File URL: Based on your selection above, either upload the file from your computer or paste the direct download link. Note the maximum file size limit (e.g., 50MB).
rn
• Download Limit: Specify the maximum number of times a customer can download the file after purchase. Leave this field blank for unlimited downloads.
rn

Missing Sections

Compared to a physical product, a digital product form does not include the "Stock Management" section, as digital items typically have unlimited inventory.

Once you have filled in all the details, click "Create Product" to list your item.

Managing Product Categories

This is your central hub for organizing all products in your marketplace. A well-structured category tree is essential for helping customers find the items they are looking for. This page allows you to create, edit, re-organize, and delete product categories and subcategories.

Category Structure

The left panel displays your entire category hierarchy in a nested tree format. You can manage this structure using the following tools:

rn
• Add Root Category: Click this to create a new top-level category (e.g., "Electronics", "Clothing"). A form will appear on the right to enter the details for this new category.
rn
• Add Subcategory: First, select a parent category from the tree structure on the left by clicking on its name. Then, click this button to create a new category nested under the one you selected (e.g., creating "Laptops" under "Electronics").
rn
• Expand All / Collapse All: Use these links to quickly show or hide all subcategories in the tree, making it easier to navigate large structures.
rn
• Re-ordering Categories: You can change the order of categories at the same level by simply clicking and dragging a category to a new position within its parent.
rn

Editing a Category

When you click on a category from the structure on the left, its details will appear in the "Edit Category" panel on the right. This panel is organized into three tabs:

1. General Tab

rn
• ID: A unique, non-editable number that identifies the category in the database.
rn
• Full Name: The public-facing name of the category (e.g., "Computer").
rn
• Slug (URL-friendly-name): The version of the name used in the website

Flash Sale Campaigns

Flash sales are a powerful marketing tool to create urgency and boost sales for a limited time. This section allows you to create, manage, and add products to your flash sale campaigns.

Step 1: Creating a New Campaign

The main "Flash Sale Campaigns" page lists all your current and past campaigns.

rn
1. To start, click the "+ Create" button in the top right corner.
rn
2. A "Create New Campaign" pop-up will appear.
rn
3. Campaign Name: Give your sale a descriptive name (e.g., "Summer Sale", "Black Friday Deals").
rn
4. End Date: Select a date and time when the campaign will automatically end. All product prices will revert to their original values after this time.
rn
5. Publish: Use this toggle to set the campaign

Managing Coupons

The Coupons section allows you to create and manage discount codes that customers can apply at checkout to receive a promotional discount. You can create percentage-based, fixed-amount, time-limited, and usage-limited coupons.

Step 1: Creating a New Coupon

To begin, click the "+ Add" button in the top right corner. The "Add New Coupon" window will appear with the following fields:

rn
• Coupon Title: A user-friendly name for your reference (e.g., "Summer Sale 10% Off"). This is not visible to the customer.
rn
• Coupon Code: The actual code that customers will enter at checkout (e.g., SUMMER10). Keep it simple and easy to remember.
rn
• Discount Type: Choose the type of discount.rn
  rn
  • Percentage: A percentage of the order total will be discounted (e.g., 10%).
  rn
  • Fixed Amount: A specific, fixed amount will be discounted from the order total (e.g., $30).
  rn
  rn
rn
• Discount Value: The numerical value of the discount (e.g., enter 10 for a 10% discount, or 30 for a $30 discount).
rn
• Usage Limit (per user): The maximum number of times a single customer can use this coupon. Leave this field blank for unlimited uses per customer.
rn
• Start Date & End Date: Set the period during which the coupon is valid. The coupon will not work outside of these dates.
rn

After filling in the details, click "Save" to create the coupon.

Step 2: Managing Existing Coupons

The main page displays a list of all the coupons you have created. Here

Managing Shipping Rules

This section allows you to configure the shipping methods and costs that will be offered to your customers during checkout. You can define different methods (like "Flat Rate" or "Express") and set their prices for each cryptocurrency you accept.

Understanding the Shipping Rules List

The main page provides an overview of all available shipping methods.

rn
• Title: The name of the shipping method that customers will see (e.g., "Flat Rate").
rn
• Defined Prices: This column lists the shipping costs you have set for each specific cryptocurrency.
rn
• Default: One method must be set as the default. This will be the pre-selected option in the customer

Managing Navigation Menus

The Menus section allows you to create, edit, and manage all navigation menus on your website, such as the main header menu or a footer menu. The system is structured in three levels: Menus List, the Menu Builder, and the Menu Item Editor.

Step 1: The Menus List

This is the main page where you manage your menu "containers". For example, you might have a "Primary Menu" for your header and a "Footer Links" menu for your footer.

rn
• Create Menu: Click this to create a new, empty menu container.
rn
• Actions:rn
  rn
  • Edit (Pencil Icon): Click this to open the Menu Builder for that specific menu, where you will add and arrange the links.
  rn
  • Delete (Trash Icon): Permanently removes a menu and all its items.
  rn
  rn
rn

Step 2: The Menu Builder (e.g., Primary Menu)

After clicking "Edit" on a menu, you are taken to the Menu Builder. This is where you construct the structure of your menu.

rn
• Create Menu Item: Click this to add a new link (item) to the menu. This will take you to the "Edit Menu Item" screen.
rn
• Menu Item List: This area shows all the links currently in your menu.rn
  rn
  • Re-ordering: You can change the order of menu items by simply clicking and dragging an item to a new position.
  rn
  • Creating Sub-menus: To create a sub-menu (dropdown), drag an item slightly to the right underneath another item. It will become a "child" of the item above it.
  rn
  • Actions: Click the "Edit" icon to modify a specific menu item, or the "Delete" icon to remove it from the menu.
  rn
  rn
rn
• Menu Details: On the right, you can update the internal name of the menu and enable or disable it globally.
rn

Step 3: The Menu Item Editor

This is where you define the details for a single link in your menu.

rn
• Name: The text that will be visible to users on the website (e.g., "Home", "Contact Us").
rn
• Type: The kind of link you are creating. Common options include:rn
  rn
  • URL: A link to any internal or external web address.
  rn
  • Page: A direct link to one of the pages you created under the "Pages" section.
  rn
  • Category: A link to a specific product category page.
  rn
  rn
rn
• URL: The destination link. Use a relative path like /about for internal pages or a full URL like https://example.com for external sites.
rn
• Icon: You can add an icon next to the menu name (e.g., Font Awesome classes like fas fa-home).
rn
• Target: Choose whether the link opens in the "Same Tab" or a "New Tab" (_blank).
rn
• Parent Menu Item: Use this to manually assign a parent for creating sub-menus. "Root" means it is a top-level item.
rn
• Enable the menu item: A switch to show or hide this specific link without deleting it.
rn

Click "Save" to apply your changes to the menu item.

BSC Installation Video Guide

Follow the steps in the video below to complete the installation process on the Binance Smart Chain (BSC).

The Faucet is a tool that allows you to claim free test tokens to experiment with the platform on various test networks. These tokens have no real-world value and are used only for testing purposes.

Understanding the Faucet Page

The main Faucet page provides a simple, step-by-step interface to receive test funds.

rn
• Select a Test Network: This dropdown menu lists all the available test networks where you can claim tokens (e.g., "BSC Testnet"). You must select a network before proceeding.
rn
• Connect Wallet Button: After selecting a network, this button becomes your primary action. Clicking it will open a wallet selection modal.
rn
• Connected Wallet Address: Once your wallet is successfully connected, this field will appear, displaying your public wallet address.
rn
• Action Buttons: After connecting, two new buttons will become available:rn
  rn
  • Add Token to Wallet: An optional but helpful step that adds the token

Follow the steps in the video below to complete the token request process for Testnet USDT on the Binance Smart Chain (BSC).

Web3cart PHP Script with Crypto Payments & Smart Contracts

Web3cart is a revolutionary, feature-packed PHP script that empowers you to build a cutting-edge, decentralized online store. Go beyond traditional e-commerce and step into the future by accepting direct cryptocurrency payments for both physical and digital products. Built on a secure and modern technology stack, this platform combines the familiarity of a professional e-commerce experience with the power and trustlessness of blockchain technology.

Are you tired of paying high fees to middlemen, waiting for payouts, and dealing with fraudulent chargebacks? Web3cart solves all of this. By leveraging the power of blockchain, we put you back in control. This isn

Our platform is engineered with a comprehensive suite of professional tools designed for a true Web3 environment.

rn
• Direct Crypto Payments: Accept wallet-to-wallet payments with no intermediaries. Supports native coins (ETH, BNB) and tokens (USDT, USDC, etc.) across multiple chains.
rn
• Sell Physical & Digital Products: The ultimate flexibility. Manage shippable goods with advanced shipping rules and sell digital products with instant, secure delivery from a single platform.
rn
• Multi-Chain Architecture: Don

Why Choose Web3cart for Your Online Business?

rn
• Slash Your Costs, Boost Your Profits: Stop paying the exorbitant 3-5% fees charged by traditional payment gateways. With our platform, you receive payments with commissions as low as 1% or less per transaction, plus the blockchain

Initial Release.

Joining the web3cart marketplace as a vendor allows you to build your brand and sell your products to a wider audience. The registration process is simple and begins on our main registration page.

Step-by-Step Registration Guide:

rn
1. rn

   Navigate to the main Register page on web3cart.

   rn
rn
2. rn

   You will see a section titled "Register as".

   rn
rn
3. rn

   By default, "I am a customer" may be selected. You must select the "I am a vendor" option.

   rn
rn
4. rn

   Selecting this option will typically expand the form to include fields relevant to your business or store (e.g., Store Name, Store link).

   rn
rn
5. rn

   Complete all required fields in the registration form.

   rn
rn
6. rn

   Read and accept the Terms of Service.

   rn
rn
7. rn

   Click the "Register" (veya "Submit Application") button to complete your submission.

   rn
rn

What Happens Next?

After you submit your application, your account will be placed in a pending status. Our administrative team will review your submission to ensure it meets our marketplace guidelines. This review process is detailed in our "Understanding Your Account Status" article.

After you apply to become a vendor, your account will be assigned a status based on the review process. This status determines your access to the vendor dashboard and marketplace features.

Here are the primary statuses you may encounter:

1. Unverified Vendor (Pending Approval)

rn
• rn

  What it means: This is the default status for all new vendor applications. It indicates that you have successfully submitted your registration form, and it is now in the queue for review by our admin team.

  rn
rn
• rn

  Your access: During this time, you will not have access to the vendor dashboard or be able to list products.

  rn
rn
• rn

  Action required: No action is needed from you unless our team contacts you for additional information.

  rn
rn

2. Vendor (Approved)

rn
• rn

  What it means: Congratulations! Your application has been reviewed and approved. You are now an official vendor on the web3cart marketplace.

  rn
rn
• rn

  Your access: You have full access to your vendor dashboard, where you can manage your store profile, add products, view orders, and manage payouts.

  rn
rn
• rn

  Action required: You can now log in and begin setting up your store.

  rn
rn

3. Suspended Vendor

rn
• rn

  What it means: This status indicates that your account access has been temporarily or permanently restricted. This action is typically taken if an account is found to be in violation of our Terms of Service or marketplace policies.

  rn
rn
• rn

  Your access: You will be unable to log in to your vendor dashboard, your products will be hidden from the marketplace, and your selling privileges will be revoked.

  rn
rn
• rn

  Action required: Please check the email associated with your account for a formal notification from our compliance team. This email will contain details about the suspension and any potential steps for resolution or appeal.

  rn
rn

The "Manage Stores" page gives you a top-level view of all storefronts on your web3cart marketplace. From here, you can quickly find, edit, and monitor vendor activity.

This screen is located under Marketplace > Stores.

Navigating the Stores List

rn
• rn

  Show Entries: Use the dropdown menu (defaulting to "10") to change how many stores are displayed per page.

  rn
rn
• rn

  Search: Use the "Search" bar on the right to instantly find a store by its Store Name or Owner.

  rn
rn
• rn

  Pagination: Use the "Previous" and "Next" buttons at the bottom to navigate through multiple pages of stores.

  rn
rn

Understanding the Stores Table

The main table provides key information at a glance:

rn
• rn

  Store Name: The public name of the vendor

This page, located at Marketplace > Vendor Subscription Plans, lists all the subscription tiers available for vendors on your platform. These plans define the costs, features, and commissions associated with selling on web3cart.

Understanding the Plans Table

rn
• rn

  Plan Name: The commercial name of the plan (e.g., "Starter," "Advanced," "Premium").

  rn
rn
• rn

  Price: The cost for a vendor to subscribe to this plan.

  rn
rn
• rn

  Duration (Days): The number of days the subscription is valid before requiring renewal.

  rn
rn
• rn

  Product Allowed: The maximum number of products a vendor can list on this plan ("Unlimited" for no restrictions).

  rn
rn
• rn

  Commission (%): The percentage of each sale that the marketplace takes as a fee. Note that on higher-tier plans, this commission rate typically decreases.

  rn
rn
• rn

  Status: "Active" indicates the plan is available for vendors to subscribe to.

  rn
rn

Important System Constraint: Smart Contract Integration

!! CRITICAL NOTE !!

Due to integration with a smart contract on the blockchain, the core parameters of existing subscription plans (Price, Duration, Commission, etc.) CANNOT BE EDITED OR DELETED after they are deployed.

rn
• rn

  Edit Button: This action is disabled for any plan tied to the smart contract. It cannot be used to change the price or core features of a deployed plan.

  rn
rn
• rn

  Delete Button: This action is disabled for any plan tied to the smart contract. Deleting a plan would disrupt existing subscriptions and financial records.

  rn
rn
• rn

  + Add New Button: This action is disabled for any plan tied to the smart contract.

  rn
rn

Please ensure all plan details are final before adding them to the system.

The Plan Features page (Marketplace > Plan Features) is a library of specific capabilities or "perks" that you can assign to your various subscription plans. This allows you to differentiate your tiers, such as offering "Advanced Analytics" only to your "Pro" subscribers.

Understanding the Features Table

rn
• rn

  ID: A unique system identifier for the feature.

  rn
rn
• rn

  Feature Name (Translated): The human-readable name for the feature (e.g., "AI Support").

  rn
rn
• rn

  Feature Key: The unique, internal system key (e.g., ai_support). This key is used by the system to programmatically check if a vendor has access to a specific function.

  rn
rn
• rn

  Description (Translated): An explanation of what the feature does or allows.

  rn
rn
• rn

  Status: "Active" or "Inactive." Setting a feature to "Inactive" will hide it from the plan configuration screen and disable it for any vendors who previously had it.

  rn
rn

How to Use Plan Features

rn
1. rn

   Create the Feature: Click the "+ Add New" button. Define the Name, Key, and Description.

   rn
rn
2. rn

   Assign the Feature: After creating the features here, you must navigate back to the "Vendor Subscription Plans" "Add New" or "Edit" page. There, you will be able to select which of these features (e.g., advanced_analytics, ai_support) are included in a specific plan.

   rn
rn

This two-step process provides flexibility. You can create a feature once (like "24/7 Support") and assign it to multiple different subscription plans.

The View Completed Subscriptions page (Marketplace > Completed Subscriptions) provides a historical log and financial record of all subscription purchases made by vendors. This is your primary tool for tracking subscription revenue and vendor activation dates.

Understanding the Subscriptions Table

rn
• rn

  Vendor: The name of the vendor (or their store) who purchased the plan.

  rn
rn
• rn

  Plan Name: The specific subscription plan they purchased (e.g., "Starter," "Advanced").

  rn
rn
• rn

  Start Date: The exact date and time the subscription became active.

  rn
rn
• rn

  End Date: The date and time the subscription is set to expire.

  rn
rn
• rn

  Transaction: A unique transaction ID (hash) that serves as proof of payment, often linking directly to a transaction on the blockchain. Clicking this link will typically open a block explorer to verify the transaction details.

  rn
rn
• rn

  Status:

  rn
  rn
  • rn

    Active: The subscription is currently valid and in good standing.

    rn
  rn
  • rn

    Cancelled: The subscription was terminated either by the user or an administrator.

    rn
  rn
  • rn

    (Other statuses like "Expired" may appear here after the End Date has passed).

    rn
  rn
  rn
rn

This page is for viewing and auditing purposes. You cannot edit these records, as they represent a historical log of completed financial transactions.

Welcome to your Vendor Dashboard! This is your central hub for managing every aspect of your store on the web3cart marketplace. From here, you can track your sales, add products, and manage customer interactions.

Main Navigation Menu (Left Side)

Your primary navigation menu on the left side organizes all management tasks into categories:

rn
• rn

  Vendor Dashboard: (This page) Returns you to the main overview screen.

  rn
rn
• rn

  E-commerce: This section contains tools for managing your products and sales.

  rn
rn
• rn

  Products: Add new products, edit existing ones, and manage your inventory.

  rn
rn
• rn

  Sales: View your order history, manage fulfillments, and track revenue.

  rn
rn
• rn

  Customer Support: Manage support tickets submitted by your customers.

  rn
rn
• rn

  Settings: Configure your store profile, payment information, and shipping options.

  rn
rn

Dashboard Statistics (Top Section)

The top of your dashboard features "at-a-glance" statistics to give you a real-time snapshot of your store

The "Coupons" page, located under the E-commerce > Coupons menu, allows you to create and manage promotional discount codes for your customers. Offering coupons is a powerful way to increase sales, reward loyal customers, and attract new buyers.

This main page shows a list of all the coupons you have created.

Understanding the Coupons Table

rn
• rn

  Title: A private name for your reference to help you identify the promotion (e.g., "Winter Sale").

  rn
rn
• rn

  Code: This is the actual code your customers will enter at checkout to receive their discount (e.g., "WINTER25").

  rn
rn
• rn

  Discount: The value of the discount. This can be a percentage (e.g., "10.00%") or a fixed monetary amount.

  rn
rn
• rn

  Status: Shows whether the coupon is currently available for customers to use.

  rn
  rn
  • rn

    Active: The coupon is live and can be applied by customers.

    rn
  rn
  • rn

    Inactive/Expired: The coupon is not available.

    rn
  rn
  rn
rn
• rn

  Expires: The date the coupon code will automatically stop working.

  rn
rn
• rn

  Usage: Shows how many times the coupon has been used out of its total limit (e.g., "0 / ∞" means it has been used 0 times out of an unlimited number of uses).

  rn
rn

Managing Existing Coupons

On the far right of each coupon row, you have two Actions:

rn
1. rn

   Edit (Pencil Icon): Click this to modify the settings of an existing coupon. You can change its title, expiration date, or usage limits. (Note: Some parameters, like the code itself, may not be editable after creation).

   rn
rn
2. rn

   Delete (Trash Icon): Click this to permanently delete the coupon. This action cannot be undone, and the code will no longer be valid for any customers.

   rn
rn

To create a new discount code for your store, follow these steps:

rn
1. rn

   Navigate to the E-commerce > Coupons page from your vendor dashboard.

   rn
rn
2. rn

   Click the "+ Add New Coupon" button located at the top right of the screen.

   rn
rn
3. rn

   This will open a new form where you will define the rules for your coupon.

   rn
rn

Key fields you will likely need to fill out include:

rn
• rn

  Coupon Title: A name for your own records (e.g., "New Customer Offer").

  rn
rn
• rn

  Coupon Code: The code the customer will type in (e.g., "WELCOME10").

  rn
rn
• rn

  Discount Type: Choose between a percentage discount (e.g., 10%) or a fixed amount discount (e.g., $5 off).

  rn
rn
• rn

  Discount Amount: The value of the discount.

  rn
rn
• rn

  Expiration Date: The last day the coupon will be valid.

  rn
rn
• rn

  Usage Limit: You can set a limit on how many times the coupon can be used in total, or per customer.

  rn
rn

After filling in the details, save the coupon. It will then appear in your main "Coupons" list and, if set to "Active," will be ready for customers to use.

The Shipping page, located under the E-commerce > Shipping menu, is where you define the shipping costs for your physical products. You can create multiple shipping methods (e.g., "Standard," "Express") and set different prices for each.

A key feature of the web3cart platform is the ability to set your shipping prices in various cryptocurrencies, which are then presented to the customer during checkout.

Understanding the Shipping Table

rn
• rn

  Title: The public name of your shipping method (e.g., "Flat rate," "Express Shipping").

  rn
rn
• rn

  Defined Prices: This column provides a summary of all the different prices you have set for this shipping method across various cryptocurrencies (e.g., BNB, XPAYR, USDC, USDT). This allows customers to pay for shipping using the coin of their choice.

  rn
rn
• rn

  Default: If "Yes," this shipping method will be automatically selected for customers at checkout. It

You can easily add a new shipping option (like "Express Delivery") and define its costs by following these steps.

Step 1: Create the Shipping Method

rn
1. rn

   Navigate to E-commerce > Shipping.

   rn
rn
2. rn

   Click the "+ Add New Shipping Method" button at the top right.

   rn
rn
3. rn

   A form will appear. At a minimum, you will need to provide:

   rn
   rn
   • rn

     Title: The name of the method (e.g., "International Shipping").

     rn
   rn
   • rn

     Status: Set it to Active to make it available.

     rn
   rn
   rn
rn
4. rn

   Save the new method. It will now appear in your shipping list, but with no prices defined.

   rn
rn

Step 2: Set Prices for the Method

rn
1. rn

   Find your newly created shipping method in the list.

   rn
rn
2. rn

   In its "Actions" column, click the "Set Prices" (Dollar