Skip to main content

​
Overview

The wallet system provides a convenient way to store funds in your account for quick and easy purchases. This guide covers adding funds, using wallet balance, and managing wallet transactions.
Wallet functionality must be enabled by the platform administrator. If you don’t see wallet options, contact support.

​
Wallet Benefits

​
Why Use a Wallet?

  • Faster Checkout: Pay instantly without entering payment details each time
  • Secure Storage: Safely store funds in your account
  • Easy Refunds: Refunded amounts go directly to wallet
  • No Transaction Fees: Many platforms don’t charge fees for wallet payments
  • Budget Management: Preload funds to control spending
  • Instant Payments: No payment gateway delays

​
Accessing Your Wallet

Route: /wallet
1

Login to Your Account

Access your customer dashboard
2

Navigate to Wallet

Click “Wallet” or “My Wallet” in the menuScreenshot Description: Customer dashboard menu with Wallet option highlighted
3

View Wallet Balance

See your current wallet balance and transaction history

​
Wallet Balance

Your wallet displays:
  • Current Balance: Available funds
  • Transaction History: All deposits and withdrawals
  • Pending Transactions: Awaiting confirmation
  • Recharge Options: Methods to add funds

​
Adding Funds to Wallet

​
Online Recharge

Route: POST /wallet/recharge
1

Click Recharge Wallet

From your wallet page, click “Recharge” or “Add Funds”
2

Enter Amount

Specify how much you want to add
3

Select Payment Method

Choose from available payment options:
  • Credit/Debit Card
  • PayPal
  • Bank Transfer
  • Other configured payment gateways
Screenshot Description: Wallet recharge page showing amount input and payment method options
4

Process Payment

Complete payment through the selected gateway
5

Confirmation

After successful payment:
  • Funds are added to your wallet immediately
  • Your balance updates
  • You receive a confirmation message: “Recharge completed”
  • Email receipt is sent

​
Offline Recharge

If offline payment methods are available: Route: POST /wallet/offline_recharge
1

Select Offline Payment

Choose offline payment method (bank transfer, etc.)
2

Complete Bank Transfer

Transfer funds to the provided bank account
3

Upload Receipt

  • Upload payment receipt/proof
  • Enter transaction ID
  • Specify amount
4

Submit for Approval

Your request is submitted with status: Pending approval (approval = 0)
5

Wait for Verification

  • Admin reviews your submission
  • You receive notification when approved
  • Funds are added upon approval
Offline recharges require admin approval and may take 1-3 business days to process.

​
Using Wallet Balance

​
During Checkout

1

Proceed to Checkout

Add items to cart and go to checkout
2

Select Wallet Payment

Choose “Wallet” as payment method
3

Verify Sufficient Balance

Ensure wallet balance covers order total
4

Complete Purchase

  • Wallet balance is deducted
  • Order is placed immediately
  • No additional payment processing needed

​
Partial Wallet Payment

If wallet balance is insufficient:
1

Use Available Balance

Apply wallet balance to reduce order total
2

Pay Remaining Amount

Choose another payment method for the difference
3

Complete Purchase

Order is processed using combined payments
Always maintain some wallet balance for:
  • Quick purchases
  • Flash sales
  • Emergency orders
  • Taking advantage of limited-time deals

​
Wallet Transaction History

Route: /wallet View all wallet activity:

​
Transaction Types

​
Deposits (Credits)

  • Online recharges
  • Offline recharges (after approval)
  • Refunds from cancelled orders
  • Promotional credits
  • Cashback rewards

​
Withdrawals (Debits)

  • Order payments
  • Subscription fees
  • Service charges

​
Transaction Details

Each transaction shows:
  • Date & Time: When transaction occurred
  • Type: Credit or Debit
  • Amount: Transaction value
  • Payment Method: How funds were added
  • Payment Details: Transaction ID or reference
  • Approval Status: For offline recharges
  • Running Balance: Balance after transaction

​
Viewing Transaction History

1

Access Wallet Page

Navigate to your wallet
2

Scroll to Transaction History

View paginated list of all transactions (10 per page)
3

Filter Transactions

Sort by:
  • Date range
  • Transaction type
  • Status
4

Download Records

Export transaction history for your records

​
Refunds to Wallet

