Suscribirse a eventos de Stripe mediante Azure Event Grid

En este artículo se describen los pasos para suscribirse a eventos publicados por Stripe, la plataforma de infraestructura financiera para empresas.

Prerrequisitos

A continuación se muestran los requisitos previos que el sistema debe cumplir antes de intentar configurar la cuenta de Stripe para enviar eventos a Azure Event Grid.

  • Una suscripción de Azure para usar Azure Event Grid.
  • Una cuenta de Stripe con acceso al panel de Stripe y permisos para configurar destinos de eventos.

Pasos a nivel macro

  1. Registre el proveedor de recursos de Event Grid con su suscripción de Azure.
  2. Autorice a Stripe crear un tema de socio en su grupo de recursos.
  3. Permita que los eventos de Stripe se redirijan a un tema de partner.
  4. Active el tema de partner para que los eventos empiecen a redirigirse ahí.
  5. Suscríbase a eventos.

Registro del proveedor de recursos de Event Grid

A menos que haya usado Event Grid antes, debe registrar el proveedor de recursos de Event Grid. Si ha usado Event Grid antes, vaya a la sección siguiente.

En Azure Portal, realice los siguientes pasos:

  1. En el menú de la izquierda, seleccione Suscripciones.

  2. Seleccione la suscripción que desea usar para Event Grid en la lista de suscripciones.

  3. En la página Suscripción, seleccione Proveedores de recursos en Configuración del menú izquierdo.

  4. Busque Microsoft.EventGrid y confirme que el estado es No registrado.

  5. Seleccione Microsoft.EventGrid en la lista de proveedores.

  6. Seleccione Registrar en la barra de comandos.

    Captura de pantalla del registro del proveedor Microsoft.EventGrid con la suscripción de Azure.

  7. Actualice para asegurarse de que el estado de Microsoft.EventGrid se cambia a Registrado.

    Captura de pantalla del registro correcto del proveedor Microsoft.EventGrid con la suscripción de Azure.

Autorizar al partner para crear un tema de partner

Debe conceder su consentimiento a Stripe para crear temas de asociados en un grupo de recursos que designe. Esta autorización tiene un tiempo de expiración. Es efectivo para el período de tiempo que especifique entre 1 y 365 días.

Importante

Para un mayor nivel de seguridad, especifique el tiempo mínimo de expiración que ofrezca al asistente suficiente tiempo para configurar la transmisión de los eventos a Event Grid y provisionar el tema del asistente. El asociado no podrá crear recursos (temas de asociados) en su suscripción de Azure después de la fecha de expiración de la autorización.

Nota:

Event Grid comenzó a aplicar comprobaciones de autorización para crear temas de asociados alrededor del 30 de junio de 2022.

  1. Inicie sesión en Azure Portal.

  2. En la barra de búsqueda de la parte superior, escriba Configuraciones de asociados y seleccione Configuraciones de asociados de Event Grid en Servicios en los resultados.

  3. En la página Event Grid Partner Configurations (Configuraciones de asociados de Event Grid), seleccione el botón Create Event Grid partner configuration (Crear configuración de asociado de Event Grid) en la página (o) seleccione + Crear en la barra de comandos.

    Captura de pantalla de la página Configuraciones de asociados de Event Grid con la lista de configuraciones de asociados y el vínculo para crear un registro de asociado.

  4. En la página Create Partner Configuration (Crear configuración de asociado), siga estos pasos:

    1. En la sección Detalles del proyecto, seleccione la suscripción de Azure y el grupo de recursos en el que quiere permitir que el asociado cree un tema de asociado.

    2. En la sección Partner Authorizations (Autorizaciones de asociado), especifique una hora de expiración predeterminada para las autorizaciones de asociados definidas en esta configuración.

    3. Para proporcionar la autorización de Stripe para crear temas de asociados en el grupo de recursos especificado, seleccione el vínculo + Autorización de asociado .

      Captura de pantalla de la página Crear configuración de socio con el enlace 'Autorización de socio' seleccionado.

  5. En la página Add partner authorization to create resources (Agregar autorización de asociado para crear recursos), verá una lista de asociados comprobados. Un asociado comprobado es un asociado cuya identidad ha sido validada por Microsoft. Siga estos pasos para autorizar a Stripe a crear un tema de asociado.

    1. Seleccione Stripe en la lista de asociados comprobados.

    2. Especifique la hora de expiración de la autorización.

    3. Selecciona Agregar.

      Captura de pantalla de la página que permite conceder a un asociado comprobado la autorización para crear recursos en el grupo de recursos.

      Importante

      El asociado no podrá crear recursos (temas de asociados) en su suscripción de Azure después de la fecha de expiración de la autorización.

  6. De nuevo en la página Crear configuración de socio, compruebe que Stripe esté agregado a la lista de autorizaciones del socio en la parte inferior.

  7. En la parte inferior de la página, seleccione Revisar y crear.

  8. En la página Revisar , revise todas las opciones y, a continuación, seleccione Crear para crear la configuración del asociado.

