Skip to content
VivrealHelp
Open Vivreal

Set Up Stripe Payments

Connect Stripe, sync products, and enable payments on your Vivreal-powered site

intermediate20 min readUpdated

Set Up Stripe Payments

This walks you through connecting Stripe, bringing your products across, and getting a shop online that takes real payments.

Prerequisites

  • A Vivreal account with an active group on any tier (Stripe is not gated to paid tiers)
  • A Stripe account with at least one product created
  • Familiarity with the Vivreal portal (see Build a Product Catalog first)

Aggregate integration cap by tier

There is no Stripe-specific tier gate. Vivreal instead caps the total number of integrations a group can install: Free = 3, Basic = 5, Pro / Pro Plus / Enterprise = unlimited. Stripe counts against that aggregate cap.

Navigate to Integrations

Tap Channels in the bottom navigation bar. You will see a grid of available integrations. Find the Stripe card and click Connect.

Enter your Stripe key

In the Stripe Dashboard, go to Developers, then API keys, and click Create restricted key. Give it write access to Products, Prices, Checkout Sessions, Coupons, Promotion codes, Webhook endpoints and Payouts, plus read access to Balance. Leave the rest set to None.

Copy the key (it starts with rk_) and paste it into the configuration dialog. Vivreal encrypts it before storing it.

Click Save to activate the integration.

Do not paste your account Secret key here. Stripe asks outside tools to use a restricted key, and charges accounts that keep sharing the full one. The full walkthrough is in Selling online.

Use a test mode key while setting things up. Switch to the live one only when you are ready to accept real payments.

Create products in Stripe

If you have not already, go to Products in your Stripe Dashboard and create a few products with prices. Each product should have a name, description, and at least one price.

Sync products to Vivreal

Back in the Vivreal portal, open the Stripe channel and go to the Settings tab. Tap Sync from Stripe. Your products and their prices come across.

Switch to the Products tab to see them.

You do not need to build a products list yourself

Your products arrive from Stripe already. Making a second "Products" content type by hand would leave you with two lists to keep in step, and only the Stripe one can actually be bought from. See Build a product catalog for when a hand-built catalogue is the right choice.

Give the products a home on your site

Your shop lives on a site. If you do not have one yet, go to Sites and create one; see Creating a site.

When your site has a page showing your products, visitors get product pages with an Add to Cart button, a cart, and checkout, all backed by the products you just synced. You can see and arrange your pages in Studio.

Once the site is live, visit it and try buying something with a Stripe test card.

You can re-sync products at any time. New products in Stripe will be added, and existing ones will be updated. Deleted products in Stripe are not automatically removed from Vivreal, delete them manually if needed.

How It Works

Your site looks up the Stripe key on Vivreal's servers, from your business's settings. The key is never exposed to the browser. When someone buys, they pay on Stripe's own secure payment page, and the order lands back in your portal.

Next Steps

  • Make the site your own in Studio: colours, wording, photos and pages
  • Run a sale or a discount code from the Stripe channel's Sales & Coupons tab
  • Turn on overage billing in your group settings if you expect a lot of traffic
  • If you have a developer, they can have Vivreal notify their own software when an order arrives. See Automate with webhooks