Subscribe to Stripe events using Azure Event Grid (preview)

This article describes steps to subscribe to events published by Stripe, the financial infrastructure platform for businesses.

Prerequisites

Following are the prerequisites that your system needs to meet before attempting to configure your Stripe account to send events to Azure Event Grid.

• An Azure subscription to use Azure Event Grid.
• A Stripe account with access to the Stripe Dashboard and permissions to configure event destinations.

High-level steps

1. Register the Event Grid resource provider with your Azure subscription.
2. Authorize Stripe to create a partner topic in your resource group.
3. Enable Stripe events to flow to a partner topic.
4. Activate the partner topic so that your events start flowing.
5. Subscribe to events.

Register the Event Grid resource provider

Unless you've used Event Grid before, you need to register the Event Grid resource provider. If you've used Event Grid before, skip to the next section.

In the Azure portal, do the following steps:

1. On the left menu, select Subscriptions.

2. Select the subscription you want to use for Event Grid from the subscription list.

3. On the Subscription page, select Resource providers under Settings on the left menu.

4. Search for Microsoft.EventGrid, and confirm that the Status is Not Registered.

5. Select Microsoft.EventGrid in the provider list.

6. Select Register on the command bar.

   

7. Refresh to make sure the status of Microsoft.EventGrid is changed to Registered.

   

Authorize partner to create a partner topic

You must grant your consent to Stripe to create partner topics in a resource group that you designate. This authorization has an expiration time. It's effective for the time period you specify between 1 to 365 days.

1. Sign in to the Azure portal.

2. In the search bar at the top, enter Partner Configurations, and select Event Grid Partner Configurations under Services in the results.

3. On the Event Grid Partner Configurations page, select Create Event Grid partner configuration button on the page (or) select + Create on the command bar.

   

4. On the Create Partner Configuration page, do the following steps:

   1. In the Project Details section, select the Azure subscription and the resource group where you want to allow the partner to create a partner topic.

   2. In the Partner Authorizations section, specify a default expiration time for partner authorizations defined in this configuration.

   3. To provide your authorization for Stripe to create partner topics in the specified resource group, select + Partner Authorization link.

      

5. On the Add partner authorization to create resources page, you see a list of verified partners. A verified partner is a partner whose identity has been validated by Microsoft. Follow these steps to authorize Stripe to create a partner topic.

   1. Select Stripe from the list of verified partners.

   2. Specify authorization expiration time.

   3. Select Add.

      

      Important

      Your partner won't be able to create resources (partner topics) in your Azure subscription after the authorization expiration time.

6. Back on the Create Partner Configuration page, verify that Stripe is added to the partner authorization list at the bottom.

7. Select Review + create at the bottom of the page.

8. On the Review page, review all settings, and then select Create to create the partner configuration.

Enable Stripe events to flow to your partner topic

Follow these steps to configure Azure Event Grid as an event destination in your Stripe Dashboard:

1. Sign in to your Stripe Dashboard.
2. Navigate to Developers > Destinations.
3. Select + Add destination and choose Azure Event Grid as the destination type.
4. Enter the partner topic channel URL provided by Azure Event Grid.
5. Select the event types you want to send to Azure Event Grid, such as payment_intent.succeeded, invoice.paid, or customer.subscription.updated.
6. Save the destination configuration.

Once configured and active, Stripe creates a partner topic in your designated Azure resource group.

Activate a partner topic

1. In the search bar of the Azure portal, search for and select Event Grid Partner Topics.

2. On the Event Grid Partner Topics page, select the partner topic in the list.

   

3. Review the activated message, and select Activate on the page or on the command bar to activate the partner topic before the expiration time mentioned on the page.

   

4. Confirm that the activation status is set to Activated and then create event subscriptions for the partner topic by selecting + Event Subscription on the command bar.

   

Subscribe to events

First, create an event handler that handles events from Stripe. For example, create an event hub, Service Bus queue or topic, or an Azure function. Then, create an event subscription for the partner topic using the event handler you created.

Create an event handler

To test your partner topic, you need an event handler. Go to your Azure subscription and spin up a service that's supported as an event handler such as an Azure Function. For an example, see Event Grid Viewer sample that you can use as an event handler via webhooks.

Subscribe to the partner topic

Subscribing to the partner topic tells Event Grid where you want your Stripe events to be delivered.

1. In the Azure portal, type Event Grid Partner Topics in the search box, and select Event Grid Partner Topics.

2. On the Event Grid Partner Topics page, select the partner topic in the list.

   

3. On the Event Grid Partner Topic page for the partner topic, select + Event Subscription on the command bar.

   

4. On the Create Event Subscription page, do the following steps:

   1. Enter a name for the event subscription.

   2. For Filter to Event Types, select the Stripe event types that your subscription receives, such as payment_intent.succeeded, charge.failed, or customer.subscription.updated.

   3. For Endpoint Type, select an Azure service (Azure Function, Storage Queues, Event Hubs, Service Bus Queue, Service Bus Topic, Hybrid Connections, etc.), or webhook.

   4. Select the Configure an endpoint link. In this example, let's use Azure Event Hubs as the destination endpoint.

      

   5. On the Select Event Hub page, select configurations for the endpoint, and then select Confirm Selection.

      

   6. Now on the Create Event Subscription page, select Create.

      

Next steps

• Stripe partner topics overview
• Event handlers in Azure Event Grid
• Azure Event Grid partner topics overview