Storefront
Test Mode
Test your store's checkout flow without real payments.
Test mode lets you try your entire checkout process without processing real payments or spending money.
What is Test Mode?
When enabled, test mode:
- Skips actual PayPal payment processing
- Lets you simulate successful, failed, and pending payments
- Creates real orders in your dashboard
- Tests your delivery system
Enabling Test Mode
- Go to Settings > General
- Toggle Test Mode on
- Your store now accepts test orders
Remember to disable test mode before going live! Customers won't be charged while it's enabled.
Using Test Mode
Making a Test Purchase
- Visit your store
- Add items to cart
- Proceed to checkout
- Enter test customer details
- Choose a test scenario
Test Scenarios
At checkout, you can simulate different outcomes:
Success
- Payment succeeds
- Order marked as completed
- Items delivered to player
- Use this to test the happy path
Failed
- Payment fails
- Order stays pending
- Use this to test error handling
Pending
- Payment is pending
- Order awaits confirmation
- Use this to test pending states
What to Test
Before Launch Checklist
- Products display correctly
- Prices are accurate
- Categories work as expected
- Exclusive items replace correctly
- Cart totals calculate properly
- Checkout flow is smooth
- Order appears in dashboard
- Items deliver to test player
Testing Delivery
To test item delivery:
- Have your HytalePay plugin installed
- Use a real player username
- Complete a test purchase
- Verify items are received in-game
Test Mode Indicators
When test mode is active:
- Dashboard shows a test mode banner
- Orders are marked as test orders
- No real payments are processed
Disabling Test Mode
When you're ready to go live:
- Go to Settings > General
- Toggle Test Mode off
- Verify PayPal is connected
- Your store now processes real payments
Best Practices
- Test everything: Go through the entire flow as a customer
- Test edge cases: Empty cart, max quantities, exclusive items
- Test on mobile: Many customers shop on phones
- Test delivery: Make sure items actually arrive in-game
- Document issues: Fix any problems before going live