How isolation works
Sandbox and production use separate data and credentials.
This separation prevents development activity from changing live customer or billing data. Before launch, configure the resources your integration needs in production and replace all sandbox credentials and URLs.
Get started
- Sign in to the Kelviq dashboard.
- Click Sandbox in the Sandbox | Live switch at the top of the sidebar. A yellow Sandbox mode strip runs across the top of the dashboard while you’re in it. Click Live to go back.
- Create the products, plans, prices, and other test data you need.
- Open Settings → API keys and copy the sandbox key required by your integration.

Connect to the sandbox API
Use the sandbox hosts with sandbox-scoped credentials:
For example:
Use the sandbox with an SDK
Setenvironment to sandbox when initializing an official SDK.
Test checkout
Create a checkout in the sandbox and pay with a test card. Use any future expiration date and any CVC.
For every other outcome, including specific decline reasons, disputes, refunds, wallets, SEPA Direct Debit and UPI, see Test payments.
After payment, confirm that the test order, customer, subscription, and entitlements have the expected state in Sandbox mode.
Test a subscription renewal
To test renewals faster, ask Kelviq support to turn on Daily billing for your sandbox.
- Enter Sandbox mode in the Kelviq dashboard.
- Open the test plan you want to use.
- Under Billing cycle, select Daily and enter a test price.
- Publish the plan.
- Start a subscription with a sandbox test card.
- After the next billing cycle, check the order, invoice, subscription status, and entitlements in Sandbox mode.
chargePeriod to DAILY:
Can I test production with my own card?
Test in Sandbox or with a 100% discount code. A payment provider can flag your card if you pay yourself, even for a small amount. Here’s how:- Keep payment and renewal testing in Sandbox.
- If you need to inspect the production checkout, create a 100% discount code so no real payment is collected.
- Check production credentials, URLs, and environment settings without completing a purchase.
Prepare for production
Before accepting live payments:- Complete the required business review and payout setup.
- Configure and publish your production products and plans.
- Replace sandbox API keys with production API keys.
- Replace sandbox base URLs or set each SDK’s environment to
production. - Run a final check that no sandbox credentials or hosts remain in your production configuration.