secretKey | Yes | Your Stripe secret key (sk_live_... / sk_test_...). Never expose this in the browser. |
mode | Yes | 'api', 'elements', or 'both'. See Choosing a mode. |
publishableKey | Only for elements/both | Your Stripe publishable key. Not used server-side, but returned via kit.toClientConfig() so your frontend can fetch it from your own backend instead of hardcoding it. |
webhookSecret | Only if using kit.webhooks | Your endpoint's signing secret from the Stripe Dashboard. |
timezone | No, defaults to "UTC" | Any IANA timezone, e.g. "Europe/Amsterdam", "America/New_York". See Timezones. |
currency | No, defaults to "usd" | Default 3-letter ISO currency for calls that don't specify one. |
successUrl / cancelUrl | No | Default redirect URLs used by hosted Checkout Sessions when not passed per call. |
storage | No | A StorageAdapter implementation. See Storage adapter. |
apiVersion | No | Pins a specific Stripe API version for the underlying stripe client. |
appInfo | No | Passed through to the underlying Stripe client for Stripe's App Info reporting. |
debug | No | Enables additional internal logging. |
maxNetworkRetries | No, defaults to 2 | Number of automatic retries for failed network requests to Stripe. |
timeout | No | Request timeout in milliseconds for calls to Stripe. |
