Skip to main content

Stripe Integration

SpaceOS uses Stripe for payment processing on bookings.

Setup

  1. Create a Stripe account
  2. Get your Stripe API keys (test and live)
  3. Configure in ZenCore environment variables:
    • STRIPE_SECRET_KEY — Your Stripe secret key
    • STRIPE_WEBHOOK_SECRET — Webhook endpoint signing secret
  4. Set up the Stripe webhook endpoint: POST /api/v1/webhooks/stripe

Stripe Events Handled

EventAction
payment_intent.succeededBooking confirmed
payment_intent.payment_failedBooking payment failed
charge.refundedRefund processed

Test vs Live

EnvironmentStripe Mode
SandboxStripe Test Mode (use sk_test_* keys)
ProductionStripe Live Mode (use sk_live_* keys)

Next Steps