1. Pagos con tarjeta presente
Kushki Docs
Español
  • Español
  • English
  • Inicio
  • Inicio rápido
    • Últimas novedades
    • Datos de prueba
    • Preguntas frecuentes
    • Paso a producción
    • Política de cambios importantes del API
    • Códigos de error
  • 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
      • Acepta un pago con tarjeta
      • Cargo directo (sin token)
      • ¿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
    • Pagos en dos pasos
      • Recibe pagos con autorización y captura
      • ¿Cómo funcionan los pagos únicos con autorización y captura?
    • Devoluciones
      • Devoluciones, anulaciones y reembolsos
    • Autenticación 3DS
      • Integración 3DS API + librería kushki.js
      • Introducción a 3DS
      • Integración 100% API de 3DS
      • Integración 3DS con librería kushki.js
      • Códigos de error autenticación 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
    • Suscripciones externas a Kushki
    • Acepta pagos one click con 3DS
    • Funcionalidades por modelo de negocio
    • Códigos de error en cargos recurrentes
    • Pagos calendarizados
      • Maneja tus cargos calendarizados
      • Crea un cargo calendarizado
      • ¿Cómo funcionan los cargos recurrentes con tarjeta?
    • Pagos OneClick
      • Recibe pagos OneClick con autorización y captura
      • Genera pagos one click
      • ¿Cómo funcionan los pagos OneClick con autorización y captura?
  • Pagos con tarjeta presente
    • Acepta pagos con tarjeta presente
    • Datos de prueba
    • Webhooks para tarjeta presente
    • Raw card-present API
      • Introducción a Raw card-present API
      • Script de ejemplo para cifrar información
      • Acepta pagos
      • Intercambio de claves criptográficas
      • Preguntas frecuentes
      • Códigos de error para transacciones con tarjeta presente
    • Kushki One
      • Primeros Pasos
      • Autenticación y Cifrado de Requests
      • Realiza cobros con Kushki One
      • Formato de montos en Kushki ONE
      • Impresión en terminal SmartPOS
      • Catálogo Unificado de Errores — Kushki ONE Connect
      • Servicios asíncronos y webhooks
    • Kushki One App de Pagos
      • Descripción general
      • Devoluciones y PreAuth & Capture
      • Pago Dividido en la terminal
      • Configuración del terminal
      • Procesa un cobro
      • Consulta tus transacciones
    • Transacciones
      • Transacciones
      • Anula un pago
  • Pagos con transferencias
    • Recibe transferencias bancarias
    • Códigos de error para transferencias
    • Consulta el estado de una transacción
    • Bancos y detalles de operación para pagos con transferencia bancaria
  • Pagos en efectivo
    • Acepta un pago en efectivo
    • ¿Cómo funcionan los pagos en efectivo?
    • Puntos de recaudo
    • Códigos de error para transacciones declinadas en efectivo
  • Métodos alternativos de pago (APM)
    • ¿Cómo funcionan los pagos con APM?
    • Acepta pagos con Bre-B
  • Dispersión de dinero
    • Recarga tu saldo para dispersiones
    • Transferencia bancaria
      • Dispersa a cuentas bancarias
      • Dispersa con Bre-B
      • Códigos de error para dispersiones por transferencia
      • ¿Cómo funciona la dispersión por transferencia bancaria?
    • Efectivo
      • Dispersa dinero en efectivo
      • Maneja tus dispersiones
      • ¿Cómo funciona la dispersión por efectivo?
  • Plugins
    • Shopify
      • Shopify
      • Operación del Plugin
    • Vtex
      • Guía de integración VTEX
  • Links de pago
    • Smartlinks
  • Formularios y botones de pago
    • Introducción
    • Kajita
      • Kajitas de pago
      • ¿Cómo funciona?
    • Botón de pago
      • Genera un botón de pago
      • ¿Cómo funciona el 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 smartlinks
      • Webhooks con Smartlinks
    • Webhooks para dispersiones
      • Webhook para dispersión de dinero con transferencia
      • Webhook para dispersión de dinero con efectivo
    • 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. Pagos con tarjeta presente

Acepta pagos con tarjeta presente

