Stripe Payments

​

How it works

​

Prerequisites

• A Crave account with at least one location
• A bank account for payouts
• Government-issued ID for verification (Stripe requirement)

​

Complete Stripe onboarding

1. In the Dashboard, go to Settings > Payments
2. Click Complete Stripe Setup
3. Stripe’s embedded onboarding form collects:
   • Business type (individual, company, non-profit)
   • Business address and phone
   • Bank account or debit card for payouts
   • Identity verification (SSN or ID upload)
   • Tax information (EIN or SSN)
4. Once submitted, Stripe verifies your information (usually instant, sometimes 1-2 business days)

​

Storefront integration

​

Environment setup

NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_live_your_key

​

Payment flow

import { loadStripe } from "@stripe/stripe-js";
import { Elements } from "@stripe/react-stripe-js";

// 1. Create a capability-protected payment session via Crave
const payment = await storefront.checkout.createPaymentSession(
  locationId,
  cartId,
);

if (payment.provider !== "STRIPE") throw new Error("Square owns this checkout");

// 2. Initialize Stripe only for a Stripe session
const stripePromise = loadStripe(
  process.env.NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY!,
);

// 3. Wrap checkout UI with Elements provider
<Elements
  stripe={stripePromise}
  options={{ clientSecret: payment.clientSecret }}
>
  <PaymentForm />
</Elements>;

​

Testing

​

Troubleshooting

​

”Stripe onboarding incomplete”

• Return to Settings > Payments and click Complete Stripe Setup
• Stripe may need additional documents for verification
• Check your email for messages from Stripe

​

Payments failing in production

• Verify you’re using the live publishable key (pk_live_...), not the test key
• Ensure the restaurant’s Stripe Connect account is fully verified
• Check the Stripe Dashboard for declined payment details