Instance · Integrations
Stripe Overview
Last updated 1 November 2026
Connect your Stripe account to take payments, with test and live keys stored in the admin.
Stripe takes card payments, subscriptions and refunds. Insites connects to your Stripe account so your site can take payments without building a payment system. You store your Stripe keys in the admin, and your site and the Ecommerce module use them to talk to Stripe.
Connect Stripe
In the admin, open Integrations and choose Stripe. Enter your Stripe details:
| Setting | Meaning |
|---|---|
| Account ID | Your Stripe account |
| Publishable and secret test keys | For testing, with no real money |
| Publishable and secret live keys | For real payments |
| Live mode | Whether to use the live keys |
Warning
Keep the secret keys secret. Never put a secret key in a page, a script or the browser; only server-side code should use it.
How payments are taken
Insites is the backend. The Ecommerce module holds carts, orders and payment records, but does not ship a storefront: each project builds its own checkout. A common way is a Stripe Checkout Session. A page creates it with an API call to Stripe and your secret key, and the customer goes to Stripe to pay.
A payment record on an order notes a payment. It does not charge the card; Stripe does.
Test before you go live
Use the test keys with live mode off on staging. Stripe's test cards take payments that move no real money. Switch to the live keys only on production.
Note
Settings from the Ecommerce module configuration reference; the payment flow from the Logic Engine payments reference. Nothing was connected for this page.
Common mistakes
- Turning live mode on in staging. Real cards are then charged.
- Recording a payment on an order and treating the order as paid. Check the payment in Stripe.
- Pasting a live secret key into a chat or a ticket. Roll the key in Stripe if that happens.