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:
1
[POST]
2
{
3
"event": "subscription_activated",
4
"data": {
5
"subscription_id":1482
6
}
7
}
Copied!

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:
1
[POST]
2
{
3
"event": "subscription_renewal_cancelled",
4
"data": {
5
"subscription_id": 123,
6
"cancelled_by": "user", // podría ser "admin"
7
"cancel_reason": "too_expensive",
8
"feedback": "Pensé que el precio era anual pero ahora vi que era un pago mensual y na que ver poh"
9
...
10
}
11
}
Copied!

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:
1
[POST]
2
{
3
"event": "subscription_deactivated",
4
"data": {
5
"subscription_id": 11530
6
}
7
}
Copied!

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:
1
[POST]
2
{
3
"event": "subscription_payment_succeeded",
4
"data": {
5
"subscription_id":1482,
6
"buy_order":202012121212,
7
"issued_on":"23/Feb/2021 16:53:21",
8
"gateway_response":0
9
}
10
}
Copied!

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:
1
[POST]
2
{
3
"event": "subscription_payment_in_recovery",
4
"data": {
5
"subscription_id":1482,
6
"buy_order":202012121212,
7
"issued_on":"23/Feb/2021 16:53:21",
8
"gateway_response":-1|-2|-3|-96
9
}
10
}
Copied!
Last modified 3mo ago