Stripe Integration

The Stripe Integration qBit provides full-featured payment processing for qqq applications. Built on Stripe's latest API, this qBit handles the complexity of payment processing so you can focus on your business logic.

Why We Built This

Payment integration is one of the most critical—and error-prone—parts of any application. We've spent years refining this qBit to handle edge cases that most developers don't think about until they're losing money: failed webhook deliveries, currency conversion issues, subscription proration bugs, and PCI compliance headaches.

This qBit abstracts away all of that complexity while still giving you full control when you need it.

Core Capabilities

Architecture

The qBit follows qqq's standard patterns: it provides MetaData producers for Stripe-related tables (Customers, Subscriptions, Invoices, PaymentMethods), processes for common workflows (CreateSubscription, CancelSubscription, RefundPayment), and a webhook handler that automatically routes events to your custom handlers.

// Example: Creating a subscription is one line
Subscription sub = stripeService.createSubscription(customerId, priceId);

What's New in v4

Production Ready

This qBit powers payment processing for dozens of production applications, handling millions in monthly transaction volume. It's been battle-tested with edge cases like timezone-sensitive billing cycles, partial refunds, subscription upgrades mid-cycle, and webhook storms during Stripe outages.

Maven

<dependency>
    <groupId>io.qrun</groupId>
    <artifactId>qbit-stripe</artifactId>
    <version>4.0.2</version>
</dependency>

Configuration

stripe:
  apiKey: ${STRIPE_API_KEY}
  webhookSecret: ${STRIPE_WEBHOOK_SECRET}
  testMode: false

Requirements