This course is archived!

This tutorial uses an older version of Symfony of the stripe-php SDK. The majority of the concepts are still valid, though there *are* differences. We've done our best to add notes & comments that describe these changes.

> Dev Tools > Stripe Level 2: Subscriptions, Discounts, Webhooks, oh my!
Buy Access to Course
16.

Webhook: Subscription Canceled

Share this awesome video!

|

Keep on Learning!

Start your All-Access Pass

Eventually, this function will handle several event types. To handle each, create a switch-case statement: switch ($stripeEvent->type):

36 lines | src/AppBundle/Controller/WebhookController.php
// ... lines 1 - 8
class WebhookController extends BaseController
{
// ... lines 11 - 13
public function stripeWebhookAction(Request $request)
{
// ... lines 16 - 22
$stripeEvent = $this->get('stripe_client')
->findEvent($eventId);
switch ($stripeEvent->type) {
// ... lines 27 - 31
}
// ... lines 33 - 34
}
}

That's the field that'll hold one of those many event types we saw earlier.

The first type we'll handle is customer.subscription.deleted. We'll fill in the logic here in a second. Add the break:

36 lines | src/AppBundle/Controller/WebhookController.php
// ... lines 1 - 8
class WebhookController extends BaseController
{
// ... lines 11 - 13
public function stripeWebhookAction(Request $request)
{
// ... lines 16 - 22
$stripeEvent = $this->get('stripe_client')
->findEvent($eventId);
switch ($stripeEvent->type) {
case 'customer.subscription.deleted':
// todo - fully cancel the user's subscription
break;
// ... lines 30 - 31
}
// ... lines 33 - 34
}
}

We shouldn't receive any other event types because of how we configured the webhook, but just in case, throw an Exception: "Unexpected webhook from Stripe" and pass the type:

36 lines | src/AppBundle/Controller/WebhookController.php
// ... lines 1 - 8
class WebhookController extends BaseController
{
// ... lines 11 - 13
public function stripeWebhookAction(Request $request)
{
// ... lines 16 - 22
$stripeEvent = $this->get('stripe_client')
->findEvent($eventId);
switch ($stripeEvent->type) {
case 'customer.subscription.deleted':
// todo - fully cancel the user's subscription
break;
default:
throw new \Exception('Unexpected webhook type form Stripe! '.$stripeEvent->type);
}
// ... lines 33 - 34
}
}

At the bottom, well, we can return anything back to Stripe. How about a nice message: "Event Handled" and then the type. Well, there is one important piece: you must return a 200-level status code. If you return a non 200 status code, Stripe will think the webhook failed and will try to send it again, over and over again. But 200 means:

Yo Stripe, it's cool - I heard you, I handled it.

Quick! Cancel the Subscription!

Alright, let's cancel the subscription! First, we need to find the Subscription in our database. And check this out: the subscription id lives at data.object.id. That's because this type of event embeds the subscription in question. Other event types will embed different data.

Add $stripeSubscriptionId = $stripeEvent->data->object->id:

61 lines | src/AppBundle/Controller/WebhookController.php
// ... lines 1 - 8
class WebhookController extends BaseController
{
// ... lines 11 - 13
public function stripeWebhookAction(Request $request)
{
// ... lines 16 - 26
switch ($stripeEvent->type) {
case 'customer.subscription.deleted':
$stripeSubscriptionId = $stripeEvent->data->object->id;
// ... lines 30 - 33
break;
default:
throw new \Exception('Unexpected webhook type form Stripe! '.$stripeEvent->type);
}
// ... lines 38 - 39
}
// ... lines 41 - 60
}

Next, the subscription table has a stripeSubscriptionId field on it. Let's query on this! Because I already know I'll want to re-use this next code, I'll put the logic into a private function. On this line, call that future function with $subscription = $this->findSubscription() and pass it $stripeSubscriptionId:

61 lines | src/AppBundle/Controller/WebhookController.php
// ... lines 1 - 8
class WebhookController extends BaseController
{
// ... lines 11 - 13
public function stripeWebhookAction(Request $request)
{
// ... lines 16 - 26
switch ($stripeEvent->type) {
case 'customer.subscription.deleted':
$stripeSubscriptionId = $stripeEvent->data->object->id;
$subscription = $this->findSubscription($stripeSubscriptionId);
// ... lines 31 - 33
break;
default:
throw new \Exception('Unexpected webhook type form Stripe! '.$stripeEvent->type);
}
// ... lines 38 - 39
}
// ... lines 41 - 60
}

