Cómo integrar Tilopay en Shopify: guía paso a paso

Qué resuelve Tilopay y qué no

Tilopay es una pasarela regional de Centroamérica y el Caribe. Procesa Visa, Mastercard y American Express, además de SINPE Móvil, y liquida a cuenta bancaria local. En Shopify se conecta como proveedor de pago externo, no como Shopify Payments.

Lo que no resuelve: la comisión adicional que Shopify cobra por usar cualquier pasarela que no sea la propia. Ese cargo existe siempre y conviene tenerlo claro antes de montar la tienda, porque cambia la matemática del negocio. Lo desgloso en cuánto cobra Tilopay.

Paso 1: Afiliación en Tilopay

La afiliación es en línea y no tiene costo. Los documentos que piden dependen del tipo de contribuyente.

Persona jurídica:

• Personería jurídica vigente
• Registro único tributario (RUT)
• Certificación literal de composición societaria
• Cédula de identidad del representante legal
• Cuenta bancaria a nombre del comercio

Persona física:

• Cédula de identidad
• Registro único tributario (RUT)
• Cuenta bancaria

La solicitud pasa a revisión y, según lo que reporta Tilopay, se resuelve en menos de 48 horas. Planificá con holgura de todos modos: si un documento viene desactualizado, el reloj se reinicia.

Un punto que conviene ordenar desde el inicio: la cuenta bancaria y el RUT deben corresponder al mismo contribuyente que va a facturar. Si la tienda opera a nombre de la sociedad pero la cuenta es personal, la afiliación se traba y arreglarlo después cuesta más tiempo que hacerlo bien la primera vez.

Paso 2: Generar las credenciales de integración

Ya aprobado, el panel de Tilopay es donde se generan las credenciales que la tienda va a usar. Según la plataforma que integres, vas a necesitar el usuario de integración, la contraseña de integración y la API key asociada al método de pago.

Guardá esas credenciales fuera de la tienda, en un gestor de contraseñas. No las pegués en un documento compartido ni en un chat: quien las tenga puede operar cobros en tu nombre.

Paso 3: Conectar en Shopify

En el admin de Shopify:

1. Entrá a Settings y luego a Payments.
2. Buscá la sección de proveedores de pago adicionales (Additional payment providers).
3. Buscá Tilopay en el listado y seleccionalo.
4. Ingresá las credenciales de tu cuenta de Tilopay cuando las pida.
5. Confirmá que aparezca el mensaje de conexión exitosa.
6. Activá con las casillas los métodos que querés cobrar: tarjetas, SINPE Móvil y los que ofrezca tu afiliación.
7. Guardá con Activate Tilopay.

Tilopay documenta guías por plataforma y mantiene integraciones con Shopify, WooCommerce, Wix, VTEX y Magento, entre otras. Si el listado de tu tienda se ve distinto, revisá la guía específica de tu país en la documentación de Tilopay antes de improvisar.

Paso 4: Probar antes de vender

Acá está el error que más tiempo hace perder, y está documentado por Tilopay aunque casi nadie lo lee a tiempo:

"Debés activar y desactivar el modo de prueba en ambas plataformas para que funcione correctamente."

Documentación de Tilopay sobre configuración en Shopify

Es decir, el modo de prueba de Shopify y el del panel de Tilopay tienen que estar en el mismo estado. Si uno queda activo y el otro no, las transacciones fallan y el error que devuelve la pasarela no dice cuál es la causa real. Se pierden horas buscando un problema de configuración que no existe.

Checklist mínimo antes de abrir la tienda al público:

• Una compra completa de prueba con tarjeta, hasta ver la orden pagada en Shopify
• Una compra con SINPE Móvil si vas a ofrecerlo
• Un reembolso de prueba, para saber cómo se comporta antes de necesitarlo con un cliente real
• Verificar que el correo de confirmación le llegue al cliente y a vos
• Desactivar el modo de prueba en las dos plataformas y hacer una compra real de monto bajo

Paso 5: Entender qué te van a depositar

La sorpresa más común después de la primera venta: el depósito no coincide con lo vendido. Hay tres descuentos distintos y solo uno es de Tilopay.

• Comisión de Tilopay: 4.25% más $0.35 en tarjeta, 2% más $0.35 en SINPE Móvil, más el IVA del 13% que aplica sobre esa comisión
• Comisión de Shopify por pasarela externa: 2% en Basic, 1% en Grow, 0.6% en Advanced, 0.2% en Plus
• Costo por depósito: el contrato de afiliación puede incluir un cargo fijo por cada transferencia a tu cuenta. No está en la tarifa pública y en liquidaciones pequeñas puede ser la línea más cara
• Retenciones de Hacienda: 2% de adelanto de renta y el factor de retención de IVA, ambos calculados sobre la base sin IVA, no sobre el monto bruto

Las retenciones no son un costo: son pago a cuenta de impuestos que ya ibas a pagar y se acreditan en tu declaración. Cómo funcionan y por qué a cada comercio le retienen distinto está en retenciones de IVA y renta en pagos con tarjeta.

Para ver el desglose con tus propios números, la calculadora de comisiones de Tilopay lo calcula venta por venta.

Errores que conviene evitar

• Montar la tienda sin saber el costo por venta. Con Shopify Basic el costo de procesar ronda el 6.25% más el cargo fijo, no el 4.25% que dice la tabla de Tilopay.
• No probar el reembolso. Aprender el flujo con un cliente molesto esperando es la peor forma de aprenderlo.
• Dejar el modo de prueba desincronizado. Genera fallos que parecen problemas de la pasarela.
• Afiliar con datos que no calzan. Cuenta bancaria, RUT y razón social deben ser del mismo contribuyente.
• No revisar la liquidación. El panel muestra el detalle de comisiones y retenciones de cada depósito. Es la única forma de cuadrar contra la contabilidad.
• No leer la letra chica de reclamos. Los Términos y Condiciones fijan una penalidad de US$75 por cada reclamo presentado y al menos US$500 si el caso escala a contracargo. Con ticket promedio bajo, un reclamo se come varias ventas.
• Liquidar demasiado seguido. Si tu contrato tiene cargo fijo por depósito, cada liquidación lo paga completo. Juntar ventas antes de liquidar baja el costo efectivo sin negociar nada.

Resumen

Afiliarse toma menos de 48 horas si los documentos están al día, la conexión en Shopify son diez minutos, y lo que realmente hay que preparar es la parte económica: la comisión de Tilopay, la de Shopify y las retenciones. Esas tres juntas definen si el margen del producto aguanta la venta en línea.

Si estás montando la tienda desde cero, el proceso completo está en cómo abrir una página web para mi negocio, y los rangos de inversión en cuánto cuesta una página web en Costa Rica.

Datos de tarifas y configuración verificados en agosto de 2026 contra las páginas oficiales de Tilopay y Shopify. Las comisiones cambian: confirmá las vigentes antes de tomar decisiones de precio.