Quick Reference Fresh
Essential reference tables and quick lookups for Stripe development.
Section overview
| Page | Description |
|---|---|
| Test Cards | Card numbers, PaymentMethods, and tokens for sandbox testing |
| Decline Codes | Card decline codes with descriptions and next steps |
| Currencies | Supported currencies, amount formatting, and minimum charges |
| API Errors | HTTP status codes, error types, and error object attributes |
| API Versioning | How Stripe versions work and how to pin or upgrade |
| Webhooks | Webhook handler setup, signature verification, and best practices |
| Payouts | Payout schedules, bank account setup, and status reference |
Quick lookups
Keys format
| Key | Format | Use |
|---|---|---|
| Publishable key | pk_test_... / pk_live_... | Client-side (safe to expose) |
| Secret key | sk_test_... / sk_live_... | Server-side only (never expose) |
| Webhook secret | whsec_... | Signature verification |
| Restricted key | rk_test_... / rk_live_... | Scoped server-side access |
Common API base URLs
| Resource | URL |
|---|---|
| API | https://api.stripe.com/v1/ |
| Files | https://files.stripe.com/v1/ |
| Stripe.js | https://js.stripe.com/v3/ |
Amount formatting rule
All API amounts are in the smallest currency unit (no decimals):
1099= $10.99 USD500= 500 JPY (zero-decimal)1000= £10.00 GBP
Rate limits
- Default: 100 read requests/second, 100 write requests/second
- Use exponential backoff when you receive
429 Too Many Requests - Do not load test using Stripe's sandbox — rate limits apply there too