Weave Code
Stripe Laravel Package
lunarphp/stripe
Stripe payment integration for Lunar, the Laravel ecommerce platform. Connect Stripe to Lunar carts and orders to accept card payments, handle payment intents, and manage Stripe-backed transactions directly within your Laravel storefront. Ideal for adding Stripe checkout to Lunar-powered shops.
[READ ONLY] Subtree split of the Stripe payments driver (see lunarphp/lunar)
Frequently asked questions about Stripe
- What is lunarphp/stripe and do I need it for Stripe checkout in Laravel?
- It is the Stripe payments driver for Lunar, the Laravel ecommerce platform. It plugs into Lunar's payment driver abstraction so carts and orders in a Lunar storefront can accept card payments through Stripe. It is not a standalone Stripe library and adds nothing outside a Lunar application.
- How do I install lunarphp/stripe in a Lunar store?
- Run composer require lunarphp/stripe, publish the package configuration, then add your Stripe publishable key, secret key, and webhook secret. Finally register the Stripe driver in Lunar's payment configuration. Pin the package version so it matches your installed Lunar core release.
- Which Laravel and PHP versions does lunarphp/stripe support?
- Support tracks the Lunar release line, which generally means Laravel 9, 10, or 11 with PHP 8.1 or newer depending on the tag. The split tags are generated from the lunarphp/lunar monorepo, so check the composer.json of the matching split tag for exact constraints. Pin both the Lunar core and this driver together.
- How do I configure Stripe API keys and the webhook secret in Lunar?
- Publish the package config and set the publishable key, secret key, and webhook signing secret, ideally through environment variables. Confirm which Stripe API version the bundled Stripe PHP SDK pins before going live. Then register the driver in Lunar's payment configuration so it is selectable at checkout.
- Where do I report a bug or contribute a fix, since this repo is read-only?
- This repository is a read-only subtree split of the Stripe driver from the lunarphp/lunar monorepo. Issues, pull requests, and releases belong upstream in lunarphp/lunar, and fixes flow down when the split is regenerated. If you need an urgent hotfix you will be forking or waiting on an upstream release.
- Does lunarphp/stripe support Payment Intents and SCA/3DS authentication?
- The driver is built around Stripe Payment Intents. You should verify the redirect and 3DS authentication flow required in the EU and UK against your Lunar version before committing, using Stripe test mode end to end. Card payments that require strong customer authentication must complete that flow cleanly.
- How do I handle Stripe webhooks with this driver?
- You expose a webhook route, exempt it from CSRF protection, and let the driver verify the Stripe signature using your webhook secret. Confirm whether idempotency handling for repeated events is implemented or left to you. Test replay and failure scenarios in Stripe test mode before production.
- Does lunarphp/stripe handle refunds and multi-currency payments?
- Lunar supports multi-market pricing, so confirm multi-currency behaviour fits your storefront. For refunds, check whether full, partial, and asynchronous refund webhooks are handled in the release you install. Validate both against Stripe's test mode rather than assuming coverage.
- How can I test Stripe payments before going live?
- Use Stripe test keys and test card numbers, and check the lunarphp/lunar monorepo CI for runnable integration tests against Stripe test mode. Run a parallel period where your existing integration and this driver are both live in test mode and reconcile against the Stripe dashboard. That surfaces webhook and payment intent state mismatches early.
- What are the alternatives to lunarphp/stripe?
- If you are on Lunar, this driver is the intended Stripe path; alternatives are other Lunar payment drivers or a bespoke implementation. Laravel Cashier suits subscription billing but is not a Lunar order and checkout driver. Migrating from Cashier or another platform means re-modelling orders, payment intents, and webhook state into Lunar's tables.
Weaver
How can I help you explore Laravel packages today?