Test Mode
Test your Lemon Squeezy account to ensure everything is working as intended before processing live transactions.
Before you begin processing live transactions, it’s an excellent idea to test your Lemon Squeezy account to ensure everything is working as intended. Lemon Squeezy has a “test mode” that allows you to test almost every aspect of the app without having to use real data.
For example, you can test:
- The entire checkout flow
- Different types of products and discounts
- Subscriptions and license keys
- Webhooks and API integrations
Important
When you first sign up for Lemon Squeezy your store will be in “test mode” by default. Before you can actually sell any products, you will need to activate your store.
Checkout testing
In test mode, you can use dummy customer details and test card numbers to experience the checkout process from a customer’s perspective. To make a test purchase:
Make sure test mode is enabled in the Dashboard
See the screenshot above for the location of the test mode toggle.
Make sure you have a “published” product in test mode
Don’t worry, this won’t be visible to the public, only to you.
”Share” or “Preview” the product
This will generate a test checkout link that you can use to test the checkout process.
Complete the checkout
Do not use real card details for payment testing, as this may be interpreted as fraudulent activity. Instead, use the test credit cards listed below. You’ll need to use the following details:
- A test card number
- A valid future date for expiration (e.g. 12/35)
- Any three-digit CVC (e.g. 123)
- Any value you like for other form fields
Confirm that the order was successful 🥳
You should receive an order receipt email and the order should be visible in your Lemon Squeezy Dashboard.
Order receipt emails in test mode will be sent to you and your team members, regardless of what you enter as the customer email address during checkout. Notifications can be disabled in your Account Settings.
You can also set up test webhooks to test your API integration. Testing subscriptions and license keys is also supported. File downloads are disabled for all test mode purchases.
Test card numbers
Do not use real card details for payment testing, as this may be interpreted as fraudulent activity and may result in your store being suspended. Instead, use the test credit cards listed below.
- Visa:
4242 4242 4242 4242 - Mastercard:
5555 5555 5555 4444 - American Express:
3782 822463 10005 - Insufficient funds:
4000 0000 0000 9995 - Expired card:
4000 0000 0000 0069 - 3D Secure:
4000 0027 6000 3184
See the full list of supported test cards.
Copy to Live mode
Products created in test mode won’t automatically transfer to live mode when your store is activated. However, you can easily copy them, including discounts, to live mode using the “Copy to Live Mode” option in the product or discount menu.
Using the API in test mode
API keys created in test mode will interact with test mode store data only. When you are ready to go live with your integration, make sure to create an API key in live mode and use that in your production application.
You can build and test a full API integration with Lemon Squeezy using test mode.