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

Pagos en dos pasos

Esta funcionalidad se encuentra disponible para los siguientes modelos:
☑ Adquirente

☐ Agregador
Recibir pagos únicos con tarjeta bajo el esquema de autorización y captura, consiste en reservar los fondos de la tarjeta de tu cliente, teniendo la oportunidad de ejecutar la captura de fondos hasta cuando se complete el servicio. También permite realizar reautorizaciones para extender la vigencia de la reserva de los fondos o cambiar el monto inicial.

Detalles de operación#

Importante
Ten en cuenta que la vigencia de la autorización puede variar dependiendo de la negociación comercial.
ParticularidadDetalle
Tipos de tarjeta soportadasTarjetas débito y crédito de Visa y Mastercard
Vigencia de la autorización7 días para tarjetas débito y 28 días para tarjetas crédito
Hora de finalización de la autorizaciónSe cuentan los 7 días o 28 días a partir de la hora de generación de la autorización
Monto de la reautorizaciónPuede ser superior o inferior al de la autorización. No tiene un límite máximo
Monto de la capturaEl monto máximo a capturar podrá ser 10% superior a la suma total de la autorización inicial más las n reautorizaciones que se ejecuten
Número de capturasSolo es posible 1 captura por autorización
Cancelación de la autorización previo a la fecha de caducidadEs lo recomendable, usando el endpoint de anulación
Restauración del cupo del tarjetahabiente en una cancelaciónLa restauración del cupo depende del emisor
Restauración del cupo del tarjetahabiente por vencimiento de la vigencia de la autorizaciónSe restaura el cupo de forma inmediata

Etapas del proceso#

Autorización y captura (también llamado pago en dos pasos), consiste en dos etapas: Autorización del monto y captura o liberación de fondos.
Autorización y captura para pagos únicos en Perú

Autorización#

1. Selección del método de pago#

En tu sitio web o app, el usuario selecciona tarjeta como método de pago y proporciona los datos de la tarjeta que utilizará para pagar.

2. Envío de datos a Kushki#

El comercio recolecta los datos, los envía a Kushki y solicita un token de pago único de autorización.

3. Envío del token#

Kushki recibirá los datos y te enviará el token de pago único de autorización.

4. Autorización del monto#

El comercio solicita a Kushki autorizar el monto de la tarjeta del cliente.

5. Verificación de fondos#

Kushki procesa la autorización con el emisor, verificando la disponibilidad de fondos. Si este proceso es exitoso, retiene ese monto en la tarjeta del cliente para garantizarlo al comercio.

6. Notificación#

Kushki te devuelve respuesta del proceso de autorización.

Reautorización (opcional)#

Si deseas modificar el tiempo de validez de la autorización o el valor del monto, podrás solicitar una reautorización. Ten en cuenta que cada reautorización se suma al valor de la autorización inicial. La suma total de la autorización inicial más las reautorizaciones posteriores será el monto máximo que se podrá capturar.

Captura o liberación de fondos#

1. Ejecución del cargo#

Una vez ya tengas autorizado el monto de la tarjeta de tu cliente, podrás solicitar el cobro o liberación del saldo autorizado.

2. Notificación de estado de la transacción#

En esta etapa serás notificado con el estado de la transacción. Puedes recibir estas notificaciones a un webhook que expongas para que Kushki lo consuma. También cuentas con la consola de Kushki para verificar las transacciones junto con el detalle de cada una y el estado.

¿Cómo funcionan los pagos únicos con autorización y captura?Etapas de autorización y capturaVer artículo →
Recibe pagos con autorización y capturaAutoriza ahora y captura los fondos despuésVer artículo →
Modificado en 2026-10-26 22:33:00
Anterior
Acepta pagos únicos con OTP
Siguiente
Recibe pagos con autorización y captura
Built with