Setting up webhooks

In order for the Stripe extension and Stripe’s systems to work together correctly, they must be able to “talk” back and forth. Our Stripe extension communicates to Stripe via their API, but Stripe communicates to the Stripe extension via webhooks.

This document covers how to ensure that your live mode and test mode webhooks are configured correctly.

Since version 8.6.1 of the Stripe extension, webhooks are automatically set up when you connect to Stripe. Thus, there is no need to configure webhooks separately.

If you are upgrading to 8.6.1 or later from an older version of the Stripe extension, you can reconfigure the webhooks as detailed below.

You can verify that your webhooks are working like so:

1. Navigate to WooCommerce > Settings > Payments > Stripe > Settings.
2. In the Account details section, click the Configure connection button.
3. Verify in the Live tab that the webhook status says “Configured.”
4. Also verify in the Test tab that the test webhook status is “Configured.”

If the statuses are both correct, then your webhooks are working.

You can also verify that the webhooks are being processed successfully in the Account details section.

If the webhooks are ever accidentally deleted from the Stripe dashboard, or if you’re upgrading to version 8.6.1 or later from an older version, you can recreate them like so:

1. Navigate to WooCommerce > Settings > Payments > Stripe > Settings.
2. In the Account details section, click the Configure connection button.
3. In the Live tab, click Reconfigure webhooks.
4. In the Test tab, click Reconfigure webhooks.

This will recreate the correct webhooks in your Stripe account and remove any old ones that were pointing to your site.