Stripe
All payment methods activated on your Stripe account at checkout — cards, Klarna, PayPal, and more.
Setup
You need a Stripe account. Find your credentials in the Stripe dashboard under Developers → API keys.
If you have multiple checkouts, we recommend creating a separate Stripe account for each checkout. Stripe lets you group accounts under a single organization so you can manage them all from one dashboard. Separate accounts let you configure payment methods independently per checkout and ensure webhooks work optimally.
| Asetus | Kuvaus |
|---|---|
| Publishable key | Stripe's public key. Starts with pk_live_ or pk_test_. |
| Secret key | Stripe's secret key. Starts with sk_live_ or sk_test_. |
| Enable payment method | Activates the Stripe integration at checkout. |
| Add payment webhook to Stripe (recommended) | Automatically adds a webhook to your Stripe account that handles payment success and failure events. |
pk_test_ and sk_test_ keys are for testing only. Remember to switch to pk_live_ and sk_live_ keys before taking your checkout into production.
Stripe requires a minimum order total — for example, at least 0.50 € in EUR. If a discount code or other reduction brings the total below the minimum, payment will fail.
Payment Methods
Verkkokurssikassa uses Stripe Payment Element, which automatically shows all payment methods activated on your Stripe account — for example cards, Klarna, PayPal, and others. The methods shown are filtered automatically based on currency, the customer's location, and the payment amount. See supported payment methods in Stripe's documentation.
Activate the payment methods you want in the Stripe dashboard and follow each method's own setup instructions. Some methods require additional configuration — for example, registering a domain in the payment method settings before it appears at checkout.
Stripe automatically determines which payment methods to display based on the customer's location, currency, and payment amount — you do not choose which methods appear at checkout yourself. If you want to test what the checkout looks like in a specific country, use a VPN and select that country.
Webhook
The Stripe integration requires a webhook for payment confirmation to work reliably. Verkkokurssikassa can add the webhook to your Stripe account automatically — check this option in the payment settings.
The webhook listens for payment_intent.succeeded and payment_intent.payment_failed events, which call the Verkkokurssikassa API to confirm or record the payment result. Without the webhook, payment confirmation may be delayed or fail.