Preparation for webhooks

Author: JanMikes

.env

@@ -39,3 +39,4 @@ PUZZLE_PUZZLE_PASSWORD=
 MAILER_DSN=smtp://mailer:1025
 
 STRIPE_API_KEY=
+STRIPE_WEBHOOK_SECRET=

config/services.php

@@ -26,6 +26,8 @@
     $parameters->set('puzzlePuzzleUsername', '%env(PUZZLE_PUZZLE_USERNAME)%');
     $parameters->set('puzzlePuzzlePassword', '%env(PUZZLE_PUZZLE_PASSWORD)%');
 
+    $parameters->set('stripeWebhookSecret', '%env(STRIPE_WEBHOOK_SECRET)%');
+
     $services = $configurator->services();
 
     $services->defaults()

public/img/puzzlie-1.png

@@ -3,20 +3,34 @@
 
 namespace SpeedPuzzling\Web\Controller;
 
+use SpeedPuzzling\Web\Services\MembershipManagement;
+use Stripe\StripeClient;
+use Stripe\Webhook;
 use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\DependencyInjection\Attribute\Autowire;
+use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\Routing\Attribute\Route;
 
 final class StripeWebhookController extends AbstractController
 {
-    #[Route(
-        path: [
-            'cs' => '/scan-puzzli/{code}',
-            'en' => '/en/scan-puzzle/{code}',
-        ],
-        name: 'stripe_webhook',
-    )]
-    public function __invoke(null|string $code): Response
+    public function __construct(
+        #[Autowire(param: 'stripeWebhookSecret')]
+        readonly private string $stripeWebhookSecret,
+        readonly private MembershipManagement $membershipManagement,
+    ) {
+    }
+
+    #[Route(path: '/webhook/stripe', name: 'stripe_webhook')]
+    public function __invoke(Request $request): Response
     {
+        /** @var string $signHeader */
+        $signHeader = $request->headers->get('Stripe-Signature', '');
+
+        $event = Webhook::constructEvent($request->getContent(), $signHeader, $this->stripeWebhookSecret);
+
+        $this->membershipManagement->handleEvent($event);
+
+        return new Response('ok');
     }
 }

src/Controller/StripeWebhookController.php

@@ -4,10 +4,13 @@
 
 namespace SpeedPuzzling\Web\Services;
 
+use Psr\Log\LoggerInterface;
 use SpeedPuzzling\Web\Message\CreatePlayerStripeCustomer;
 use SpeedPuzzling\Web\Query\GetPlayerProfile;
+use Stripe\Event;
 use Stripe\Price;
 use Stripe\StripeClient;
+use Stripe\Subscription;
 use Symfony\Component\Messenger\MessageBusInterface;
 use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
 use Symfony\Component\Routing\RouterInterface;
@@ -22,6 +25,8 @@ public function __construct(
         private StripeClient $stripeClient,
         private GetPlayerProfile $getPlayerProfile,
         private MessageBusInterface $messageBus,
+        private LoggerInterface $logger,
+        private StripeWebhookHandler $stripeWebhookHandler,
     ) {
     }
 
@@ -92,4 +97,43 @@ private function createCustomerId(string $playerId): string
 
         return $playerProfile->stripeCustomerId;
     }
+
+    public function handleEvent(Event $event): void
+    {
+        switch ($event->type) {
+            case 'customer.subscription.trial_will_end':
+                $subscription = $event->data->object ?? null;
+
+                if ($subscription instanceof Subscription) {
+                    $this->stripeWebhookHandler->handleTrialWillEnd($subscription);
+                }
+                break;
+            case 'customer.subscription.created':
+                $subscription = $event->data->object ?? null;
+
+                if ($subscription instanceof Subscription) {
+                    $this->stripeWebhookHandler->handleSubscriptionCreated($subscription);
+                }
+                break;
+            case 'customer.subscription.deleted':
+                $subscription = $event->data->object ?? null;
+
+                if ($subscription instanceof Subscription) {
+                    $this->stripeWebhookHandler->handleSubscriptionDeleted($subscription);
+                }
+                break;
+            case 'customer.subscription.updated':
+                $subscription = $event->data->object ?? null;
+
+                if ($subscription instanceof Subscription) {
+                    $this->stripeWebhookHandler->handleSubscriptionUpdated($subscription);
+                }
+                break;
+            default:
+                $this->logger->error('Unsupported Stripe webhook event', [
+                    'event_id' => $event->id,
+                    'event_type' => $event->type,
+                ]);
+        }
+    }
 }

