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

Operación del Plugin

Ahora que tienes el plugin instalado y configurado, es momento de ver cómo operar con él y revisar los estados de las órdenes, procesar con diversos métodos de pago, solicitar devoluciones o anular autorizaciones.

Estados de las órdenes en Shopify#

En Shopify podemos tener diferentes estados para una orden. A continuación se detallan los posibles estados de la orden con el plugin:
Pagado: el pago ha sido realizado correctamente.
Expirado: el tiempo expiró y ya no es posible realizar el pago (aplica para cash y transfer).
Autorizado: el pago ha sido realizado por medio de autorización. En este caso, el monto queda autorizado para luego ser capturado.
Autorizado Venciendo: el tiempo expiró y ya no es posible hacer la captura del pago.
Parcialmente reembolsado: se ha realizado un reembolso, pero solo de un monto inferior al del pedido total pagado y se actualiza el stock de la tienda con los productos devueltos.
Reembolsado: se ha realizado un reembolso total y actualiza el stock de la tienda de todos los productos devueltos.
Pago pendiente: está en espera de que se realice el pago para card (Solo si entra en política de reintentos), cash o transfer. Pasa automáticamente a estado Pagado cuando se ejecuta el pago.
Anulado: se ha realizado una autorización y se cancela la orden de compra.

Procesa pagos únicos#

Para procesar pagos únicos con tarjetas de crédito y débito, transferencia y efectivo, es necesario configurar dentro de la Consola de Shopify el método de captura de pago de la siguiente forma: Configuración > Pagos > Captura de pago, haz clic en el botón Gestionar, donde se mostrará una ventana en la cual debemos seleccionar Cargar el pago de los pedidos automáticamente. Por último, haz clic en el botón Guardar y automáticamente mostrará el siguiente mensaje: Configuración guardada.
Pagos únicos
📝 Ten en cuenta que:
1.
Para los pagos mediante card, cash y transfer el comercio deberá tener configurado por lo menos un procesador por cada uno de estos métodos de pago. Este proceso funcionará de acuerdo con las configuraciones establecidas por el el comercio o procesador.
2.
Para los pagos mediante cash, no puedes configurar la fecha de expiración. Esta se encuentra configurada por defecto en 7 días.
Para pagos en cuotas, debes tener configurado en la consola de Kushki un procesador que soporte esta opción; de lo contrario, no se podrán tener diferidos.

Solicitar una devolución desde Shopify#

Importante ❗
Las devoluciones solo pueden solicitarse desde la tienda Shopify. No es posible solicitarlas desde la Consola de Kushki.
Sigue estas instrucciones para solicitar la devolución de las transacciones en estado Pagado realizadas con tarjeta de débito y crédito. Shopify te permite hacer reembolsos parciales o totales.
Sigue estas instrucciones para solicitar una devolución:
1.
Accede a Shopify con las credenciales de tu comercio.
2.
Haz clic en la opción Pedido, en el menú lateral izquierdo.
3.
Haz clic sobre la orden a realizar el reembolso para entrar a sus detalles.
4.
Haz clic en Reembolso en la parte superior derecha de la pantalla.
5.
Especifica el número de artículos a reembolsar. Para reembolsos totales, selecciona todos los artículos. Para reembolsos parciales, selecciona los artículos indicados.
Si así lo deseas, puedes colocar el Motivo de reembolso debajo de la orden. De lo contrario, puede ser omitido.
6.
Una vez puestos los valores, haz clic en el botón Reembolso que se encuentra al lado inferior derecho de la ventana. La página se actualizará y verás el mensaje de Reembolso en proceso.
Independientemente de la hora, todas las devoluciones serán transaccionadas como refunds.
Reembolso

Procesa pagos con autorización y captura#

Para procesar pagos únicos con tarjetas de crédito y débito, es necesario configurar dentro de la Consola de Shopify el método de captura de pago de la siguiente forma: Configuración > Pagos > Captura de pago y haz clic en el botón Gestionar, donde se mostrará una ventana en la cual debemos seleccionar Cargar el pago de los pedidos manualmente. Por último, haz clic en el botón Guardar y automáticamente mostrará el siguiente mensaje Configuración guardada.
Pagos con Autorización y captura
Si realizaste la reserva de fondos con Kushki desde tu tienda Shopify, Kushki te permitirá realizar la captura de los fondos desde el administrador de tu tienda.
Importante
Si activas el procesamiento con autorización y captura, no podrás activar procesamiento con pagos en un solo paso, transferencia ni efectivo.
Importante
Para procesar pagos con autorización y captura, debes tener en cuenta que está sujeto a las políticas de cada procesador, así como el tiempo de captura.
Las transacciones con tarjeta autorizadas quedarán con estado Autorizado por defecto. Para capturar efectivamente los fondos, sigue estos pasos:
1.
Accede a Shopify con las credenciales de tu comercio.
2.
Haz clic en la opción Pedido que se encuentra en el menú lateral izquierdo.
3.
Haz clic en la orden a realizar la captura. Aparecerá una nueva ventana con el detalle de la orden.
4.
Haz clic en el botón Capturar pago.
5.
Ingresa la Cantidad a capturar y haz clic en el botón Aceptar para generar la captura. Aparecerá el siguiente mensaje Se inició captura de un total de PEN 11,80 (depende del monto y la moneda del país).
Importante
Debes capturar un monto igual o inferior al autorizado.
6.
El estado de la transacción cambia automáticamente de Autorizado a Pagado.
Captura

Anular una autorización#

Shopify te permite hacer una anulación (void) de una transacción autorizada. Sigue estas instrucciones para solicitarla:
1.
Accede a Shopify con las credenciales de tu comercio.
2.
Haz clic en la opción Pedido, en el menú lateral izquierdo.
3.
Haz clic sobre la orden autorizada que deseas anular, para entrar a sus detalles.
4.
Haz clic en Más acciones en la parte superior derecha de la pantalla, en donde se desplegará un menú.
5.
Selecciona la opción de Cancelar orden. Aparecerá una nueva pantalla con opciones.
6.
Selecciona el motivo de la cancelación y haz clic en el botón Cancelar orden. La página se actualizará y verás el mensaje de Orden cancelada, el estado de la orden será Cancelado.
Anulación
Modificado en 2026-09-23 22:20:21
Anterior
Shopify
Siguiente
Shopify
Built with