Connect a payment provider for Shop and billing

Two different payment flows

There are two places money moves in StretchSuite, and it helps to keep them separate:

1. Platform billing — what you pay StretchSuite for your subscription, app bundles, and metered usage. This runs through Stripe Checkout, and your entitlements update automatically after payment.
2. Store payments (StretchShop) — what your customers pay you when they buy from your storefront. This is processed through StretchShop's checkout via the workspace gateway.

This article covers enabling payments for both, and how confirmations flow back into your workspace.

Platform billing (your StretchSuite subscription)

1. Open Billing in your workspace.
2. Choose the plan, app bundle, or add-on you want (individual apps, bundles, pick-5, or monthly/annual).
3. Click to checkout — you're taken to Stripe Checkout, a secure hosted payment page.
4. Enter payment details and complete the purchase.
5. You're returned to Billing. A confirmation notice appears, and your workspace entitlements refresh after the Stripe webhook syncs — meaning newly purchased apps become active shortly after payment, automatically.

Because billing uses Stripe's hosted checkout, StretchSuite never handles your raw card details, and your access updates without anyone manually flipping a switch.

Store payments (StretchShop)

StretchShop is a storefront with product browsing, a cart, add-to-cart, and checkout. To take real payments from customers, you enable payments in the store's settings so that checkout can capture and process orders.

1. Open StretchShop and go to the store's settings/payments area.
2. Enable a payment method / provider so checkout can process real transactions (test mode is available for verifying the flow before going live).
3. Configure your store's currency, taxes, and shipping as needed (StretchShop defaults to CAD but supports the currency you set).
4. Place a test order end-to-end: browse a product, add to cart, and complete checkout.
5. Confirm the order appears under the Orders tab and that the customer record is captured under Customers.

A realistic example

A coaching business sells a downloadable workbook and a paid membership:

1. First, they buy the StretchShop app in Billing via Stripe Checkout; minutes later Shop shows as active in My Apps because entitlements synced via webhook.
2. In StretchShop, they add two products (the workbook and the membership), set prices in CAD, and enable payments.
3. They place a test purchase of the workbook and see it land under Orders with the buyer under Customers.
4. They go live. When a real customer checks out, the order and revenue show up in the Shop overview metrics (Products, Collections, Orders, Revenue).

How confirmations sync (webhooks)

Payments rely on webhooks — the payment processor calling StretchSuite the instant something happens (a successful charge, a cancellation, a refund). That's how:

• A completed billing checkout flips your entitlements on without you refreshing.
• A completed store checkout creates the order record.

You don't configure these webhooks yourself for the managed flows — they're wired up as part of the platform. See Webhooks and real-time sync for how this works and what to check if a confirmation is slow.

Troubleshooting

"Checkout completed" but my new app isn't active yet — entitlements refresh after the Stripe webhook syncs, which is usually seconds but can lag briefly. Refresh Billing/My Apps after a moment. If it stays inactive for long, contact support with your checkout confirmation.

Checkout was cancelled — your existing access is unchanged; nothing was charged. Start again when ready.

A store order didn't record — confirm the checkout actually completed (customers sometimes abandon at the payment step). Check the Orders tab and test with a test-mode transaction to isolate whether it's the payment step or the order-recording step.

Currency looks wrong — set your store currency explicitly in Shop settings; the default is CAD.

Tips

• Always run a test transaction before going live with a real store, so you see the full path from cart to Orders.
• Keep your billing email current so payment receipts and any failed-payment notices reach you — a failed subscription payment can gate app access.
• Don't share your Stripe/billing login; manage who can purchase through workspace roles instead.

FAQ

Does StretchSuite see my card number? No. Platform billing uses Stripe's hosted checkout; card data goes to Stripe, not into StretchSuite.

Can I sell in multiple currencies? Set your store currency in Shop; contact support for multi-currency needs.

Why did my access get gated after a payment issue? Entitlements track your subscription state. A failed or reversed payment can pause access until billing is resolved.