Cancel Subscription - Webhook event handleCustomerSubscriptionUpdated log error

[MilanUnjiya4149]

Cashier Stripe Version

15.6.3

Laravel Version

10.17.1

PHP Version

8.2.4

Database Driver & Version

No response

Description

Hi,

I noticed that Stripe logs an Error when canceling a Subscription.

would be great if Cashier cancel() method could handle this case.

API versions 2025-03-31.basil

Steps To Reproduce

$tenant = Tenant::findOrFail($tenantId);
$tenant->subscription('default')->cancel();

log:
local.ERROR: Undefined array key "current_period_end" {"exception":"[object] (ErrorException(code: 0): Undefined array key "current_period_end" at root\vendor\laravel\cashier\src\Http\Controllers\WebhookController.php:171)

[driesvints]

Right now, Cashier does not supports this version sorry.

[MilanUnjiya4149]

Hello @driesvints

Thank you for the quick comment.

I'm using v15.6.3 and It's latest version. still it's not supports.

can you please guide me where I'm doing wrong?

[taylorotwell]

Hi @MilanUnjiya4149 - @driesvints means that Cashier has released a new API version with several breaking changes and Cashier does not support that Stripe API version (Basil).

[driesvints]

Right now we don't immediately have time to work on support for this sorry but we would be open to PR's for a new major version of Cashier that fully supports the new Basil version.

[jfrosorio]

Hey @MilanUnjiya4149, I ran into the same issue recently while starting a new project using the latest version of Laravel Cashier.

On the Stripe Dashboard, I created a new Sandbox environment and manually added a webhook — which turned out to be a BIG mistake. Stripe automatically pinned the API version to the latest one (basil), which caused compatibility issues with Cashier.

How I solved it

1. I deleted the manually created webhook from the Stripe Dashboard.
2. Then, I let Cashier create the webhook for me using the command:

php artisan cashier:webhook --url "https://example.com/stripe/webhook"

This time, Stripe automatically used the correct API version (2023-10-16), which works perfectly with Laravel Cashier.

Here’s a screenshot from the Webhook details page in the Stripe Dashboard, showing the correct API version after running the command:

Hope this helps you get back on the right track!

[touqeershafi]

I also faced the similar issue when doing subscription cancellation, Seems like webhook controller is expecting current_period_end on the root of the $data variable on line number 171.

if ($data['cancel_at_period_end'] ?? false) {
  $subscription->ends_at = $subscription->onTrial()
    ? $subscription->trial_ends_at
    : Carbon::createFromTimestamp($data['current_period_end']);
} elseif (isset($data['cancel_at']) || isset($data['canceled_at'])) {
  $subscription->ends_at = Carbon::createFromTimestamp($data['cancel_at'] ?? $data['canceled_at']);
 else {
   $subscription->ends_at = null;
}

However current_period_end is on the item level, Now its inside $data['items']['data'][0]['current_period_end'] eg

{
  "payload": {
    "id": "xxx",
    "object": "subscription",
    "application": null,
    "application_fee_percent": null,
    "automatic_tax": {
      "disabled_reason": null,
      "enabled": false,
      "liability": null
    },
    "billing_cycle_anchor": 1745058161,
    "billing_cycle_anchor_config": null,
    "cancel_at": 1747650161,
    "cancel_at_period_end": true,
    "canceled_at": 1745088053,
    "cancellation_details": {
      "comment": null,
      "feedback": null,
      "reason": "cancellation_requested"
    },
    "collection_method": "charge_automatically",
    "created": 1745058161,
    "currency": "eur",
    "customer": "xxx",
    "days_until_due": null,
    "default_payment_method": "xxxx",
    "default_source": null,
    "default_tax_rates": [],
    "description": null,
    "discounts": [],
    "ended_at": null,
    "invoice_settings": {
      "account_tax_ids": null,
      "issuer": {
        "type": "self"
      }
    },
    "items": {
      "object": "list",
      "data": [
        {
          "id": "xxx",
          "object": "subscription_item",
          "created": 1745058162,
          "current_period_end": 1747650161,
          "current_period_start": 1745058161,
          "discounts": [],
          "metadata": [],
          "plan": {
            "id": "xxxx",
            "object": "plan",
            "active": true,
            "amount": 500,
            "amount_decimal": "500",
            "billing_scheme": "per_unit",
            "created": 1744983468,
            "currency": "eur",
            "interval": "month",
            "interval_count": 1,
            "livemode": false,
            "metadata": [],
            "meter": null,
            "nickname": "Monthly Pricing",
            "product": "xxx",
            "tiers_mode": null,
            "transform_usage": null,
            "trial_period_days": null,
            "usage_type": "licensed"
          },
          "price": {
            "id": "xxx",
            "object": "price",
            "active": true,
            "billing_scheme": "per_unit",
            "created": 1744983468,
            "currency": "eur",
            "custom_unit_amount": null,
            "livemode": false,
            "lookup_key": null,
            "metadata": [],
            "nickname": "Monthly Pricing",
            "product": "xxx",
            "recurring": {
              "interval": "month",
              "interval_count": 1,
              "meter": null,
              "trial_period_days": null,
              "usage_type": "licensed"
            },
            "tax_behavior": "unspecified",
            "tiers_mode": null,
            "transform_quantity": null,
            "type": "recurring",
            "unit_amount": 500,
            "unit_amount_decimal": "500"
          },
          "quantity": 1,
          "subscription": "xxx",
          "tax_rates": []
        }
      ],
      "has_more": false,
      "total_count": 1,
      "url": "xxx"
    },
    "latest_invoice": "xxx",
    "livemode": false,
    "metadata": {
      "is_on_session_checkout": "true",
      "type": "prod_S970hFlZTICUfQ",
      "name": "prod_S970hFlZTICUfQ"
    },
    "next_pending_invoice_item_invoice": null,
    "on_behalf_of": null,
    "pause_collection": null,
    "payment_settings": {
      "payment_method_options": {
        "acss_debit": null,
        "bancontact": null,
        "card": {
          "network": null,
          "request_three_d_secure": "automatic"
        },
        "customer_balance": null,
        "konbini": null,
        "sepa_debit": null,
        "us_bank_account": null
      },
      "payment_method_types": null,
      "save_default_payment_method": "off"
    },
    "pending_invoice_item_interval": null,
    "pending_setup_intent": null,
    "pending_update": null,
    "plan": {
      "id": "xxx",
      "object": "plan",
      "active": true,
      "amount": 500,
      "amount_decimal": "500",
      "billing_scheme": "per_unit",
      "created": 1744983468,
      "currency": "eur",
      "interval": "month",
      "interval_count": 1,
      "livemode": false,
      "metadata": [],
      "meter": null,
      "nickname": "Monthly Pricing",
      "product": "xxx",
      "tiers_mode": null,
      "transform_usage": null,
      "trial_period_days": null,
      "usage_type": "licensed"
    },
    "quantity": 1,
    "schedule": null,
    "start_date": 1745058161,
    "status": "active",
    "test_clock": null,
    "transfer_data": null,
    "trial_end": null,
    "trial_settings": {
      "end_behavior": {
        "missing_payment_method": "create_invoice"
      }
    },
    "trial_start": null
  }
}

If you want I can raise a PR, for this, But I'm not sure what will be the overall impact of it.

[touqeershafi]

Using stripe-cli it always falls back to latest api version and there is no settings on the stripe dashboard to change the stripe api version

stripe listen --forward-to localhost:8000/stripe/webhook
> Ready! You are using Stripe API Version [2025-03-31.basil]. Your webhook signing secret is xxxxxx

[IsraelOrtuno]

Impact for using 2025-03-31.basil could be a bit high. Changelog and breaking changes detailed here:

https://docs.stripe.com/changelog/basil

[AsafMazuz1]

Using stripe-cli, it always falls back to latest api version and there is no settings on the stripe dashboard to change the stripe api version

stripe listen --forward-to localhost:8000/stripe/webhook
> Ready! You are using Stripe API Version [2025-03-31.basil]. Your webhook signing secret is xxxxxx

Yes, stuck with that now,
I am considering what my options are,
Add custom code on my local machine for the tests or test it on production 🥲
The webhook configuration on Stripe matches the supported version.

[AsafMazuz1]

Using stripe-cli, it always falls back to latest api version and there is no settings on the stripe dashboard to change the stripe api version

stripe listen --forward-to localhost:8000/stripe/webhook
> Ready! You are using Stripe API Version [2025-03-31.basil]. Your webhook signing secret is xxxxxx

Yes, stuck with that now, I am considering what my options are, Add custom code on my local machine for the tests or test it on production 🥲 The webhook configuration on Stripe matches the supported version.

Added:
if ($data['cancel_at_period_end'] ?? false) {
$subscription->ends_at = $subscription->onTrial()
? $subscription->trial_ends_at
: Carbon::createFromTimestamp(
$data['current_period_end'] ??
($data['items']['data'][0]['current_period_end'] ?? null)
);
} elseif (isset($data['cancel_at']) || isset($data['canceled_at'])) {
$subscription->ends_at = Carbon::createFromTimestamp($data['cancel_at'] ?? $data['canceled_at']);
} else {
$subscription->ends_at = null;
}
To my local vendor, code to test it. works fine.

[StefanNeuser]

It is also not possible to select a different webhook API version (at least on the Stripe sandbox), so this library is currently not usable?

[IsraelOrtuno]

It is also not possible to select a different webhook API version (at least on the Stripe sandbox), so this library is currently not usable?

@StefanNeuser If you create the webhooks via API or using php artisan cashier:webhook the will be created for the supported version.

[StefanNeuser]

@StefanNeuser If you create the webhooks via API or using php artisan cashier:webhook the will be created for the supported version.

@IsraelOrtuno good to know! Thanks! Before this can work everybody has to setup the stripes key and secret first, right?

Another question: To test the webhooks locally stripe-cli is required? Because php artisan cashier:webhook is not using the expose (pro) url, right?

Update! To run local webhooks with Expose or Ngrok, you must set the APP_URL in the .env file to the expose URL before running php artisan cashier:webhook

Than it's working fine without any code change because cashier create the webhook-target in the right Webhook-API-Version.