Stripe Connect

Stripe Connect gives a DevDeck project a platform-managed payment contract. It supports one-time Checkout orders, fixed recurring subscriptions, full or partial refunds, and Stripe Billing Portal sessions. Disputes and evidence management are not included in v1.

DevDeck keeps Stripe credentials and webhook handling on the platform. Generated project code uses the managed payment helper and never receives a Stripe secret key or calls Stripe directly.

Connect Stripe

1. Open the project in DevDeck.
2. Select Configure → Connections.
3. Find Stripe Connect and select Connect.
4. Complete Stripe's account setup and verification.
5. Return to DevDeck and wait until the connection and payment contract both show as ready.

New Stripe connections install the current contract automatically. A project using the older Stripe integration shows an upgrade action first; review and explicitly confirm it before DevDeck updates the managed helpers. Upgrading does not reconnect OAuth, create a payment or refund, or publish the project.

Payments and orders

At checkout, the project backend sends item identifiers and quantities to DevDeck. DevDeck validates the request, recalculates the amount from trusted server data, creates an order in the settlement ledger, and opens a Stripe Checkout Session. Checkout attempts are idempotent and expire after 30 minutes.

If the storefront uses Square, Square remains authoritative for product prices and inventory. DevDeck reloads the Square variations, deducts tracked inventory before opening Stripe Checkout, and compensates it when Checkout creation fails, expires, or an unpaid order is canceled.

Subscriptions

v1 supports fixed recurring prices with day, week, month, or year intervals. Projects can start subscription Checkout, change an active plan with prorations, cancel at period end or immediately, and open the Stripe Billing Portal. Trials, usage billing, schedules, and multi-phase subscriptions are outside v1.

Refunds and Square restocking

Paid orders can receive a full or partial refund. Refund creation is idempotent, and DevDeck updates the final state from Stripe events.

A refund never restocks Square inventory automatically. After a full refund and the physical return of goods, restocking is a separate approval-gated action.

AI Builder operations

AI Builder can read orders, subscriptions, invoices, and refunds. Provider mutations—including unpaid-order cancellation, refunds, subscription changes or cancellation, and Square restocking—always display an approval request. Review the target and amount before approving.