Free · Open source

Payments foundation

TransactKit-LiteSpring Boot Stripe payments boilerplate

Spring Boot 4 Stripe payments boilerplate for hosted Checkout, Customers, local payment tracking, refunds, and verified webhooks.

Spring Boot 4Stripe CheckoutWebhooksH2 + MySQL
TransactKit-Lite product cover

Product preview

Release details

Version
v1.0.0
Java
25
Spring Boot
4.1.1
License
MIT

Capability summary

Features

The focused capabilities included in the current product generation.

Stripe-hosted Checkout

Create one-time Checkout Sessions in payment mode and send customers to Stripe's hosted payment page.

Customer operations

Create and retrieve minimal Stripe Customer records without persisting a competing local customer model.

Payment tracking

Persist one logical Payment per business reference with the latest Checkout attempt, Stripe IDs, amount, currency, status, and refunded total.

Full and partial refunds

Create full, partial, and multiple partial Stripe refunds against the stored PaymentIntent and synchronize the cumulative local projection.

Verified, retry-safe webhooks

Verify the raw Stripe signature, durably claim event IDs, deduplicate terminal deliveries, and retry RECEIVED or FAILED work.

Attempt-scoped idempotency

Reuse an open Checkout Session and use distinct attempt references for expired or failed attempts; refund references form Stripe idempotency keys.

Runnable local defaults

Start without Stripe credentials using in-memory H2, Flyway migrations, and Hibernate schema validation; switch to MySQL through environment variables.

Testing tools included

Use the browser API tester, Postman collection, offline automated suite, optional stripe-mock contract profile, and Stripe Test Mode workflow.

AI-ready project context

AGENTS.md, ARCHITECTURE.md, AI_RULES.md, and contribution guidance describe the payment lifecycle and safe modification boundaries.

Fit

Who this is for

  • Spring Boot applications adding one-time Stripe payments
  • Teams that want hosted Checkout instead of collecting card details
  • Backends that need a local payment projection synchronized by webhooks
  • Developers who want explicit payment, refund, and integration boundaries

Build or adopt

Why TransactKit-Lite?

TransactKit-Lite connects a focused one-time payment lifecycle without hiding Stripe behind a custom gateway.

Without TransactKit-Lite

  • Design Checkout attempt and retry behavior
  • Map Stripe events into local payment state
  • Make refund requests idempotent and cumulative
  • Build migrations, error handling, and integration tests

With TransactKit-Lite

  • Hosted Checkout Sessions use payment mode
  • Stable business references track logical payments
  • Signed webhooks update local payment and refund projections
  • H2, MySQL, Flyway, browser, Postman, and tests are included

Implementation resources

Technical documentation

Task-oriented setup, configuration, architecture, and API references for this product.

Evaluate TransactKit-Lite

Run the H2 defaults, inspect the payment boundary, then connect Stripe Test Mode when you are ready to exercise hosted Checkout and real event delivery.