stripe-express doc logo
Launch Stripe Express

Setting up Stripe WebHook

Webhook setting is required to make sure some features work.


What is a webhook?

Webhooks allow Stripe to send messages to your website when certain “events” take place. For example, if a payment is refunded in Stripe, Stripe can automatically send a notification to your webhook to let it know.

Stripe uses webhooks to notify your application when an event happens in your account. Webhooks are particularly useful for asynchronous events like when a customer’s bank confirms a payment, a customer disputes a charge, or a recurring payment succeeds. Learn more about stripe webhooks.

Which features require webhooks?

  • Checkout Form
  • Digital Payment (WeChat, Alipay, Apple Pay, Google Pay ...)

How to setup webhook?

  1. Click Developer -> WebHooks, click Add endpoint button.
wp stripe express add endpoint
  1. To get the endpoint Url, we need to go back in Stripe Express Setting tab, and you should see a field Stripe WebHook, copy the url or click the copy icon.
wp stripe express get webhook url
  1. Back to stripe end point dialog, paste the endpoint url.
  2. In Version, Select your current API version, In the events to send, type Payment Intent to select all related events, also type Source to select source events, then save it.
wp stripe express choose events

Enable Webhook signatures (Optional)

generating a signature for webhook can protect your endpoint to be abused from outside very much.

Generate signature: generate signature
generate signature

Copy the value to webhook signature in stripe express setting:

wp stripe express using signature