Este proceso requiere conocimientos técnicos avanzados, en particular la modificación del código del Tema de tu tienda. Si necesitas ayuda podemos ponerte en contacto con una agencia especialista en la instalación y habilitación de este servicio, sólo escríbenos al chat de soporte y te ayudaremos.
¿Cómo funcionan las suscripciones en Shopify?
La suscripciones de VentiPay te permiten generar ventas recurrentes y automáticas completamente integradas en Shopify.
Al momento de agregar un producto al carrito, tus clientes podrán elegir una frecuencia de compra y tú, automáticamente, recibirás las ordenes en Shopify en la frecuencia que el cliente haya elegido con todo lo necesario para continuar con tu flujo de venta normal, tal como si el cliente hubiese realizado la compra de forma manual.
El flujo de compra completo es el siguiente:
El cliente, al agregar un producto al carrito, elige una frecuencia de compra. Elegir una frecuencia puede ser opcional o requerido según lo que definas en tu integración. Tus clientes podrán mezclar libremente productos con o sin frecuencia de compra en un mismo carrito.
El cliente, en el checkout, elige un proveedor de pago que puede ser VentiPay o uno distinto y procede a pagar el total de la orden.
El cliente, una vez que complete el proceso de pago, recibe un email desde VentiPay con un link para confirmar e iniciar su suscripción.
Una vez iniciada la suscripción, VentiPay intentará cobrar el total de la orden de forma automática en la frecuencia de compra que haya elegido el cliente.
Si el pago es exitoso, VentiPay creará automáticamente una orden en tu tienda con estado "Pagada" y lista para que despaches. De lo contrario, VentiPay reintentará el cobro la cantidad de días que hayas configurado en la sección Mi comercio > Suscripciones en el Dashboard.
Considera que la fecha del primer pago automático corresponde a la fecha de la compra más la duración de la frecuencia elegida por el cliente. Por ejemplo, si tu cliente elige una renovación mensual y la primera compra la realizó el 5 de Enero, el primer pago automático que intentará VentiPay será el 5 de Febrero, es decir, 1 mes después.
Para hacer uso de las suscripciones de VentiPay, es requisito que tengas habilitada la pasarela de pagos de VentiPay en el checkout de tu tienda.
Habilitación
Para habilitar las suscripciones en tu tienda necesitas seguir los siguientes pasos:
A continuación encontrarás el detalle de cada paso.
Creación de aplicación Custom o Personalizada
El primer paso es crear una aplicación de tipo Custom o Personalizada en tu tienda, la que nos entregará los accesos necesarios para hacer funcionar la integración.
Antes de crear la aplicación, debes asegurarte de tener activada la opción de desarrollo de aplicaciones personalizadas en Shopify. Esto es necesario hacerlo sólo una vez y es posible que ya la tengas activa; si es así, puedes avanzar al siguiente paso.
Para activar la opción de desarrollo de aplicaciones personalizadas debes seguir los siguientes pasos:
Ingresa a la página de administración de tu tienda en Shopify.
Ingresa a la sección Configuración > Aplicaciones y canales de venta.
Haz click en Desarrollar aplicaciones.
Haz click en Permitir desarrollo de aplicaciones personalizadas.
Lee la advertencia y la información provista y luego haz click en Permitir desarrollo de aplicaciones personalizadas.
Para crear la aplicación debes seguir los siguientes pasos:
Ingresa a la página de administración de tu tienda en Shopify.
Ingresa a la sección Configuración > Aplicaciones y canales de venta.
Haz click en Desarrollar aplicaciones.
Haz click en Crear una aplicación personalizada.
En la ventana modal, introduce VentiPay Suscripciones como nombre de la aplicacióny selecciona un desarrollador de aplicaciones. El desarrollador de la aplicación puede ser el propietario de la tienda o cualquier cuenta de empleado o colaborador con el permiso para desarrollar aplicaciones.
Haz click en Crear aplicación.
Una vez creada la aplicación, debes actualizar los alcances o permisos de la aplicación.
Haz click en Configuración.
En la sección Integración de la API del panel de control, haz click en Editar.
Haz click en Configurar y asigna los siguientes permisos: write_draft_orders, write_orders y read_customers.
Haz clic en Guardar.
Ahora debes crear y obtener las credenciales de la aplicación ingresando a la sección Credenciales de la API.
En la sección Tokens de acceso, haz click en Instalar aplicación.
En la ventana modal, confirma la instalación haciendo click en Instalar.
En la sección Token de acceso de la API del panel de control, haz click en Revelar el token una vez. Toma nota de este dato ya que Shopify sólo lo mostrará una vez.
El dato anterior es el Token de acceso o Access token de la aplicación y debes utilizarlo en el siguiente paso al configurar la integración en VentiPay.
Para configurar en VentiPay la aplicación recién creada debes seguir los siguientes pasos:
Ingresa al Dashboard de VentiPay.
Ingresa a la sección Ecommerce > Shopify.
Haz click en Conectar tienda y elige la opción Suscripciones
En el formulario introduce la URL de la tienda en formato Shopify (https://tienda.myshopify.com) y el Token de acceso creado en el paso anterior.
Haz click en Guardar.
Ahora, sigue las instrucciones indicadas en el Dashboard para agregar en Shopify los webhook requeridos para la integración: Pago de pedido y Creación de reembolso.
Habilitación del selector de frecuencias en el formulario de producto
Una vez creada la aplicación, es necesario modificar el Tema de tu tienda para que tus clientes puedan elegir una frecuencia de compra al momento de agregar un producto al carrito.
Para habilitar esta funcionalidad utilizaremos la característica Line Items Property de Shopify, la que nos permitirá indicarle al carrito la frecuencia de compra de cada producto.
Deberás elegir en qué productos mostrar el selector de frecuencia, qué frecuencias ofrecer y qué tipo de selector mostrar a tus clientes. Nuestra recomendación es que utilices tags para decidir dinámicamente qué productos deben presentar el selector de frecuencias y sus opciones.
Selector de frecuencias
El selector de frecuencias de compra recurrente, es un componente que debe ser agregado al formulario de producto del Tema de tu tienda y debe mostrar la o las frecuencias de compra que quieras ofrecer a tus clientes.
Este selector puede ser un Select (<select>), Radio (<input type="radio">), Checkbox (<input type="checkbox">) o cualquier otro elemento que sea parte del formulario (<form>) del producto. La ubicación de este formulario depende de cada Tema, pero usualmente lo encuentras en el archivo product-form.liquid y es el formulario que permite agregar un producto al carrito en la pantalla de detalle de cada producto.
Tienes libertad de diseñar la interfaz de usuario que prefieras, sin embargo es necesario que el elemento contenga el Line Item Property de frecuencia de compra.
La propiedad de Line Item Property del selector debe tener el nombre Frecuencia y su valor una de las siguientes opciones:
Diaria
Semanal
Cada 2 semanas
Mensual
Cada 3 meses
Cada 6 meses
Anual
Ejemplo:
<select name="properties[Frecuencia]">
<option value="Semanal">Recibe cada semana</option>
<option value="Mensual">Recibe todos los meses</option>
</select>
En el ejemplo anterior puedes utilizar el texto que quieras al interior de cada <option>, pero el valor definido en value debe ser exactamente igual a los nombres de la lista anterior. Lo mismo aplica para otro tipo de selectores, lo importante es que utilices correctamente el Line Item Property con el valor name="properties[Frecuencia]" y un value con un valor de la lista.
Despliegue del selector en el formulario de producto
Debes implementar el cuándo mostrar el selector de frecuencias si así lo requieres. Es posible que no quieras presentar esta opción en todos tus productos o que quieras deshabilitarlo temporalmente, por ejemplo, por quiebre de stock u otros motivos.
Nuestra recomendación es que utilices tags para decidir de manera dinámica si presentar el selector o no.
Por ejemplo, puedes agregar un tag al producto que indique si el selector debe presentarse o no, y luego, en el código del formulario de producto, crear una condición que muestre el selector si es que el tag está presente.
Ejemplo:
{% assign productTags = product.tags | join: '|' %}
{% if productTags contains 'ventipay:recurrent:1month' %}
<p class="line-item-property__field">
<label>¿Quieres suscribirte?</label>
<br>
<select name="properties[Frecuencia]">
<option selected value="">No, solo quiero comprar esta vez</option>
<option value="Mensual">Recibir todos los meses</option>
</select>
</p>
{% endif %}
En el ejemplo anterior, el tag definido en el producto es ventipay:recurrent:1month, pero puedes utilizar el tag que tu quieras.
Este código debes agregarlo al formulario de producto. La ubicación de este depende de cada Tema pero usualmente está en el archivo product-form.liquid o uno similar.