When orders are cancelled or refunded:

​
Automatic Wallet Refunds

1

Order Cancellation

When seller cancels an order paid via wallet
2

Automatic Refund

System automatically:
  • Credits order amount back to wallet
  • Updates your balance
  • Creates refund transaction record
3

Notification

You receive notification of the refund
4

Immediate Availability

Refunded amount is immediately available for use
Wallet refunds are instant. Refunds to credit cards or other payment methods may take 3-7 business days.

​
Offline Payment Approval

For admin-approved offline recharges:

​
Approval Process

  1. Submission: You submit offline recharge request with receipt
  2. Admin Review: Platform admin reviews your submission
  3. Approval Decision:
    • Approved (approval = 1): Funds added to wallet balance
    • Rejected (approval = 0 or -1): Funds deducted if previously added
  4. Notification: You receive approval/rejection notification

​
Checking Approval Status

1

View Transaction History

Go to wallet transaction history
2

Check Offline Transactions

Look for transactions marked as “Offline Payment”
3

Review Status

Status shows:
  • Pending approval
  • Approved
  • Rejected

​
Wallet Security

​
Best Practices

  1. Monitor Regularly: Check wallet transactions frequently
  2. Report Unauthorized Activity: Contact support immediately if you see suspicious transactions
  3. Secure Your Account: Use strong passwords and enable two-factor authentication
  4. Don’t Share Access: Never share your login credentials
  5. Verify Before Payment: Double-check amounts before completing wallet payments
  6. Keep Records: Save receipts and confirmation emails

​
Transaction Disputes

If you notice incorrect transactions:
1

Document the Issue

  • Screenshot of transaction
  • Date and amount
  • Expected vs actual balance
2

Contact Support

Submit a support ticket with details
3

Provide Evidence

Include all relevant documentation
4

Wait for Resolution

Support team investigates and resolves the issue

​
Wallet Management Tips

​
Budget Control

  1. Set Recharge Limits: Only add what you plan to spend
  2. Monthly Budgets: Recharge a fixed amount monthly
  3. Track Spending: Review transaction history regularly
  4. Avoid Overloading: Don’t keep excessive amounts in wallet

​
Maximizing Benefits

  1. Take Advantage of Promotions: Watch for bonus credit offers
  2. Use for Flash Sales: Quick payment for limited-time deals
  3. Combine with Coupons: Stack wallet payment with discount codes
  4. Refund Preference: Request refunds to wallet for faster processing

​
Common Scenarios

​
Scenario 1: First-Time Recharge

1

Decide Amount

Choose an amount based on typical purchases
2

Select Secure Payment Method

Use a trusted payment gateway
3

Complete Small Test

Start with a smaller amount to test the process
4

Verify Credit

Confirm funds appear in your wallet
5

Make Purchase

Use wallet for your next order

​
Scenario 2: Insufficient Balance

1

Check Balance

View current wallet balance during checkout
2

Quick Recharge

Add funds to cover the shortfall
3

Complete Purchase

Return to checkout and pay with wallet

​
Scenario 3: Refund Processing

1

Order Cancelled

Seller cancels your wallet-paid order
2

Automatic Refund

Amount credited back to wallet instantly
3

Verify Refund

Check transaction history for refund entry
4

Use Refunded Amount

Balance is immediately available for new purchases

​
Troubleshooting

Q: Wallet payment failed at checkout
A:
  • Verify sufficient balance
  • Check if wallet system is enabled
  • Try logging out and back in
  • Contact support if issue persists
Q: Recharge amount not reflecting in balance
A:
  • Check transaction history for status
  • For online recharges, verify payment was successful
  • For offline recharges, wait for admin approval
  • Contact support with transaction reference
Q: Can’t find wallet option
A:
  • Wallet system may not be enabled
  • Check if you’re logged in
  • Contact admin to enable wallet functionality
Q: Offline recharge still pending
A:
  • Admin approval can take 1-3 business days
  • Ensure you uploaded valid receipt
  • Check if business hours affect processing
  • Contact support for status update
Q: Wrong amount refunded
A:
  • Check if partial refund was issued
  • Review order details for amounts
  • Contact support with order and transaction numbers

Build docs developers (and LLMs) love

Get started for freeTalk to us