Stripe Integration

Configure Stripe for processing membership payments, event tickets, and other transactions.

Setup

1. Connect Account

   Click "Connect to Stripe" or enter API keys

2. Configure Webhooks

   Webhook URL automatically configured

3. Set Currency

   Configure default currency

4. Test Payments

   Process test transaction to verify

Configuration Options

Setting	Description
Mode	Live or Test
Currency	Default currency
Tax Behavior	Inclusive or exclusive
Statement Descriptor	Appears on statements

Payment Methods

Enable/disable payment methods:

• Credit/Debit cards
• Apple Pay
• Google Pay
• Bank transfers

Webhook Events

Automatically handles:

• payment_intent.succeeded
• payment_intent.failed
• customer.subscription.updated
• customer.subscription.deleted
• charge.refunded
• invoice.payment_succeeded
• invoice.payment_failed

Features

Stripe Integration

Acceptance Criteria

Frontend

• UI supports the workflows described in this feature.

Backend / API

• Backend behavior supports this feature as documented.

Permissions

• Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

Business Rules

• All business rules for this feature are enforced.

Error Handling

• Error states return clear messages and appropriate HTTP status codes.

Implementation Contracts

Backend (API)

POST   /api/integrations/stripe/connect
GET    /api/integrations/stripe/status
PUT    /api/integrations/stripe/settings
GET    /api/integrations/stripe/webhook-status
POST   /api/integrations/stripe/test