Stripe API Test Mode
Payments Dev Free key (no card)
AuthenticationFree key (no card)
Rate limitTest mode is free; requests are rate-limited. See Stripe's published rate-limit docs
Documentation: docs.stripe.com ยท Checked Sep 13, 2026
About
Stripe gives every account a test mode where you can create charges, subscriptions, and payment links using fake card numbers, without moving real money. You can use it to build a checkout page and test success and failure paths, to prototype a subscription billing flow, or to learn how webhooks confirm payments. Testing is completely free; Stripe only charges its transaction fee when you switch to live payments with real cards.
Details
Free to start. You may need a free key, but no credit card.
Auth: Free key (no card)
Rate limit: Test mode is free; requests are rate-limited. See Stripe's published rate-limit docs
Verified: 2026-09-13
Best for: business developer
Setup
- Create a free Stripe account at stripe.com (no card needed for test mode).
- In the dashboard, make sure Test mode is toggled on and copy your test secret key.
- Try the example curl charge with a test token like tok_visa to simulate a Visa payment.
- Use the dashboard's test clock or webhooks view to watch the payment event arrive.
- When ready, complete Stripe's activation to switch the same code to live mode.
Example
curl https://api.stripe.com/v1/charges -u sk_test_YOUR_KEY: -d amount=2000 -d currency=usd -d source=tok_visaUse cases
- Build a checkout page and test card declines safely
- Prototype subscription billing and trial periods
- Learn how payment webhooks confirm successful charges