Permita que los eventos de Stripe se redirijan al tema de partner

Siga estos pasos para configurar Azure Event Grid como destino de eventos en el panel de Stripe:

  1. Inicie sesión en el panel de Stripe.
  2. Vaya a Destinos de desarrolladores>.
  3. Seleccione + Agregar destino y elija Azure Event Grid como tipo de destino.
  4. Escriba la dirección URL del canal de temas del socio proporcionada por Azure Event Grid.
  5. Seleccione los tipos de eventos que desea enviar a Azure Event Grid, como payment_intent.succeeded, invoice.paido customer.subscription.updated.
  6. Guarde la configuración de destino.

Una vez configurado y activo, Stripe crea un tema de partner en el grupo de recursos de Azure específico.

Activación de un tema de partner

  1. En la barra de búsqueda de Azure Portal, busque y seleccione Temas de asociado de Event Grid.

  2. En la página Temas de asociado de Event Grid, seleccione el tema del asociado en la lista.

    Captura de pantalla de la selección de un tema de asociado en la página Temas de asociados de Event Grid.

  3. Revise el mensaje activado y seleccione Activar en la página o en la barra de comandos para activar el tema del asociado antes de la hora de expiración mencionada en la página.

    Captura de pantalla de la selección del botón Activar en la barra de comandos o en la página.

  4. Confirme que el estado de activación está establecido en Activado y, a continuación, cree suscripciones de eventos para el tema del asociado; para ello, seleccione + Suscripción de eventos en la barra de comandos.

    Captura de pantalla del estado de activación de un tema de partner con la opción Activado.

Suscripción a los eventos

En primer lugar, cree un controlador de eventos que controle eventos de Stripe. Por ejemplo, cree un centro de eventos, una cola o tema de Service Bus o una función de Azure. A continuación, cree una suscripción de eventos para el tema del asociado mediante el controlador de eventos que ha creado.

Creación de un controlador de eventos

Se necesita un identificador de evento para probar un tema de partner. Diríjase a su suscripción a Azure y arranque un servicio que sea compatible como controlador de eventos, como una Azure Function. Para obtener un ejemplo, consulte el ejemplo de Event Grid Viewer que puede usar como controlador de eventos a través de webhooks.

Suscripción al tema del asociado

La suscripción al tema del socio indica a Event Grid dónde desea que se entreguen los eventos de Stripe.

  1. En Azure Portal, escriba Temas de asociado de Event Grid en el cuadro de búsqueda y seleccione Temas de asociado de Event Grid.

  2. En la página Temas de asociado de Event Grid, seleccione el tema del asociado en la lista.

    Captura de pantalla de la selección de un tema de asociado en la página Temas de asociados de Event Grid.

  3. En la página Tema de partner de Event Grid del tema de partner, seleccione + Suscripción de eventos en la barra de comandos.

    Captura de pantalla donde se selecciona el botón Añadir suscripción de evento en la página Tema de partner de Event Grid.

  4. En la página Crear suscripción de eventos, realice los siguientes pasos:

    1. Escriba un nombre para la suscripción a eventos.

    2. En Filtrar a tipos de eventos, seleccione los tipos de eventos Stripe que recibe la suscripción, como payment_intent.succeeded, charge.failedo customer.subscription.updated.

    3. En Tipo de punto de conexión, seleccione un servicio de Azure (Azure Functions, colas de Storage, Event Hubs, cola de Service Bus, tema de Service Bus, Conexiones híbridas, etc.) o webhook.

    4. Seleccione el vínculo Configurar un punto de conexión. En este ejemplo, vamos a usar Azure Event Hubs como punto de conexión de destino.

      Captura de pantalla de la configuración de un punto de conexión para una suscripción de eventos.

    5. En la página Seleccionar centro de eventos, seleccione configuraciones para el punto de conexión y, a continuación, seleccione Confirmar selección.

      Captura de pantalla de la configuración de un punto de conexión de Event Hubs.

    6. De nuevo en la página Crear suscripción de eventos, seleccione Crear.

      Captura de pantalla de la página Crear suscripción a eventos con configuraciones de ejemplo.

Pasos siguientes

  • Last updated on