Suscripciones

Cobra periodicamente a tus clientes a través de planes de cobro.

Suscripciones es una modalidad de pago que permite definir planes de cobro a los que tus clientes pueden suscribirse registrando la información de su tarjeta. Este modelo es ideal para empresas que requieren cobrarle a sus clientes regularmente.

¿Cómo funciona?

Esta modalidad cuenta con varias etapas:

  1. Registrar planes: esto se hace una sola vez (p.ej. Básico: S/ 10 x mes, Premium: S/ 20 x mes).
  2. Crear una tarjeta asociada a tu cliente (ver producto One-click).
  3. Crear una suscripción: tus clientes seleccionan un plan y se suscriben.
  4. Repetir los pasos 2 y 3 por cada cliente nuevo que se quiera registrar.

Todos los días Culqi procesa las suscripciones registradas para ese día y notifica de los cobros a los comercios a través de un webhook.

Una suscripción solo tiene dos estados durante su ciclo de vida. Cuando recién se ha creado posee un estado de ‘active’ (activada), y cuando es cancelada posee un estado de ‘canceled’ (canceled). La cancelación puede haberse dado manualmente, por la API o automáticamente cuando sobrepasa los intentos de cargo fallidos consecutivos.

IMPORTANTE: Una suscripción tiene un número de intentos de cobro, pasado este límite la suscripción se cancelará en automático. En caso esto suceda, el cliente deben volver a crear una suscripción con un medio de pago válido.

Herramientas

En cada etapa puedes usar los diferentes productos Culqi, dependiendo del nivel de personalización deseado.

Culqi Checkout Abstrae la captura de tarjeta pero tú tienes que codear la integración del backend
usando nuestras librerías o a mano.
Culqi API Cuando quieres el control total de la interfaz y el backend. Integra directamente
los endpoints del API a tu gusto.

Cómo se crean los planes

El siguiente gráfico describe flujo para generar un plan. Por lo general este proceso se ejecuta una única vez a menos que se quiera crear nuevos planes o actualizar los que ya existen:

Flujo de transaccion

Cómo se crea una suscripción para un cliente

El siguiente gráfico describe cómo generar una suscripción:

Flujo de transaccion

Proceso Batch

El siguiente gráfico describe cómo se procesan las suscripciones:

Flujo de transaccion

Integraciones

En cada etapa del flujo de integración tenemos una herramienta que puede ayudarte a reducir el tiempo de desarrollo.

Recuerda que para usar cualquiera de estos métodos necesitas tener tu llave pública (test o live) de integración.

Frontend del comercio

En el frontend tenemos diferentes mecanismos de integración que puedes utilizar:

  • Culqi Checkout - integración low code
  • Culqi API - integración full code

Culqi Checkout

Utiliza el Culqi Checkout para generar el token de la tarjeta.

Para utilizar el checkout solo como capturador de información de tarjeta debes poner “monto:0”:

<script>
  Culqi.settings({
    title: 'Culqi',
    currency: 'PEN',
    amount: 1000
  });
</script>

Cuando esté en dicha modalidad, el checkout se verá de la siguiente manera:

Culqi Checkout

Recuerda que el checkout cumple con la normativa PCI DSS 3.2, dado que la información de tarjeta nunca toca tu servidor.

En caso quieras utilizar este mecanismo de integración, sigue las instrucciones aquí.

Usando APIs

Para tener control total sobre tu integración, utiliza la API para generación de suscripciones y sigue el flujo del diagrama antes mostrado.

Recuerda que cuando interactúas directamente con el API de token necesitas cumplir la normativa de PCI DSS 3.2. Por ello te pedimos que llenes el formulario SAQ-D y envies al buzón de riesgos Culqi.

Backend del comercio

Una vez que el cliente haya seleccionado un plan y registrado los datos de su tarjeta, envía el token hacia el backend. Luego deberás:

  1. Generar un cliente
  2. Generar una tarjeta
  3. Generar una suscripción en base al plan que el cliente seleccionó

Usando Librerías

Culqi tiene una serie de librerías (PHP, Ruby, Python,Java, .Net etc) que te sirven para agilizar tu integración. Agrégalas a tu paquetería y úsalas para abstraer la conexión a nuestra API.

Usando API

En caso deseas integrarte directamente a nuestras APIs para tener control total de tu integración backend, puedes hacer uso de nuestra variedad de servicios Rest.