Setup a local events listener

Events are our way of letting you know when something interesting happens in your account. When an event occurs, we create a new Event object. The steps on this page describe how to setup a webhooks listener on your local machine.

Add a local listener

Use the following steps to listen for events sent to the webhook endpoint on your local server. By default, the code sample on the local listener setup page parses the payment_intent.succeeded event object payload, and returns a 200 response.

1. Open the Webhooks page.
2. Click Add local listener.
3. Select your programming language (top right) on the Listen to Stripe events setup page.
4. Copy the sample code locally, then follow the steps on the setup page.
5. Open the Received events tab to see the events received.

Find local listener events

Use these steps to find the event object payloads.

1. Open the Events page, then select an event.
2. Select a device name in Webhook CLI responses.