1. Shopify
Kushki Docs
Español
  • Español
  • English
  • Inicio
  • Inicio rápido
    • Preguntas frecuentes
    • Paso a producción
    • Política de cambios importantes del API
    • Códigos de error
    • Datos de prueba
    • Últimas novedades
  • Glosario de pagos
    • Glosario de pagos
  • Pagos únicos con tarjeta (Online)
    • Network Tokens
    • Marcas de tarjeta soportadas
    • Funcionalidades por modelo de negocio
    • Pagos en un paso
      • ¿Cómo funcionan los pagos con tarjeta?
      • Acepta pagos únicos con OTP
      • Códigos de error autenticación OTP
      • Códigos de error pagos únicos con tarjeta
      • Cargo directo (sin token)
      • Acepta un pago con tarjeta
    • Pagos en dos pasos
      • ¿Cómo funcionan los pagos únicos con autorización y captura?
      • Recibe pagos con autorización y captura
    • Devoluciones
      • Devoluciones, anulaciones y reembolsos
    • Autenticación 3DS
      • Integración 100% API de 3DS
      • Integración 3DS con librería kushki.js
      • Códigos de error autenticación 3DS
      • Integración 3DS API + librería kushki.js
      • Introducción a 3DS
    • Pagos con Apple Pay
      • Configuración de Apple Pay
      • Pruebas en Sandbox Apple Pay
  • Pagos recurrentes con tarjeta (Online)
    • Autentica tus suscripciones con 3DS
    • Apple Pay en Suscripciones
    • Acepta pagos one click con 3DS
    • Funcionalidades por modelo de negocio
    • Códigos de error en cargos recurrentes
    • Suscripciones externas a Kushki
    • Pagos calendarizados
      • Crea un cargo recurrente
      • Maneja tus cargos calendarizados
      • ¿Cómo funcionan los cargos recurrentes con tarjeta?
    • Pagos OneClick
      • ¿Cómo funcionan los pagos OneClick con autorización y captura?
      • Genera pagos one click
      • Recibe pagos OneClick con autorización y captura
  • Pagos con tarjeta presente
    • Datos de prueba
    • Acepta pagos con tarjeta presente
    • Webhooks para tarjeta presente
    • Raw card-present API
      • Introducción a Raw card-present API
      • Script de ejemplo para cifrar información
      • Intercambio de claves criptográficas
      • Preguntas frecuentes
      • Códigos de error para transacciones con tarjeta presente
      • Acepta pagos
    • Transacciones
      • Anula un pago
      • Transacciones
    • Kushki One
      • Autenticación y Cifrado de Requests
      • Realiza cobros con Kushki One
      • Servicios asíncronos y webhooks
      • Formato de montos en Kushki ONE
      • Catálogo Unificado de Errores — Kushki ONE Connect
      • Primeros Pasos
      • Impresión en terminal SmartPOS
    • Kushki One App de Pagos
      • Descripción general
      • Devoluciones y PreAuth & Capture
      • Pago Dividido en la terminal
      • Configuración del terminal
      • Consulta tus transacciones
      • Procesa un cobro
  • Pagos con transferencias
    • Consulta el estado de una transacción
    • Experiencias de compra y detalles de operación para pagos con transferencia bancaria
    • Recibe transferencias bancarias
  • Pagos en efectivo
    • Puntos de recaudo
    • Códigos de error para transacciones declinadas en efectivo
    • Acepta un pago en efectivo
  • Métodos alternativos de pago (APM)
    • ¿Cómo funcionan los pagos con APM?
    • Acepta pagos con Yape
  • Dispersión de dinero
    • Transferencia bancaria
      • ¿Cómo funciona la dispersión por transferencia bancaria?
      • Códigos de error para dispersiones por transferencia
      • Dispersa a cuentas bancarias
    • Tarjeta
      • ¿Cómo funciona el envío de fondos a tarjetas?
      • Envía dinero a una tarjeta
      • Códigos de error
  • Plugins
    • Shopify
      • Operación del Plugin
      • Shopify
    • Vtex
      • Guía de integración VTEX
  • Links de pago
    • Smartlinks
  • Formularios y botones de pago
    • Kajita
      • Kajitas de pago
      • ¿Cómo funciona?
    • Botón de pago
      • ¿Cómo funciona el botón de pago?
      • Genera un botón de pago
  • Administración de sucursales
    • ¿Cómo realizar el onboarding de subcomercios vía API?
  • Notificaciones
    • Buenas prácticas
    • Consulta tus webhooks
    • Webhooks para pagos únicos
      • Webhook para pagos únicos con tarjeta
      • Webhook para pagos únicos con transferencia bancaria
      • Webhook para pagos únicos con efectivo
    • Webhooks para pagos recurrentes
      • Webhook para pagos recurrentes con tarjeta
    • Webhooks para dispersiones
      • Webhook para dispersión de dinero con Transferencia
      • Webhook para dispersión con tarjeta
    • Webhooks para smartlinks
      • Webhooks con Smartlinks
    • Webhooks para botón de pagos
      • Webhooks con Botón de pago
    • Webhooks para devoluciones
      • Webhook para devoluciones
      • Webhook para contracargos