Scroll down and create this: private function findSubscription() with its $stripeSubscriptionId argument:

61 lines | src/AppBundle/Controller/WebhookController.php
// ... lines 1 - 8
class WebhookController extends BaseController
{
// ... lines 11 - 41
/**
* @param $stripeSubscriptionId
* @return \AppBundle\Entity\Subscription
* @throws \Exception
*/
private function findSubscription($stripeSubscriptionId)
{
// ... lines 49 - 59
}
}

Query by adding $subscription = $this->getDoctrine()->getRepository('AppBundle:Subscription') and then findOneBy() passing this an array with one item: stripeSubscriptionId - the field name to query on - set to $stripeSubscriptionId:

61 lines | src/AppBundle/Controller/WebhookController.php
// ... lines 1 - 8
class WebhookController extends BaseController
{
// ... lines 11 - 46
private function findSubscription($stripeSubscriptionId)
{
$subscription = $this->getDoctrine()
->getRepository('AppBundle:Subscription')
->findOneBy([
'stripeSubscriptionId' => $stripeSubscriptionId
]);
if (!$subscription) {
throw new \Exception('Somehow we have no subscription id ' . $stripeSubscriptionId);
}
// ... lines 58 - 59
}
}

If there is no matching Subscription... well, that shouldn't happen! But just in case, throw a new Exception with a really confused message. Something is not right.

Finally, return the $subscription on the bottom:

61 lines | src/AppBundle/Controller/WebhookController.php
// ... lines 1 - 8
class WebhookController extends BaseController
{
// ... lines 11 - 46
private function findSubscription($stripeSubscriptionId)
{
$subscription = $this->getDoctrine()
->getRepository('AppBundle:Subscription')
->findOneBy([
'stripeSubscriptionId' => $stripeSubscriptionId
]);
if (!$subscription) {
throw new \Exception('Somehow we have no subscription id ' . $stripeSubscriptionId);
}
return $subscription;
}
}

Ok, head back up to the action method. Hmm, so all we really need to do now is call the cancel() method on $subscription! But let's get a little bit more organized. Open SubscriptionHelper and add a new method there: public function fullyCancelSubscription() with the Subscription object that should be canceled. Below, really simple, say $subscription->cancel(). Then, use the Doctrine entity manager to save this to the database:

81 lines | src/AppBundle/Subscription/SubscriptionHelper.php
// ... lines 1 - 8
class SubscriptionHelper
{
// ... lines 11 - 73
public function fullyCancelSubscription(Subscription $subscription)
{
$subscription->cancel();
$this->em->persist($subscription);
$this->em->flush($subscription);
}
}

Mind blown!

Back in the controller, call this! Above the switch statement, add a $subscriptionHelper variable set to $this->get('subscription_helper'):

61 lines | src/AppBundle/Controller/WebhookController.php
// ... lines 1 - 8
class WebhookController extends BaseController
{
// ... lines 11 - 13
public function stripeWebhookAction(Request $request)
{
// ... lines 16 - 25
$subscriptionHelper = $this->get('subscription_helper');
switch ($stripeEvent->type) {
// ... lines 28 - 36
}
// ... lines 38 - 39
}
// ... lines 41 - 60
}

Finally, call $subscriptionHelper->fullyCancelSubscription($subscription):

61 lines | src/AppBundle/Controller/WebhookController.php
// ... lines 1 - 8
class WebhookController extends BaseController
{
// ... lines 11 - 13
public function stripeWebhookAction(Request $request)
{
// ... lines 16 - 25
$subscriptionHelper = $this->get('subscription_helper');
switch ($stripeEvent->type) {
case 'customer.subscription.deleted':
$stripeSubscriptionId = $stripeEvent->data->object->id;
$subscription = $this->findSubscription($stripeSubscriptionId);
$subscriptionHelper->fullyCancelSubscription($subscription);
break;
default:
throw new \Exception('Unexpected webhook type form Stripe! '.$stripeEvent->type);
}
return new Response('Event Handled: '.$stripeEvent->type);
}
// ... lines 41 - 60
}

And that is it!

Yep, there's some setup to get the webhook controller started, but now we're in really good shape.

Of course... we have no way to test this... So, ya know, just make sure you do a really good job of coding and hope for the best! No, that's crazy!, I'll show you a few ways to test this next. But also, don't forget to configure your webhook URL in Stripe once you finally deploy this to beta and production. I have a webhook setup for each instance on KnpU.