Wallet & Credit System

What is the Wallet System?

YetiRaffles includes a native wallet/credit system that allows customers to store value on your site and use it for purchases. Credits function as virtual currency that can be earned through prizes and used at checkout.

How Credits Work

Customer Perspective

1. Earn Credits

   Customer wins instant prizes, referral commissions, or admin-added bonuses

2. View Balance

   Credits visible in account dashboard and at checkout

3. Apply at Checkout

   Credits automatically applied or manually selected during checkout

4. Partial or Full Payment

   Credits can cover entire order or reduce the amount owed

5. Transaction History

   Complete history of credits earned and spent

Earning Credits

Customers can earn credits through multiple channels:

Credit Award Process

When credits are awarded:

• Credits added instantly to customer's wallet balance
• Email notification sent (if enabled)
• Transaction recorded with type, amount, and reason
• Balance visible immediately in customer account

Using Credits at Checkout

Automatic vs Manual Application

Configure how credits are applied in YetiRaffles → Settings → Wallet:

Mode	Behavior	Best For
Automatic	Credits always applied to reduce order total	Maximum credit usage, simple UX
Optional	Customer checks box to apply credits	Customer choice, save credits option
Manual Entry	Customer enters amount of credits to use	Precise control, partial credit use

Full vs Partial Coverage

Full Credit Coverage

When credits cover the entire order amount:

• No payment gateway needed
• Order placed using credits only
• Credits deducted from wallet
• Order proceeds as normal
• Zero payment processing fees

Partial Credit Coverage

When credits cover part of the order:

• Order total reduced by credit amount
• Remaining balance paid via payment gateway
• Credits deducted immediately
• Payment processed for remainder
• Both transactions recorded

Customer Wallet Dashboard

Customers access their wallet from My Account → Wallet

Wallet Dashboard Features

• Current Balance: Total credits available
• Pending Credits: Credits awaiting order completion
• Transaction History: Complete record of all credit activity
• Credits Earned: Total credits earned all-time
• Credits Spent: Total credits used all-time
• Recent Activity: Latest transactions with dates and descriptions

Transaction History Details

Each transaction shows:

Column	Information
Date	When the transaction occurred
Type	Credit or Debit
Amount	Value added or removed
Description	Reason for transaction (e.g., "Instant Win Prize")
Balance	Balance after this transaction
Reference	Related order number or admin user

Credit Expiration

Optionally set credits to expire after a certain period to encourage usage.

Expiration Settings

• No Expiration: Credits never expire (default)
• Fixed Period: Credits expire X days after being earned
• End of Period: Credits expire at end of month/quarter/year
• Inactivity Based: Expire after X days of account inactivity

Expiration Notifications

When credits are approaching expiration:

• Email reminder sent 7 days before expiration
• Dashboard warning displayed
• Email notification when credits expire
• Expired credits moved to separate history log

Credit Restrictions

Configure restrictions on credit usage to protect your business:

Product Restrictions

• Exclude Specific Products: Certain products cannot be purchased with credits
• Exclude Categories: Block entire categories from credit payment
• Minimum Cash Payment: Require at least X% to be paid in cash
• New Customers Only: Restrict which products new customers can buy with credits

Usage Limits

• Maximum Per Order: Limit credit amount per single order
• Maximum Per Day: Limit total credits used per day
• Percentage Cap: Credits can only cover X% of order (e.g., 80%)
• Minimum Order Value: Order must be at least X to use credits

Credit Value & Currency

Credit-to-Currency Ratio

By default, 1 credit = 1 unit of your store currency (e.g., £1 = 1 credit). You can configure different ratios if needed:

• 1:1 Ratio: Simplest, easiest for customers to understand
• Points System: 100 points = £1, allows for smaller rewards
• Custom Ratio: Any ratio that fits your business model

Multi-Currency Support

If using a multi-currency plugin:

• Credits stored in base currency
• Converted to customer's selected currency at checkout
• Exchange rate applied automatically
• Transaction history shows both currencies

Tax & Credits

Understanding tax implications of credit payments:

Tax on Credit Purchases

• Full Credit Payment: Tax still calculated on original order value
• Partial Credit: Tax applied to full order, then credits deducted
• Tax Included Credits: Option to make credits inclusive of tax

Accounting for Credits

From an accounting perspective:

• Credits are liabilities (you owe value to customers)
• When earned: Liability increases, expense recorded
• When used: Liability decreases, revenue recognized
• Expired credits: Liability removed, income recognized

Security & Fraud Prevention

Built-in Security Features

• Database Security: Credits stored securely with encryption
• Transaction Logging: Complete audit trail of all credit activity
• Admin Restrictions: Only authorized users can modify credits
• Balance Verification: System validates balance before allowing transactions
• Rate Limiting: Prevents automated credit farming

Fraud Prevention Best Practices

1. Monitor Large Balances: Flag accounts with unusually high credits
2. Velocity Checks: Alert on rapid credit accumulation
3. Transaction Patterns: Identify suspicious activity patterns
4. Minimum Account Age: Require account age before credit use
5. Verification for Large Orders: Verify identity for high-value credit orders

What to Monitor

Red Flag	Action
Multiple accounts with same details	Investigate for multi-accounting
Rapid credit accumulation then spending	Check for exploit or abuse
Credits transferred between accounts	Verify both accounts are legitimate
Chargebacks after earning credits	Deduct credits, ban if fraudulent

Integration with WooCommerce

Cart & Checkout Integration

Credits integrate seamlessly with WooCommerce:

• Cart Display: Available credits shown in cart
• Apply Credits: Button/checkbox to apply credits
• Order Total Update: Total recalculated when credits applied
• Payment Gateway: Skipped if credits cover full amount
• Order Notes: Credit usage recorded in order notes

Order Management

In WooCommerce order admin:

• View credit amount used in order meta
• Refunds can be issued as credits
• Credit transactions linked to order ID
• Partial refunds supported (credit portion)

Reporting Integration

Credit data in WooCommerce reports:

• Revenue reports show cash vs credit split
• Outstanding credit liability shown
• Credit usage trends over time
• Top customers by credit earned/spent

Advanced Features

Credit Gifting

Allow customers to gift credits to other users:

• Transfer credits to another account
• Minimum transfer amount
• Maximum transfers per day
• Fee for transfers (optional)
• Email notification to recipient

Credit Purchase Option

Let customers buy credits directly:

• Create "credit bundle" products
• Offer bonus credits on larger purchases
• Example: Buy £50 credits for £45
• Encourage pre-loading wallet

Tiered Credit Bonuses

Reward high-value customers with bonus credits:

• Bronze Tier: 5% bonus on all credit earnings
• Silver Tier: 10% bonus on all credit earnings
• Gold Tier: 15% bonus + exclusive credit offers

Need Help?

If you have questions about the wallet system, check out our Troubleshooting Guide or FAQ.

Next: Learn about Managing User Credits