HomeMexico 🇲🇽Ecuador 🇪🇨Chile 🇨🇱Colombia 🇨🇴Peru 🇵🇪
HomeMexico 🇲🇽Ecuador 🇪🇨Chile 🇨🇱Colombia 🇨🇴Peru 🇵🇪
Status
Soporte / Support
Español
  • Español
  • English
  1. Shopify

Shopify

Acepta pagos para tu e-commerce en Shopify. Kushki te ofrece un plugin que puedes instalar en tu sitio web, simplificando el proceso de compra de tus clientes.
Shopify es una plataforma de e-commerce que te permite construir tu tienda en línea desde cero. Podrás promocionar, vender y enviar tus productos, sin necesidad de escribir una sola línea de código ni tener experiencia desarrollando webs. Es ideal para pequeños y grandes comercios, ya que cuenta con herramientas que te ayudarán a escalar tu negocio.
Shopify es utilizado actualmente por miles de tiendas en todo el mundo y está disponible en 50 idiomas diferentes.
Por estas razones, Kushki buscó integrar sus métodos de pago mediante la creación de un plugin que permite realizar pagos de manera segura y fácil, disponible en varios países. El detalle de la instalación y administración lo encontrarás a continuación.
Soporta ✅No soporta ❌
Pagos con tarjeta de débito y créditoCargos recurrentes (Calendarizados o one click)
Pagos en efectivo
Transferencias
Autorización y captura
Pagos diferidos con meses sin intereses y con meses de gracia en pagos únicos
Autenticación OTP y 3DS
Motor antifraude Siftscience
Reembolsos totales y parciales
Cancelaciones el mismo día, totales o parciales en moneda local
Importante
Ten en cuenta que, debido a nuestras políticas de riesgo, los medios de pago disponibles y el tipo de integración pueden variar al momento en que formalices la afiliación. Te indicaremos cómo proceder en caso de que este proceso aplique para tu comercio.

Requisitos mínimos#

Para realizar el proceso de integración y configuración del plugin de Kushki en tu tienda Shopify, tu comercio debe cumplir con los siguientes requisitos:
Una vez tu comercio obtenga la certificación por parte del equipo de Kushki, tu comercio debe tener una cuenta de producción en Kushki, con la cual se generarán las Public API Key y Private API Key. El acceso a esta cuenta lo proporcionará nuestro equipo de Onboarding.
Debes contar con un usuario master en la consola de Kushki, con el cual podrás gestionar las funcionalidades y configuraciones de acuerdo con el acuerdo comercial establecido entre tu comercio y Kushki. Para solicitarlo, contacta a tu ejecutivo de ventas asignado.
Recuerda activar y configurar el servicio de Botón de pago (webcheckout) con Kushki, para garantizar que el plugin de Shopify funcione.
Debes tener previamente creada una cuenta con Shopify. En caso de no tenerla, accede al Centro de ayuda de Shopify para crearlo y generar tu dominio.

Instalación y configuración#

