Usa esta guía para conectar tu tienda Shopify con Recurrente, mostrar el formulario de entrega en el carrito y confirmar que una compra pagada se registre como una orden en Shopify.
Nota: Las capturas corresponden a las versiones web de Shopify y Recurrente. Shopify puede mostrar algunos nombres en inglés aunque el resto de tu administración esté en español.
Antes de empezar
Para conectar Shopify con Recurrente necesitas acceso de administrador a la tienda y una cuenta de Recurrente que muestre la opción Conectar Shopify.
Tu tienda debe usar el plan Shopify Grow o uno superior. Shopify Basic y Starter no permiten acceder a las apps personalizadas con información de identificación personal (PII) de nivel 2 que esta integración necesita. Puedes revisar este requisito en Acerca de las aplicaciones de Shopify.
La moneda de la tienda debe ser quetzales (GTQ) o dólares estadounidenses (USD).
Debes ser propietario de la tienda o tener el permiso App development → Develop para crear e instalar una app desde el Dev Dashboard de Shopify.
Debes tener acceso a Configuración → Llaves API en Recurrente.
El proceso genera un Client ID y un Client Secret. Ingresa esas credenciales únicamente en el formulario seguro de Recurrente; no las envíes por correo ni por chat.
Si la tarjeta Shopify no aparece en Recurrente, contacta a soporte antes de continuar.
Paso 1: crea una app para tu tienda en Shopify
La app de Shopify permite que Recurrente consulte los productos, registre las órdenes pagadas y actualice el inventario de tu tienda.
Entra a dev.shopify.com con la cuenta que administra tu tienda, abre Apps y selecciona Create app. Debes ver las opciones para crear una app.
Selecciona Start from Dev Dashboard, escribe Recurrente como nombre y crea la app. No selecciones la opción de Shopify CLI. Debes llegar a la configuración de la app.
En la configuración de la app, escribe
https://www.recurrente.comen URLs → App URL, desmarca Embed app in Shopify admin y agrega estos permisos en API access → Scopes:read_products,write_draft_orders,write_orders. Guarda los cambios. Debes ver los tres permisos configurados y el campo App URL completo.
Selecciona Release para activar la versión de la app. Debes ver la versión como publicada antes de instalarla.
Si App URL queda vacío o falta uno de los permisos, la conexión no podrá completar los pasos posteriores. Revisa la configuración antes de continuar.
Paso 2: habilita los datos de entrega de tus clientes
El acceso a datos protegidos de clientes permite que la orden de Shopify incluya el nombre, correo, teléfono y dirección de entrega del comprador.
Entra a partners.shopify.com, abre Apps, selecciona la app Recurrente y abre API access requests. Debes ver la sección Protected customer data access.
En Data use and reasons, selecciona Store management. Luego activa Name, Email, Phone y Address en Protected customer fields, y selecciona Save. Debes ver los cuatro campos guardados.
Si los cuatro campos no quedan habilitados, la integración no podrá registrar una orden con los datos necesarios para la entrega.
Paso 3: instala la app y copia sus credenciales
Después de publicar la app de Shopify, debes instalarla en la tienda exacta que conectarás con Recurrente.
Vuelve a dev.shopify.com, abre la app Recurrente y selecciona Install app en la tarjeta Installs. Debes ver el selector de tiendas.
Selecciona la tienda correcta y confirma con Install. Debes volver al Dev Dashboard con la instalación registrada.
Abre Settings → Credentials en la app. Copia el Client ID y muestra y copia el Client Secret. Debes conservar ambos valores para el formulario de Recurrente.
Si instalaste la app en otra tienda, desinstálala y repite este paso con el dominio correcto antes de conectar Recurrente.
Paso 4: conecta la tienda desde Recurrente
El formulario de Recurrente valida las credenciales de Shopify y genera el código que mostrará el pago en tu tienda.
En Recurrente, abre Configuración → Llaves API, busca la tarjeta Shopify y selecciona Conectar Shopify. Debes ver el formulario de conexión.
Escribe el dominio terminado en
.myshopify.com, el Client ID y el Client Secret de la app instalada. El dominio debe pertenecer a la misma tienda donde instalaste la app.Configura las tarifas de Envío local y Envío interior. En tiendas GTQ, escribe el monto en quetzales; escribe
0si el envío es gratis.Selecciona los métodos de pago que quieres mostrar. Si no seleccionas ninguno, el checkout usa la configuración vigente de tu cuenta de Recurrente. Las cuentas empresariales pueden seleccionar únicamente las cuotas habilitadas para su cuenta; las cuotas se muestran solo en tiendas GTQ. Activa Precio dinámico si quieres aplicar el recargo configurado según el método de pago.
Selecciona Conectar tienda. Si las credenciales son válidas, debes ver una confirmación con un código de dos líneas. Copia el código completo; lo usarás en el tema de Shopify.
Si Recurrente indica que las credenciales no funcionan, confirma el Client ID, el Client Secret, el dominio .myshopify.com y que la app esté instalada en esa misma tienda. Si el error continúa, contacta a soporte con el mensaje exacto.
Paso 5: agrega el pago con Recurrente al carrito
El código generado por Recurrente crea el formulario Datos de entrega y el botón Realizar pago dentro del tema de Shopify.
En el administrador de Shopify, abre Online Store → Themes → Customize. Debes ver el editor del tema activo.
En el selector de páginas del editor, abre la página Cart. Debes ver la plantilla del carrito.
Selecciona Add section, agrega Custom Liquid, pega el código completo generado por Recurrente y selecciona Save. Debes ver el formulario de entrega en la vista previa.
Abre el carrito de la tienda como cliente. Debes ver Datos de entrega, los campos de contacto y dirección, y el botón Realizar pago. Si no aparecen, confirma que guardaste la sección en la plantilla correcta del carrito.
💡 El snippet no está amarrado al carrito: puedes pegarlo en la sección o página de tu tema que prefieras, y personalizarlo a tu antojo — colores, ancho, espaciado o tu propio CSS — con las mismas opciones que cualquier otra sección del tema.
💡 Si tu tema muestra también el botón "Check out" de Shopify, considera ocultarlo desde el editor para que tus clientes usen solo el pago con Recurrente.
Paso 6: realiza una compra de prueba
La compra de prueba confirma que Shopify envía el carrito a Recurrente y que la orden pagada vuelve a Shopify.
Agrega un producto al carrito, completa todos los datos de entrega y selecciona Realizar pago. Debes llegar al checkout hospedado de Recurrente.
Completa el pago con un método habilitado para tu cuenta. Debes ver la confirmación del pago y la página de estado del pedido cuando Shopify termine de registrar la orden.
En Shopify, abre Orders. Debes ver una orden con los productos, el envío y los datos de entrega del comprador; el inventario de los productos debe quedar actualizado.
Si Recurrente confirma el pago pero la orden no aparece en Shopify, no repitas el cobro. Contacta a soporte con el dominio de la tienda, el correo del comprador, el identificador del pago y la hora aproximada.
Qué vas a ver cuando Shopify quede conectado
Cuando Shopify quede conectado, cada compra inicia con los precios actuales de las variantes en Shopify. Recurrente crea un checkout con los productos y el envío, y después del pago registra la orden correspondiente en Shopify.
El comprador ve Datos de entrega y Realizar pago en el carrito.
El comprador paga en el checkout hospedado de Recurrente.
La orden pagada aparece en Orders con los datos de entrega.
El inventario de Shopify se descuenta al completar la orden.
Reembolsos entre Shopify y Recurrente
La integración de Shopify sincroniza los reembolsos iniciados en cualquiera de los dos sistemas cuando la conexión quedó completa.
Reembolso iniciado en Recurrente: el dinero se devuelve al comprador, la orden de Shopify se cancela y el inventario se repone.
Reembolso iniciado en Shopify: el monto reembolsado se envía a Recurrente para devolver el dinero al comprador.
Si un reembolso aparece solo en uno de los sistemas, no lo ejecutes de nuevo. Contacta a soporte con el identificador de la orden de Shopify, el identificador del pago de Recurrente y el monto reembolsado.
Errores o casos comunes
No aparece Conectar Shopify en Recurrente.
Confirma que estás en Configuración → Llaves API. Si la tarjeta Shopify no aparece, contacta a soporte para confirmar la disponibilidad en tu cuenta.
Las credenciales de Shopify no funcionan.
Confirma que copiaste el Client ID y el Client Secret desde Dev Dashboard → tu app → Settings → Credentials, que instalaste la app y que el dominio corresponde a esa misma tienda.
Las credenciales pertenecen a otra tienda.
Revisa el dominio .myshopify.com y usa las credenciales de la app instalada en ese dominio.
La moneda de la tienda no es compatible.
La integración admite tiendas GTQ y USD. Cambia la moneda de la tienda a una de esas opciones antes de conectar Recurrente.
El carrito indica que faltan datos.
Completa nombre, teléfono, correo electrónico, dirección, departamento y municipio antes de seleccionar Realizar pago.
No se pudo iniciar el pago.
Revisa la conexión a internet y vuelve a intentarlo una vez. Si el mensaje continúa, contacta a soporte con una captura del error y la hora aproximada.
La conexión con Shopify fue revocada.
Vuelve a conectar la tienda desde Configuración → Llaves API → Shopify con credenciales vigentes.
Preguntas frecuentes
¿Tengo que renovar las credenciales de Shopify cada día?
No. La integración renueva automáticamente el acceso de Shopify mientras el Client ID y el Client Secret sigan vigentes y la app permanezca instalada.
¿Qué pasa si cambio el tema de Shopify?
Agrega una nueva sección Custom Liquid en el carrito del tema nuevo y vuelve a pegar el código generado por Recurrente. Si perdiste el código, vuelve a conectar la tienda para obtenerlo.
¿Puedo ofrecer cuotas?
Las cuotas están disponibles únicamente para tiendas GTQ y cuentas empresariales. El formulario muestra solo los plazos habilitados para tu cuenta.
¿Qué monedas admite la integración de Shopify?
La integración admite GTQ y USD.
¿Recurrente puede cambiar el precio de mis productos?
La integración consulta los precios actuales en Shopify cuando el comprador inicia el pago. Recurrente usa esos precios para crear el checkout y no acepta precios enviados desde el navegador.
Si todavía necesitas ayuda
Incluye el nombre del comercio, el correo de la cuenta de Recurrente, el dominio .myshopify.com, el identificador del pago u orden relacionada, una captura del error y la hora aproximada.
Contacta a soporte por correo [email protected] o por WhatsApp +1 (786) 917-5397.