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:
- Registrar planes: esto se hace una sola vez (p.ej. Básico: S/ 10 x mes, Premium: S/ 20 x mes).
- Crear una tarjeta asociada a tu cliente (ver producto One-click).
- Crear una suscripción: tus clientes seleccionan un plan y se suscriben.
- 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.
| Producto | Descripción |
|---|---|
| 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:
Cómo se crea una suscripción para un cliente
El siguiente gráfico describe cómo generar una suscripción:
Proceso Batch
El siguiente gráfico describe cómo se procesan las suscripciones:
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 “amount: 0”:
<script>
const settings = {
title: "Culqi store 2",
currency: "PEN",
amount: 8000
};
const config = {
settings
// ...
};
const Culqi = new CulqiCheckout(publicKey, config);
</script>Cuando esté en dicha modalidad, el checkout se verá de la siguiente manera:
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.
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:
- Generar un cliente
- Generar una tarjeta
- 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.