Ghost Release: 4.33.1

TL;DR

Ghost v4.33.1 - Stripe Integration Fixes

This patch release addresses critical issues with Stripe integration in Ghost, fixing two bugs that could cause problems for sites using Stripe for payments. The first fix prevents Ghost from crashing during startup when using revoked Stripe API keys, while the second resolves an issue where customers weren't receiving emails after completing Stripe Checkout payments. These fixes ensure more reliable payment processing and better error handling for Ghost sites with paid memberships.

Highlight of the Release

• Fixed site crashes during startup when using revoked Stripe API keys
• Fixed webhook handling for Stripe Checkout to ensure customers receive emails after payment
• Improved error handling and logging for Stripe integration issues

Migration Guide

No migration steps are required for this patch release. The update can be applied without any additional configuration changes.

Upgrade Recommendations

This update is highly recommended for all Ghost sites using Stripe for payments or memberships. The fixes address critical issues that could cause site crashes during startup and prevent customers from receiving emails after completing payments.

To upgrade:

• If using Ghost(Pro), your site will be updated automatically
• If self-hosting, follow the standard upgrade process:

  ghost update
  

Bug Fixes

Fixed crashing on boot with revoked Stripe keys

The previous refactoring of Stripe boot logic had a gap in error handling that could cause Ghost to crash during startup when using revoked Stripe API keys. This update adds proper try/catch blocks around the Stripe services initialization, including migrations and webhook initialization, ensuring that errors are properly caught and logged rather than crashing the application.

Fixed webhook handling of Stripe Checkout

This patch resolves an issue where the Stripe Checkout webhook handler was failing to send email notifications to customers after they completed payments. The problem was caused by a faulty reference in the Webhook Controller, which has now been fixed to ensure proper email delivery after successful payments.

New Features

No new features were added in this patch release. This is a bug fix release focused on resolving issues with Stripe integration.

Security Updates

No security fixes were included in this patch release.

Performance Improvements

No specific performance improvements were included in this patch release. The changes focus on bug fixes for Stripe integration functionality.

Impact Summary

This patch release addresses two critical bugs in Ghost's Stripe integration that could significantly impact sites using paid memberships. The first fix prevents site crashes during startup when using revoked or invalid Stripe API keys by properly handling errors during the initialization process. The second fix ensures that customers receive email notifications after completing payments through Stripe Checkout, which was previously failing due to a faulty reference in the webhook controller.

These fixes improve the overall stability and reliability of Ghost sites using Stripe for payments, ensuring better error handling during startup and a more complete payment experience for customers. Site administrators will benefit from more robust error logging and fewer unexpected crashes, while members will have a more reliable payment experience with proper email notifications.

Full Release Notes