Revisa todo lo necesario para empezar a aceptar pagos con tarjeta presente mediante una terminal POS
Producto en versión beta en Colombia 🔐👨‍
Estamos trabajando en nuestra versión beta. ¡Manténte atento a su lanzamiento oficial! También puedes contactar a tu gerente de cuenta para más información.
Los pagos en persona a través de una tarjeta física o digital corresponden a las transacciones que se realizan con tu cliente de manera física en el sistema de punto de venta (también conocido como POS). A través de este dispositivo, podrás agilizar el proceso transaccional con tus clientes y habilitar un servicio rápido que les permite:
Realizar compras con tarjetas físicas o digitales por diferentes canales de lectura (NFC, chip, banda magnética).
Disminuir el tiempo de espera para el procesamiento de sus transacciones.
Reducir los márgenes de error de cobro o procesamiento.
Facilitar el proceso de cancelación o devolución de las transacciones realizadas.
De esta manera, si cuentas con una tienda física, puedes habilitar pagos de manera rápida a través de los servicios de Kushki.

Características#

Te presentamos algunas de las características de los pagos con tarjeta presente.
Compatibilidad en línea: a través del uso de los servicios de Kushki, puedes verificar la información de las transacciones recibidas y realizadas por tu comercio a través de medios digitales o presenciales desde la consola de administración.
Compatibilidad con múltiples lectores de tarjeta: puedes elegir el lector de tarjeta de tu preferencia siempre y cuando cumpla con los requisitos y certificaciones necesarias.
Comunicación segura y directa con Kushki: este servicio establece una comunicación directa entre Kushki y tu comercio, por medio de la transmisión de información a través medios electrónicos seguros en Internet. La comunicación establecida hacia los servicios se Kushki se debe hacer desde tu back end.
Tipos de conexión: dependiendo de las necesidades de tu comercio y las capacidades técnicas de las terminales utilizadas, podrás establecer la conexión interna de tus terminales por medio de bluetooth, Wifi, USB o internet.
Compatibilidad extendida: si ya cuentas con terminales certificadas en tu comercio, podrás integrarlas para procesar pagos a través de Kushki.
Te describimos los pasos a seguir para empezar a recibir cobros con tarjeta en tu negocio a continuación.

Paso 1. Configura una cuenta#

Crea una cuenta dependiendo el tipo de integración.
Raw card-present API: contacta directamente a nuestro equipo de ventas para poder brindarte la mejor solución de acuerdo a las necesidades de tu negocio. Accede al panel de administración con tu cuenta creada para obtener tus credenciales de integración y ver la información de tu comercio.

Paso 2. Determina el alcance de la integración#

De acuerdo a las necesidades de tu negocio, elige uno o más de los siguientes tipos de integración y terminales disponibles para aceptar pagos con tarjeta presente.
Raw Card-Present API (Otras): integra tus propias terminales para procesar transacciones a través de nuestra red de pagos.
Ten en cuenta que algunos tipos de integración van a requerir que tengas certificación PCI.

Paso 3. Obtén terminales de prueba#

Una vez elijas el tipo de integración y terminal a usar en tu integración, será necesario obtener terminales de prueba para empezar el proceso de desarrollo y pruebas.
Algunos tipos de integración y terminales podrían requerir configuraciones adicionales para apuntar al ambiente de pruebas, por lo que te recomendamos contactar a nuestro equipo de ventas para asegurarnos de que cuentes con todo lo necesario para empezar.
Nota: en algunos casos, las terminales que se han utilizado para pruebas no podrán utilizarse para realizar cobros reales. Obtén más información con tu gerente de cuenta.

Paso 4. Configura tu integración#

Obtén tus credenciales y llaves de acceso para realizar las pruebas necesarias en el ambiente de desarrollo que te permitan integrar correctamente las terminales a tu sistema punto de venta.
Realiza las adecuaciones necesarias en tu sistema de acuerdo al tipo de integración y a las operaciones deseadas, configura un webhook para recibir notificaciones de los eventos y realiza pruebas para cubrir todos los escenarios disponibles.

Paso 5. Certifica tu integración#

Ciertos tipos de integración requieren una certificación antes de que puedas realizar cobros reales para asegurarnos que todo funcione correctamente antes de salir a producción.
Después de que hayas configurado tu integración y realizado las pruebas necesarias, revisa con tu administrador de cuenta los siguientes pasos para realizar las certificaciones correspondientes.

Paso 6. Salida a producción#

Obtén tus credenciales de producción para empezar a aceptar cobros reales con terminales una vez hayas completado las certificaciones necesarias (si aplica).
Obtén y configura las terminales necesarias en tu negocio, asegúrate de que apunten al ambiente de producción, realiza los últimos ajustes en tu sistema y ¡comienza a cobrar!
Comunícate con tu gerente de cuenta para iniciar tu proceso de salida a producción y obtener tus credenciales.
Modificado en 2026-09-23 16:56:07
Anterior
Pagos con tarjeta presente
Siguiente
Datos de prueba
Built with