Price Tier Credits Configuration

The Price Tier Credits Configuration system allows administrators to set up credit bonuses that are automatically granted to users when they purchase different product tiers and pricing plans.

Overview

The price tier credits system provides:

• Product Configuration: Set up credit bonuses for different products
• Automatic Granting: Credits automatically granted on purchase
• Validity Management: Configure credit expiration periods
• Tier Management: Manage different pricing tiers and plans
• Status Control: Enable/disable credit configurations
• Product Integration: Seamless integration with payment system

Features

Product Configuration

Product Setup

• Product ID: Unique identifier for each product
• Product Name: Display name for the product
• Credits Amount: Number of credits to grant
• Valid Months: Credit expiration period
• Status: Enable/disable configuration

Predefined Products

The system includes predefined product options:

• Starter套餐: Starter package
• Standard套餐: Standard package
• Premium套餐: Premium package
• Monthly Plans: Starter/Standard/Premium monthly
• Yearly Plans: Starter/Standard/Premium yearly

Credit Management

Automatic Granting

• Purchase Trigger: Credits granted on successful payment
• Immediate Effect: Credits available immediately after purchase
• Expiration Tracking: Credits expire after specified months
• User Notification: Users notified of credit grants

Credit Configuration

• Amount Setting: Configure credit amounts per product
• Validity Period: Set credit expiration (in months)
• Status Control: Enable/disable credit granting
• Product Mapping: Link credits to specific products

System Integration

Payment Integration

• Stripe Integration: Works with Stripe payment processing
• Order Processing: Credits granted during order completion
• Payment Verification: Only granted on successful payments
• Refund Handling: Credits adjusted on refunds

User Experience

• Immediate Access: Credits available after purchase
• Clear Communication: Users see credit grants
• Expiration Warnings: Users notified of expiring credits
• Usage Tracking: Monitor credit usage patterns

Usage

Setting Up Credit Configurations

1. Navigate to Admin System → Price Tier Credits
2. Click Add Tier button
3. Configure the credit settings:
   • Select product from dropdown
   • Set credits amount
   • Configure validity period
   • Enable the configuration
4. Click Create to save

Managing Existing Configurations

1. View Configurations: Review all credit configurations
2. Edit Settings: Modify credit amounts or validity
3. Enable/Disable: Control which configurations are active
4. Delete Configurations: Remove outdated configurations

Product Integration

Payment System Setup

1. Product IDs: Ensure product IDs match payment system
2. Credit Rules: Coordinate with credit rules system
3. User Experience: Test credit granting flow
4. Monitoring: Track credit grant success rates

User Communication

1. Purchase Flow: Inform users about credit grants
2. Credit Display: Show credits in user dashboard
3. Expiration Notices: Warn users about expiring credits
4. Usage Guidance: Help users understand credit usage

File Locations

• Admin Interface: src/app/[locale]/(admin)/admin/price-tier-credits/page.tsx
• API Routes: src/app/api/admin/price-tier-credits/
• Types: src/types/credit-config.ts
• Models: src/models/price-tier-credit.ts

Common Tasks

Initial Setup

1. Configure credit amounts for all products
2. Set appropriate validity periods
3. Enable all configurations
4. Test with sample purchases

Daily Management

1. Monitor credit grant success rates
2. Check for failed credit grants
3. Review user credit balances
4. Address credit-related issues

Weekly Analysis

1. Analyze credit usage patterns
2. Review product performance
3. Adjust credit amounts if needed
4. Monitor expiration rates

Monthly Review

1. Review credit configuration effectiveness
2. Analyze user satisfaction
3. Plan credit amount adjustments
4. Update product configurations

Troubleshooting

Credits Not Granted

• Configuration Status: Check if configuration is enabled
• Product ID Match: Verify product ID matches payment system
• Payment Processing: Confirm payment was successful
• Credit Rules: Check credit rules system integration

Wrong Credit Amounts

• Configuration Check: Verify credit amount settings
• Product Mapping: Confirm correct product configuration
• Payment Integration: Check payment system integration
• User Feedback: Monitor user reports

Expiration Issues

• Validity Period: Check validity month settings
• Expiration Logic: Verify expiration calculation
• User Notifications: Ensure users are notified
• System Monitoring: Monitor expiration processes

Performance Problems

• Database Optimization: Index price tier credit tables
• API Performance: Optimize credit grant APIs
• Caching: Implement caching for configurations
• Monitoring: Track system performance metrics