src/Services/MembershipManagement.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SpeedPuzzling\Web\Services;
+
+use Stripe\Subscription;
+
+readonly final class StripeWebhookHandler
+{
+    public function handleTrialWillEnd(Subscription $stripeSubscription): void
+    {
+    }
+
+    public function handleSubscriptionCreated(Subscription $stripeSubscription): void
+    {
+    }
+
+    public function handleSubscriptionDeleted(Subscription $stripeSubscription): void
+    {
+    }
+
+    public function handleSubscriptionUpdated(Subscription $stripeSubscription): void
+    {
+    }
+}

src/Services/StripeWebhookHandler.php

@@ -1,10 +1,21 @@
 {% extends 'base.html.twig' %}
 
-{% block content %}
+{% block title %}{{ 'membership_payment_cancelled.meta.title'|trans }}{% endblock %}
+{% block meta_description %}{{ 'membership_payment_cancelled.meta.description'|trans }}{% endblock %}
 
-{% endblock %}
+{% block content %}
+    <div class="pb-4">
+        <div class="row gy-3 pb-3">
+            <div class="col-lg-5 col-md-8 col-sm-10">
+                <h1 class="h2">{{ 'membership_payment_cancelled.title'|trans }}</h1>
 
-{% block title %}
+                <p>{{ 'membership_payment_cancelled.text'|trans }}</p>
 
+                <p>
+                    <a class="btn btn-outline-primary me-2" href="{{ path('membership') }}"><i class="ci-arrow-left"></i> {{ 'membership_payment_cancelled.membership_link'|trans }}</a>
+                    <a class="btn btn-primary" href="{{ path('buy_membership') }}"><i class="ci-card"></i> {{ 'membership_payment_cancelled.payment_link'|trans }}</a>
+                </p>
+            </div>
+        </div>
+    </div>
 {% endblock %}
-

templates/membership-checkout-cancel.html.twig

@@ -6,35 +6,48 @@
 {% block content %}
     <div class="pb-4">
         <div class="row gy-3 pb-3">
-            <div class="col-lg-5 col-md-8 col-sm-10">
+            <div class="col-lg-5 col-md-8">
                 <h1 class="h2">{{ 'membership.title'|trans }}</h1>
 
-                <p>{{ 'membership.intro_text'|trans }}</p>
 
                 {% if membership %}
+                    <p class="text-success fs-3">
+                        <i class="ci-check-circle me-2"></i> {{ 'membership.membership_enabled'|trans }}
+                    </p>
+
                     {% if membership.billingPeriodEndsAt %}
-                        Příští platba: {{ membership.billingPeriodEndsAt|date('d.m.Y') }}
+                        <p>
+                            {{ 'membership.next_payment'|trans }}: <strong>{{ membership.billingPeriodEndsAt|date('d.m.Y H:i') }}</strong>
+                        </p>
                     {% endif %}
 
                     {% if membership.endsAt %}
-                        Platnost členství do: {{ membership.billingPeriodEndsAt|date('d.m.Y') }}
+                        {{ 'membership.membership_expiration'|trans }}: <strong>{{ membership.billingPeriodEndsAt|date('d.m.Y') }}</strong>
                     {% endif %}
 
                     <p>
-                        <a class="btn btn-outline-primary" href="{{ path('billing_portal') }}">Správa platební metody</a>
+                        <a class="btn btn-outline-primary" href="{{ path('billing_portal') }}">{{ 'membership.payment_portal_button'|trans }}</a>
                     </p>
                 {% else %}
