Revert "remove paddle (#44)"

This reverts commit 4bf465c.

Author: driesvints

.vitepress/config.ts

@@ -83,6 +83,18 @@ export default defineConfigWithTheme<ThemeConfig>({
                     { text: 'Installation', link: '/installation' },
                     { text: 'Customization', link: '/customization' },
                 ],
+            }, {
+                text: 'Spark Paddle',
+                items: [
+                    { text: 'Configuration', link: '/spark-paddle/configuration' },
+                    { text: 'Plans', link: '/spark-paddle/plans' },
+                    { text: 'Middleware', link: '/spark-paddle/middleware' },
+                    { text: 'Events', link: '/spark-paddle/events' },
+                    { text: 'Testing', link: '/spark-paddle/testing' },
+                    { text: 'Cookbook', link: '/spark-paddle/cookbook' },
+                    { text: 'Customization', link: '/spark-paddle/customization' },
+                    { text: 'Upgrade', link: '/spark-paddle/upgrade' },
+                ],
             }, {
                 text: 'Spark Stripe',
                 items: [

src/installation.md

@@ -20,13 +20,13 @@ To get started installing Spark, add the Spark repository to your application's
 ],
 ```
 
-Next, you may add the `laravel/spark-stripe` package to the list of required packages in your `composer.json` file:
+Next, you may add the `laravel/spark-paddle` or `laravel/spark-stripe` package to the list of required packages in your `composer.json` file:
 
 ```json
 "require": {
     "php": "^8.1",
     "laravel/framework": "^10.0",
-    "laravel/spark-stripe": "^4.0"
+    "laravel/spark-paddle": "^4.0"
 },
 ```
 
@@ -77,7 +77,7 @@ php artisan migrate
 If you are using the Stripe edition of Spark and plan to bill a model other than the `App\Models\User` model, you should follow [these instructions](./spark-stripe/customization.md#migrations) before running the migration command.
 :::
 
-Lastly, you will need to configure Stripe webhooks so that these services can communicate with your local application via webhooks. To get started, read our dedicated documentation on [Stripe webhooks](./spark-stripe/configuration.md#stripe-webhooks). Webhooks are required during both local development and in production environments.
+Lastly, you will need to configure Stripe or Paddle webhooks so that these services can communicate with your local application via webhooks. To get started, read our dedicated documentation on [Stripe webhooks](./spark-stripe/configuration.md#stripe-webhooks) or [Paddle webhooks](./spark-paddle/configuration.md#paddle-webhooks). Webhooks are required during both local development and in production environments.
 
 That's it! Next, you may navigate to your application's `config/spark.php` configuration file and begin configuring your Spark installation.
 
@@ -97,6 +97,6 @@ If your Spark license has expired and you don't want to renew the license your `
 "require": {
     "php": "^8.1",
     "laravel/framework": "^10.0",
-    "laravel/spark-stripe": "4.y.z"
+    "laravel/spark-paddle": "4.y.z"
 },
 ```

src/introduction.md

@@ -10,7 +10,25 @@ Laravel Spark is the perfect starting point for your next big idea. When combine
 
 ## Supported Payment Providers
 
-Spark supports Stripe as its payment provider. **At this time, it is not possible to implement your own custom payment provider when using Spark.**
+Spark supports two payment providers, and purchasing a Spark license grants you the ability to use either of these payment providers. **At this time, it is not possible to implement your own custom payment provider when using Spark.** We'll provide a brief overview of each provider below.
+
+### Paddle
+
+[Paddle](https://paddle.com) is a robust billing provider that serves as a merchant of record for your application. Paddle removes the burden of tax compliance from your SaaS business by handling the complexity of gathering and paying your VAT for you. In addition, Paddle provides support for accepting payments from your customers via credit card or PayPal, localized pricing, and hosted invoices.
+
+Spark's Paddle support is provided by the underlying [Laravel Cashier Paddle](https://laravel.com/docs/cashier-paddle) library.
+
+:::warning Paddle Account Approval
+
+Your Paddle account must be approved by Paddle before you can begin using Spark. To apply for an account, please visit the [Paddle website](https://paddle.com). **While you are developing your application, you may use the [Paddle Sandbox](https://developer.paddle.com/getting-started/sandbox)**.
+:::
+
+#### Limitations
+
+We have listed some known limitations of using the Paddle payment provider below:
+
+- When a recurring coupon is used while subscribing to a plan, the coupon discount will be applied on every billing cycle. However, if the subscription's quantity or plan changes, Paddle will remove the coupon from the subscription.
+- Because Paddle does not allow plan quantity changes during trial periods, the Paddle edition of Spark does not support requiring a credit card up front when beginning a trial. All trial periods are started without a credit card or payment method provided up front during the user's initial registration process.
 
 ### Stripe
 
@@ -36,12 +54,12 @@ You may not sell Spark powered applications on code distribution platforms such
 
 #### **Does Spark support any other payment providers?**
 
-No. Spark only supports Stripe and it is not possible for developers to customize Spark to accept additional providers. If you need to use another payment provider **you should not purchase Laravel Spark**.
+No. Spark only supports Stripe and Paddle and it is not possible for developers to customize Spark to accept additional providers. If you need to use another payment provider **you should not purchase Laravel Spark**.
 
 #### **Am I required to use Tailwind / Blade / Vue / etc. in order to use Spark?**
 
 No. Spark's billing portal is totally isolated from the rest of your Laravel application and includes its own pre-compiled frontend assets. Your own application may be built using the frontend technologies of your choice.
 
 #### **Why are my customers presented with a payment confirmation screen?**
 
-Extra verification is sometimes required in order to confirm and process a payment. When this happens, Stripe will present a payment confirmation screen. Payment confirmation screens presented by Stripe or Spark may be tailored to a specific bank or card issuer's payment flow and can include additional card confirmation, a temporary small charge, separate device authentication, or other forms of verification.
+Extra verification is sometimes required in order to confirm and process a payment. When this happens, Paddle or Stripe will present a payment confirmation screen. Payment confirmation screens presented by Paddle, Stripe, or Spark may be tailored to a specific bank or card issuer's payment flow and can include additional card confirmation, a temporary small charge, separate device authentication, or other forms of verification.