Lista completa de eventos de webhook
Si gestionas tú mismo la automatización, puedes hacerlo mediante programación o con herramientas como Zapier. En los ajustes del producto, añade la URL del webhook en la pestaña de integraciones y webhooks. Tras la compra, ahí se enviará la información de la transacción. Puedes generar el webhook con Zapier o con Make (antes Integromat).
Los principales eventos por los que filtramos están marcados con su clave de evento y son los siguientes:
- single_product_bought - compra de un producto individual
- product_assigned - el producto individual se asignó correctamente a un usuario
- product_access_expiring - el acceso al producto individual está a punto de caducar
- product_access_expired - el acceso al producto individual ha caducado
- subscription_created - compra de una nueva suscripción
- subscription_plan_changed - cambio de plan desde el panel de Easycart
- subscription_canceled - cancelación de la suscripción en el panel de Easycart (seguirá activa hasta el final del periodo de facturación)
- subscription_expired - vencimiento definitivo de la suscripción
- subscription_renewed - renovación de la suscripción
- subscription_renewal_failed - intento fallido de cobro para la renovación
- subscription_renewal_upcoming - próxima renovación
- subscription_resumed - la suscripción se renovó correctamente
- subscription_deleted - la suscripción se eliminó de forma permanente
- customer_data_changed - cambio en los datos del cliente
Todos los casos y las respuestas de los webhooks se detallan a continuación:
Webhook tras la compra de un producto individual
Webhook tras la asignación correcta del producto
Webhook cuando el acceso al producto individual está a punto de caducar
Webhook tras la caducidad del acceso al producto individual
Webhook tras la compra correcta de una suscripción
Este evento se envía tras la compra de una suscripción. En este punto, se debería conceder el acceso al producto. Importante: la suscripción puede activarse en modo de prueba. En ese caso, la propiedad trial_ends_at indicará la fecha de finalización. Si no, su valor será null.
Webhook al hacer clic en Switch to this plan (cambiar a este plan) en el panel de suscripción
El cliente tiene la opción de cambiar a otro plan (si se ha definido alguno) desde el panel de Easycart. El nombre del plan que se envía al webhook procede de aquí:
- La propiedad subscription_plan_name indica a qué plan cambió el usuario
- La propiedad subscription_plan_price indica el precio actual.
Webhook cuando el usuario hace clic en Cancel (cancelar) en el panel de suscripción
La propiedad subscription_current_period_end indica la fecha en la que el plan debería desactivarse (y, por tanto, revocarse el acceso al producto).
Webhook tras el vencimiento de la suscripción
Evento que se envía cuando la suscripción pasa a estar inactiva por cancelación del cliente, cancelación manual en el panel de Stripe, o porque el cobro ha fallado un número determinado de veces. En este momento se debería desactivar el acceso al producto.
Webhook tras cobrar correctamente el siguiente periodo de facturación
Tras cobrar la cuota del periodo de facturación, se envía un evento con los siguientes datos.
- La propiedad amount_paid es el importe cobrado - este es el importe por el que se debería emitir la factura
- Los datos de la factura están en la propiedad invoice_data (que puede ser null si no está disponible)
Webhook por intento fallido de cobro del siguiente periodo de facturación
En caso de que falle el intento de cobro del periodo de facturación. La propiedad error_message contiene información sobre el error.
Webhook X días antes del siguiente cobro
Estos datos se envían al webhook X días antes del siguiente cobro. La propiedad subscription_renews_at indica la fecha en la que se producirá el siguiente cobro.
El webhook se envía en función del evento invoice.upcoming de Stripe.
Webhook X días antes de que termine la prueba
Este webhook es idéntico al anterior, pero si la propiedad trial_ends_at no es null, significa que será el primer cobro. En Stripe puedes configurar con cuántos días de antelación al primer cobro se debe enviar una notificación al cliente. Para hacerlo:
- Ve a los ajustes de Stripe
- En la sección Prevent failed payments (evitar pagos fallidos), selecciona el número de días adecuado
