Skip to main content

4Geeks Memberships

4Geeks Memberships es la herramienta que permite crear completos sistemas de cobros recurrentes, propios de modelos de negocio basado en suscripción con pagos periodicos, de forma simple y rápida, sin que tengas que preocuparte por programación adicional.

Esta herramienta fue creada pensando en plataformas SaaS, como Netflix, Uber o Slack, capaces de manipular y gestionar m√ļltiples clientes suscritos a sus planes, pero que a su vez cumplan con requerimientos de seguridad m√≠nimos.

info

Para crear planes de cobro recurrente deber√°s ser un comercio activado. No existe un ambiente sandbox para 4Geeks Memberships en este momento.

Mediante la Consola podr√°s manipular la creaci√≥n y gesti√≥n completa de los planes, asi como visualizar los suscriptores de cada plan, y su estado en el ciclo de facturaci√≥n. Corre por responsabilidad de 4Geeks el hacer el cargo a la tarjeta seg√ļn el ciclo de recurrencia configurado para el plan.

No existe límite en cuanto a la cantidad de planes que quieras crear, o inclusive los usuarios suscritos a cada plan.

note

Un Plan representa el tipo de servicio al que un cliente puede suscribirse, y engloba una cantidad definida de características. Una Suscripción se inicia cuando un nuevo suscriptor se enrola en un plan. Cuando un usuario se suscribe a un plan, pasa a ser un Suscriptor.

Crear un plan‚Äč

tip

Puedes ingresar un periodo de prueba en la creación de un plan, para indicar a la plataforma los días en que un usuario puede estar suscrito a un plan sin pagar. Al completarse esos días, entonces empieza a correr el ciclo normal de facturación para ese suscriptor.

Para crear un plan debes:

  • Hacer click en Planes, del men√ļ principal en Console.
  • Llenar los campos para configurar el plan.
  • Al terminar, debes hacer click sobre el bot√≥n azul Crear Plan.

Cada plan creado tendr√° un URL de suscripci√≥n y una URL de desuscripci√≥n √ļnicos, que deber√°s usar para suscribir usuarios a ese plan, siguiendo el formato /m/<planid>/suscribe y /m/<planid>/unsuscribe respectivamente.

Crear plan

Borrar un plan‚Äč

warning

Al borrar un plan, también cancelas todas las suscripciones activas en ese plan en concreto.

Para borrar un plan debes:

  • Buscar y seleccionar el plan que quieres eliminar, ubicado en Planes.
  • Hacer click sobre el bot√≥n rojo Eliminar Plan.
  • Debes escribir el nombre del plan en la ventana de confirmaci√≥n, y presionar el bot√≥n azul Confirmar.

Borrar plan

Suscribir un usuario‚Äč

El proceso de suscripción de un usuario a un plan debe ser completado por el mismo usuario, a través de un formulario generado automáticamente por 4Geeks para cada futuro suscriptor. Este formulario recopila información del usuario y de la tarjeta con que se realizará la suscripción.

Entonces para suscribir un nuevo usuario a un plan, debes dirigirlo a la URL de suscripci√≥n mediante un bot√≥n o link, y al mismo tiempo enviar por POST el nombre y correo electr√≥nico del usuario. 4Geeks construir√° una nueva versi√≥n de la URL encriptada y √ļnica para esa transacci√≥n.

Ejemplo de los datos que debes enviar en el body de la solicitud:

{
'name': 'Nombre Apellido',
'email': 'nombre.apellido@email.com'
}

Si la suscripción de logra concretar, entonces 4Geeks enviará un aviso mediante webhook al destino registrado. Podrás consultar todos los suscriptores de un plan desde la Consola, ingresando al plan en específico.

warning

Si no envías la información requerida de un usuario, entonces no podremos construir un formulario de pago, y el proceso se interrumpe de inmediato.

tip

Por cada suscripción completada correctamente, 4Geeks enviará un email al suscriptor y al comercio.

Desuscribir un usuario‚Äč

El proceso para desuscribir un usuario es igual al proceso de suscribir, pero en esta ocasión debes usar la URL de desuscripción de un plan. Del mismo modo, al confirmarse una desuscripción, 4Geeks enviará un aviso mediante webhook al destino registrado.

Webhook‚Äč

Usamos webhooks para alertar sobre el estado de una suscripción. Entonces, te enviaremos una solicitud, mediante POST, a la url que nos indiques, cada vez que alguien se suscribe o se desuscribe de un plan, con el fin que tu sistema pueda manejar cualquier escenario.

Este es un ejemplo del JSON que enviaremos, y que tu plataforma debe ser capaz de escuchar:

{
'name': 'Nombre Apellido',
'email': 'nombre.apellido@email.com',
'planId:' 'HIeRt537jO897a',
'planName': 'Plan Premium Golden',
'datetime:' '05/04/22 11:57:00',
'suscribe': 'true'
}
note

datetime está en formato UTC y representa el momento en que se registró el evento.