Una vez tengas tu tienda configurada en Shopify y cuentes con una cuenta de producción en Kushki, realiza lo siguiente:
1.
Ingresa a la Consola de tu comercio con tu usuario y contraseña.
2.
En el menú lateral, selecciona Configuración.
3.
En Integraciones, escoge la opción Plugins.
4.
Selecciona Shopify. La pantalla en la que podrás Configurar el contenido y estilo de tu formulario se desplegará.
5.
Ingresa el Dominio asignado por Shopify y haz clic en el botón Guardar.
Ten en cuenta
Tu dominio puede ser actualizado si así lo requieres.
Se habilitará el botón Configura el estilo de tu checkout, haz clic sobre éste y modifica la apariencia de tu botón de pago. Sigue las instrucciones dadas en Genera un botón de pago para personalizar la experiencia de pago de tu tienda Shopify.
6.
Una vez guardes tu dominio aparecerá la información de la Public API Key y la Private API Key asociadas a tu comercio. Puedes hacer clic en el botón Copiar para agregar esta información en el portapapeles.
📝 Nota
Las credenciales sólo podrán ser modificadas mediante una solicitud a nuestro equipo de Tech Support.
7.
En la opción para agregar la aplicación Kushki en Shopify, haz click en la palabra Aquí y el sistema te redireccionará a la página de instalación de Shopify.
8.
Haz clic en el botón Agregar aplicación.
9.
Ingresa tu Email en la pantalla de inicio de sesión de Shopify.
10.
Haz clic en Continuar con el correo electrónico.
11.
Ingresa tu Contraseña y haz clic en Iniciar sesión.
12.
Ingresa el Código de autenticación que recibiste en tu dispositivo móvil.
13.
Haz clic en Iniciar sesión.
14.
Selecciona tu Tienda.
15.
Selecciona tu Cuenta.
16.
Se abrirá por defecto la configuración para instalar el plugin de Kushki. Haz clic en el botón Instalar aplicación.
17.
Aparecerá una ventana en la cual deberás ingresar las credenciales. Pega las credenciales de la Llave pública y Llave personal (llave privada) que copiaste en el numeral 6 de este apartado.
18.
Haz clic en Enviar datos.
⚠️ Advertencia
Si el código E16 aparece en la pantalla, desinstala la aplicación, vuelve al paso 1 e inicia el proceso nuevamente.
19.
Haz clic en Ir a Configuración.
20.
El sistema te redirigirá a Configuración. En la sección Pagos, haz clic en Agregar formas de pago.
21.
En Buscar por proveedor, busca por el conector Kushki y haz clic en Activar.
22.
Marca/desmarca las Franquicias de tarjeta que deseas aceptar en tu comercio.
Importante
Las franquicias de tarjeta deberán ser las mismas que las configuradas en la consola de Kushki de tu comercio.
23.
Verifica si la tienda se encuentra activa en modo prueba. Ten en cuenta que debe estar desmarcada la opción Habilita el modo de prueba; en caso contrario, por favor desactívalo y haz clic en Guardar.
24.
Haz clic en el botón Activar Kushki y verás el mensaje Kushki Activado.

Configuración del método de contacto del cliente y de la moneda a transaccionar#

1.
En el menú lateral, selecciona Pantalla de pago.
2.
En Método de contacto del cliente, verifica que la casilla del Correo electrónico esté seleccionada. De lo contrario, selecciona esta opción.
3.
Haz clic en Guardar. Aparecerá el siguiente mensaje: Configuración guardada.
Importante
Debes activar el Correo electrónico como método de contacto del cliente, ya que es un parámetro necesario para procesar los pagos adecuadamente.
4.
Para configurar la moneda, en el menú lateral selecciona Información de la tienda.
5.
En Moneda de la tienda, elige la moneda con la cual vas a transaccionar y haz clic en Guardar.
Advertencia
Ten en cuenta que, una vez configurada la moneda y que hayas recibido tu primera transacción, no podrás modificarla. Para cambiar la moneda, o bien, para aceptar transacciones con múltiples monedas, deberás hacer clic aquí para ponerte en contacto con Shopify. Adicionalmente, deberás notificarlo a Kushki aquí para realizar las configuraciones correspondientes.
Kushki estará habilitado para que recibas pagos de tus clientes en tu tienda de Shopify.
Así se verá la experiencia de pagos con el plugin de Kushki en tu tienda Shopify:

Desinstalación#

1.
Ingresa a tu Consola de Shopify.
2.
Dirígete a Configuración > Pagos, en la sección Formas de pago admitidas busca Kushki y selecciona Gestionar e inmediatamente se abrirá una nueva ventana.
3.
Haz clic en el botón __ Desactiva Kushki__ que se encuentra en la parte inferior de la ventana.
4.
Aparecerá una ventana de confirmación, haz clic en el botón Desactiva Kushki para confirmar. Una vez hecho esto se mostrará el siguiente mensaje: Kushki desactivado.
5.
Haz clic en Desinstala Kushki para eliminar el plugin de Kushki.
6.
Aparecerá un mensaje de confirmación, haz clic en el botón Desinstala Kushki para confirmar. Una vez hecho esto, el sistema mostrará el siguiente mensaje: Kushki desinstalado.
El siguiente GIF te guiará a través del proceso de desinstalación del plugin:
Instalación
Modificado en 2026-10-22 15:38:26
Anterior
Operación del Plugin
Siguiente
Vtex
Built with