Set up Stripe payments

Stripe is the recommended way to accept card payments on Saleporia. This guide shows you how to get your Stripe keys and connect them in minutes.

1. Create a Stripe account

If you don't have one, sign up at stripe.com. Complete your account verification (business details and bank account) so you can receive payouts. This usually takes a day or two.

2. Get your API keys

1. 1

   Open the Stripe Dashboard

   Go to Developers → API keys.
2. 2

   Copy the Publishable key

   It starts with pk_ (e.g. pk_live_... or pk_test_... for test mode).
3. 3

   Reveal and copy the Secret key

   It starts with sk_ (e.g. sk_live_... or sk_test_...). Keep this secret — never commit it to code.

3. Connect Stripe in Saleporia

1. 1

   Open Settings → Payments

   In the Saleporia admin, go to Settings and select the Payments tab.
2. 2

   Enable Stripe

   Toggle enableStripe on.
3. 3

   Paste your keys

   Enter the publishable and secret keys you copied from Stripe.
4. 4

   Save

   Click Save changes. The secret key is masked after saving — you won't see it again in the admin.

4. Place a test order

Visit your storefront, add a product to the cart, and check out. In Stripe test mode, use card number 4242 4242 4242 4242 with any future expiry and any CVC. The order should appear in your Orders list with a Succeeded payment status.

5. Go live

Once you've confirmed test orders work, swap your test keys for live keys in Settings → Payments and save. You're now accepting real payments.