-                    Koupit členství
-
-                    <div class="row text-center">
-                        <div class="col-6">
-                            <a class="btn btn-outline-primary mt-2" href="{{ path('buy_membership', {'priceLookupKey': 'puzzlership_monthly_promo'}) }}"><del class="small">6 € / month</del><br>3 € / month</a>
-                        </div>
-                    </div>
+                    <p>{{ 'membership.become_member'|trans }}</p>
+
+                    <p class="mt-2 text-center">
+                        <a class="btn btn-outline-primary mt-2 text-center fs-6" href="{{ path('buy_membership') }}">
+                            <small><i class="ci-card me-1"></i> {{ 'membership.subscribe_for'|trans }}</small>
+                            <br><del class="small">{{ 'membership.original_price_per_month'|trans }}</del>
+                            <br>{{ 'membership.price_per_month'|trans }}
+                        </a>
+                    </p>
                 {% endif %}
 
-                <p>Seznam věcí, které získám jako člen..</p>
+                <h2 class="mt-4">{{ 'membership.description_title'|trans }}</h2>
+                {{ 'membership.full_description'|trans|raw }}
+            </div>
+
+            <div class="col-lg-5 offset-lg-1 col-md-4 text-center">
+                <img class="img-fluid" src="{{ asset('img/puzzlie-1.png') }}" alt="Mascot">
             </div>
         </div>
+
     </div>
 {% endblock %}

templates/membership.html.twig

@@ -443,3 +443,28 @@ added_time_recap:
     add_time: "Přidat další čas"
     the_same_puzzle: "Ke stejným puzzlím"
     puzzle_detail: "Výsledky"
+
+membership:
+    meta:
+        title: "Členství"
+        description: ""
+    title: "MySpeedPuzzling členství"
+    become_member: "Předplaťte si MySpeedPuzzling členství - podpořte vývoj a získejte přístup k exkluzivním funkcím pouze pro členy. Nyní s výhodnější zavádějící cenou, která vám zůstane po celou dobu členství."
+    membership_enabled: "Děkujeme, že jste součástí!"
+    next_payment: "Příští platba"
+    membership_expiration: "Platnost členství do"
+    payment_portal_button: "Upravit předplatné (platební portál)"
+    description_title: "Proč se stát členem?"
+    full_description: "<p>To brzy doplníme ... :-)</p>"
+    subscribe_for: "Předplatit za"
+    original_price_per_month: "150 Kč / měsíc"
+    price_per_month: "100 Kč / měsíc"
+
+membership_payment_cancelled:
+    meta:
+        title: "Platba byla zrušena"
+        description: ""
+    title: "Platba byla zrušena"
+    text: "Platební proces byl přerušen, nejspíše vámi :-)."
+    membership_link: "Zpět na přehled o členství"
+    payment_link: "Opakovat platbu"

translations/messages.cs.yml

@@ -441,3 +441,28 @@ added_time_recap:
     add_time: "Add new time"
     the_same_puzzle: "For the same puzzle"
     puzzle_detail: "Results"
+
+membership:
+    meta:
+        title: "Membership"
+        description: ""
+    title: "MySpeedPuzzling Membership"
+    become_member: "Subscribe to MySpeedPuzzling Membership - support development and gain access to exclusive member-only features. Now at an introductory price that stays with you for the duration of your membership."
+    membership_enabled: "Thank you for being part of the community!"
+    next_payment: "Next payment"
+    membership_expiration: "Membership valid until"
+    payment_portal_button: "Manage subscription (payment portal)"
+    description_title: "Why become a member?"
+    full_description: "<p>We will fill this in soon ... :-)</p>"
+    subscribe_for: "Subscribe for"
+    original_price_per_month: "6€ / month"
+    price_per_month: "4€ / month"
+
+membership_payment_cancelled:
+    meta:
+        title: "Payment Cancelled"
+        description: ""
+    title: "Payment Cancelled"
+    text: "The payment process was interrupted, most likely by you :-)."
+    membership_link: "Back to membership overview"
+    payment_link: "Retry payment"