Webhooks

Reveniu le permite recibir notificaciones autom谩ticas cuando se ha producido un evento asociado a su cuenta.

Eventos disponibles

A continuaci贸n lista de notificaciones disponibles en los siguientes eventos:

  • Suscripci贸n activada (subscription_activated)

  • Renovaci贸n cancelada (subscription_renewal_cancelled)

  • Suscripci贸n desactivada (subscription_deactivated)

  • Pago realizado ( subscription_payment_succeeded)

Suscripci贸n activada

subscription_activated

Evento gatillado cuando una suscripci贸n es exitosamente completada por el usuario (registrando un medio de pago recurrente). Puedes usarlo para habilitar la funcionalidad para ese usuario, enviar los productos o gatillar un correo de bienvenida. Se har谩 una petici贸n POST al url definido por ti en tu panel de administraci贸n de API

Recuerda en tus webhooks validar que el header Reveniu-Secret-Key corresponda a tu secreto. As铆 evitas que otros que no seamos nosotros inyecten maliciosamente informaci贸n en tu sistema.

Cuerpo del webhook:

[POST]
{
"event": "subscription_activated",
"data": {
"subscription_id":1482
}
}

Renovaci贸n cancelada

subscription_renewal_cancelled

Evento gatillado cuando un usuario o admin cancela la renovaci贸n de una suscripci贸n expl铆citamente. Nota que la suscripci贸n puede seguir activa hasta su fecha de expiraci贸n (ej: el usuario pag贸 un plan anual, pero despu茅s de 6 meses decide cancelar la renovaci贸n)

El evento incluye campos que indican las razones del usuario para cancelar la renovaci贸n. Se har谩 una petici贸n POST al url definido por ti en tu panel de administraci贸n de API

Recuerda en tus webhooks validar que el header Reveniu-Secret-Key corresponda a tu secreto. As铆 evitas que otros que no seamos nosotros inyecten maliciosamente informaci贸n en tu sistema.

Cuerpo del webhook:

[POST]
{
"event": "subscription_renewal_cancelled",
"data": {
"subscription_id": 123,
"cancelled_by": "user", // podr铆a ser "admin"
"cancel_reason": "too_expensive",
"feedback": "Pens茅 que el precio era anual pero ahora vi que era un pago mensual y na que ver poh"
...
}
}

Suscripci贸n desactivada

subscription_deactivated

Evento gatillado cuando una suscripci贸n deja de estar activa. Esto puede ocurrir por distintos motivos:

  • El usuario abandon贸 la suscripci贸n sin cancelarla explicitamente. El abandono ocurre cuando un medio de pago falla y el usuario despu茅s de repetidos avisos no ingresa un nuevo medio de pago.

  • Tambi茅n ocurre cuando un usuario ha cancelado explicitamente la renovaci贸n de la suscripci贸n y el per铆odo de la suscripci贸n ya ha concluido.

  • Y tambi茅n puede haber sido cancelada explicitamente por el comercio en su panel de gesti贸n y tambi茅n ha culminado el per铆odo de la suscripci贸n previamente pagado.

A煤n as铆 es posible revivir la suscripci贸n si desde el comercio incentivas al usuario a ingresar un nuevo medio de pago a trav茅s de la URL indicada en reactivate_url. Se har谩 una petici贸n POST al url definido por ti en tu panel de administraci贸n de API

Recuerda en tus webhooks validar que el header Reveniu-Secret-Key corresponda a tu secreto. As铆 evitas que otros que no seamos nosotros inyecten maliciosamente informaci贸n en tu sistema.

Cuerpo del webhook:

[POST]
{
"event": "subscription_deactivated",
"data": {
"subscription_id": 11530
}
}

Pago realizado

Webhook: subscription_payment_succeeded

Evento gatillado cuando se realiza autom谩ticamente el cobro recurrente de una suscripci贸n. Puedes usarlo para marcar que el usuario est谩 al d铆a en sus pagos. Se har谩 una petici贸n POST al url definido por ti en tu panel de administraci贸n de API

Recuerda en tus webhooks validar que el header Reveniu-Secret-Key corresponda a tu secreto. As铆 evitas que otros que no seamos nosotros inyecten maliciosamente informaci贸n en tu sistema.

Cuerpo del webhook:

[POST]
{
"event": "subscription_payment_succeeded",
"data": {
"subscription_id":1482,
"buy_order":202012121212,
"issued_on":"23/Feb/2021 16:53:21",
"gateway_response":0
}
}

Pago rechazado

Webhook: subscription_payment_in_recovery

Evento gatillado cuando un cobro falla pero Reveniu est谩 recuperando autom谩ticamente el problema. Te recomendamos no suspender el servicio durante el per铆odo de recuperaci贸n. En la mayor铆a de los casos, nuestro motor de reintentos o la recaptura de un medio de pago resuelve el problema.

En caso que el problema no se resuelva, el webhook subscription_abandoned_by_user ser谩 gatillado. Se har谩 una petici贸n POST al url definido por ti en tu panel de administraci贸n de API

Cuerpo del webhook:

[POST]
{
"event": "subscription_payment_in_recovery",
"data": {
"subscription_id":1482,
"buy_order":202012121212,
"issued_on":"23/Feb/2021 16:53:21",
"gateway_response":-1|-2|-3|-96
}
}