Confirming successful Stripe Checkout payments in Laravel

Your guide is https://stripe.com/docs/webhooks

So webhooks just take in the "success" from the Stripe end, what you do with it or need to do with it is up to you.

.......

You need to setup a webhook on a Laravel endpoint that's publicly accessible, then go to Stripe and set the Webhook URL for your user to that URL.

Next look at the package, follow the steps to install and this part is important...

Route::stripeWebhooks('webhook-route-configured-at-the-stripe-dashboard');

Finally, take care of the routing: At the Stripe dashboard you must configure at what url Stripe webhooks should hit your app. In the routes file of your app you must pass that route to Route::stripeWebhooks

This you would update with the webhook url you put in Stripe as the webhook.

Then under the package's Usage it shows how to handle webhook requests using jobs or an event listener (also displayed in the package Usage area of the docs). You can specify 'events' to specific jobs.

You'll want to likely use the events checkout.session.completed or checkout.session.async_payment_succeeded (both taken from the Stripe API event types docs linked above) depending on what you are looking to do.

So assuming you want to use Listeners for the event checkout.session.completed you'd do this:

1. Create an event listener
2. Add the event -> listener relation in the Event Service Provider
3. Setup the webhook URL in your routes file.

• Update your EventServiceProvider and add this..

/**
 * The event listener mappings for the application.
 *
 * @var array
 */
protected $listen = [
    'stripe-webhooks::checkout.session.completed' => [
        App\Listeners\StripeCheckoutSessionCompleted::class,
    ],
];

• Create this app\Listeners\StripeCheckoutSessionCompleted.php with the following code:

<?php

namespace App\Listeners;

use Illuminate\Contracts\Queue\ShouldQueue;
use Spatie\WebhookClient\Models\WebhookCall;

class StripeCheckoutSessionCompleted implements ShouldQueue
{
    public function handle(WebhookCall $webhookCall)
    {
        // do your work here

        // you can access the payload of the webhook call with `$webhookCall->payload`
    }
}

Update the handle method with your logic..

We highly recommend that you make the event listener queueable, as this will minimize the response time of the webhook requests. This allows you to handle more Stripe webhook requests and avoid timeouts.

• Setup the webhook URL in your routes file

Route::stripeWebhooks('stripe-webhooks');

• Go to Stripe and update the webhook endpoint to be yourapp.com/stripe-webhooks

Now your done.

Yeah, I've got it all set up with the package you mentioned. The bit I'm not of sure is what to do in the handler. It seems like Stripe just carries on to the success page regardless of what I do in there.