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 payment intent via Crave API
const payment = await storefront.payments.createIntent(locationId, cartId);

// 2. Initialize Stripe with the restaurant's connected account
const stripePromise = loadStripe(
  process.env.NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY!,
  { stripeAccount: payment.stripeAccountId }
);

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

​

Testing

​

Payout schedule

​

Platform fees

​

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