Introduction

makfly/stripe-cashier-bundle brings to Symfony a Stripe billing foundation:

• subscriptions and trials
• one-shot payments
• Stripe Checkout
• Stripe webhooks with extensible handlers
• automatic PDF archiving of paid invoices (GeneratedInvoice)
• local invoice storage in var/data/invoices
• Doctrine integration for Stripe customers, subscriptions and generated invoices
• [optional] Symfony Messenger integration for asynchronous webhook processing

The bundle is designed for two use cases:

1. a Symfony project that wants a billing base ready to use
2. a business application that wants to keep control of its order flow while delegating Stripe, webhooks and invoice archiving

Prerequisites

ext-intl

ext-intl is recommended, but not required.

Without intl, the bundle continues to work:

• amounts fall back to a safe fallback
• invoice dates fall back to ISO format (YYYY-MM-DD)
• FR/EN label translations remain available

With intl installed, you get:

• native monetary formatting by locale
• cleaner localized dates in PDFs
• FR/EN rendering closer to a production invoice

Bundle contract

The official installation flow is:

composer require makfly/stripe-cashier-bundle
php bin/console cashier:install

The install command prepares:

• config/packages/cashier.yaml
• config/packages/cashier_doctrine.yaml
• config/routes/cashier.yaml
• Stripe variables in .env
• var/data
• var/data/invoices

Covered surface

The bundle currently handles:

• StripeCustomer
• Subscription
• SubscriptionItem
• GeneratedInvoice
• common Stripe billing webhooks
• PDF rendering and archiving of invoices

It deliberately leaves to the consuming application:

• business order logic
• authorization rules
• front-end screens
• reservation or fulfillment workflows

Install the bundle →