1. Online Payments
Español
  • English
  • Español
  • Docs de API 🇲🇽
  • Online Payments
    • Errores ISO
    • Errores del API de Kushki
    • Notas de versión
    • Card Payments
      • Solicitar un token de tarjeta
      • Hacer un cargo o cargo diferido
      • Crear pago (sin token)
      • Solicitar opciones de diferido
      • Reembolsar una transacción
      • Autorizar pagos
      • Preautorización (sin token)
      • Anular una transacción
      • Reautorizar pagos
      • Capturar un pago autorizado
      • Información de BIN V2
      • Información de BIN
      • Validar OTP
    • One-Click and Scheduled Payments
      • Solicitar un token de cargo recurrente
      • Crear un cargo recurrente
      • Hacer un pago One-click
      • Actualizar los datos de la tarjeta del cargo recurrente
      • Cancelar un cargo recurrente
      • Actualizar un cargo recurrente
      • Agregar un cargo o descuento temporal
      • Autorizar pagos
      • Capturar un pago autorizado
      • Consultar información del cargo recurrente
    • Transfer in
      • Consultar lista de bancos
      • Solicitar un token de Transfer In
      • Iniciar transacción
      • Consultar estado
    • Transfer Out
      • Consultar lista de bancos
      • Consultar lista de bancos V2
      • Solicitar un token de Transfer Out
      • Iniciar transacción
      • Consultar estado
      • Saldo para payouts
    • Smartlinks
      • Crear un Smartlink
      • Consultar un Smartlink
      • Eliminar un Smartlink
      • Actualizar un Smartlink
    • Payment Button
      • Crear un Payment Button
    • Analytics
      • Consultar listado de transacciones v2
    • Chargebacks
      • Consultar chargebacks
      • Solicitar exportación de chargebacks
    • Commissions
      • Consultar configuración de comisiones
    • Payment Credentials
      • Crear una credencial
      • Activar o desactivar
      • Eliminar credencial
      • Regenerar una credencial
      • Actualizar credencial
      • Búsqueda avanzada
      • Buscar credenciales
    • Platform Status
      • Consultar estado de la plataforma
      • Consultar estado del gateway
    • Settlement
      • Consultar liquidación
    • Subscription Transactions
      • Consultar transacciones de suscripción
    • Fraud Report
      • Consultar alertas de fraude
  • Card Present Billpocket
    • Notas de versión
    • Notas de versión del SDK de Android
    • Notas de versión de la app de Android
    • Notas de versión de la app de iOS
    • Get Started
      • Crear una cuenta
      • User Token
      • API Keys
    • Webhooks
      • Webhooks — Transferencia de fondos a tu cuenta bancaria
      • Errores de transferencia de fondos
    • Terminals
      • App Review
      • Splash Screen
    • Card not Present Billpocket Services
      • 3DS Checkout
        • Crear checkout
        • Consultar detalles del checkout
      • E-commerce Flex
        • Obtener token
        • Validar token
        • Cobrar pagos
        • Reembolso
        • Capturar un pago autorizado
        • Consultar estado
    • Catalogs
      • Estados
      • Municipios
      • Empresas de impuestos
      • Actividades comerciales
    • Accounts
      • Clabe Account Setup
        • Agregar cuenta CLABE
      • Deposit Accounts
        • Agregar o actualizar cuenta CLABE
    • User Settings
      • Crear usuario
    • Card Present Payment Services
      • Cloud Terminal API
        • Cobrar pagos con tarjeta
        • Imprimir ticket
        • Cancelar notificación push
        • Consultar estado de la transacción
        • Cobrar pagos con tarjeta v2
      • App-to-App
        • Android intents
        • App to App — iOS
        • App to App — Mobile Web
      • Terminal SDK
        • Terminal SDK Android
        • Errores del SDK de Android
    • Transactions
      • Transaction List
        • Obtener token
        • Consultar listado de transacciones
        • Consultar listado de transacciones v2
        • Consultar listado de transacciones v3
        • Consultar listado de transacciones v4
      • Cancel Payments
        • Códigos de error de cancelación
        • Cancelar pagos
  • API Raw Card Present
    • El objeto Amount
    • Catálogo de errores
    • Proceso de intercambio de llaves
    • Notas de versión
    • Datos de prueba
    • One-time payments
      • Pago único
    • Two-step-payments
      • Autorización y captura
    • Voids & Refunds
      • Reembolsar una transacción
      • Anular y reversar
    • Card information
      • Consultar información de BIN
      • Información de BIN V2
      • Solicitar opciones de diferido
    • Query Transactions
      • Búsqueda de transacciones
    • Webhooks
      • Webhooks — Pagos con tarjeta
      • Webhooks — Reembolsos
      • Webhooks — Introducción
      • Buenas prácticas
      • Revisa tus webhooks
    • Chargebacks
      • Consultar chargebacks
      • Solicitar exportación de chargebacks
    • Fraud Report
      • Consultar alertas de fraude
  • Kushki One
    • Error Catalog
    • Release notes
    • Transaction Examples
    • Webhooks
    • Cloud Services
      • Payment
        • Sync
          • Charge
          • Authorization (Pre-auth)
          • Capture
          • Re-authorization
          • Post-tip
          • Void
          • Refund
          • Abort
        • Async
          • Charge (Async)
          • Authorization — Pre-auth (Async)
          • Capture (Async)
          • Re-authorization (Async)
          • Post-tip (Async)
          • Void (Async)
        • Search
          • Transaction Search
      • Print
        • Create Print Job
        • Get Print Job Status
    • Local Services
      • Payment
        • Sync
          • Charge
          • Authorization (Pre-auth)
          • Capture
          • Re-authorization
          • Post-tip
          • Void
          • Refund
          • Abort
        • Async
          • Charge (Async)
          • Authorization — Pre-auth (Async)
          • Capture (Async)
          • Re-authorization (Async)
          • Post-tip (Async)
          • Void (Async)
          • Abort (Async)
        • Search
          • Transaction Search — Online
          • Transaction Search — Local
      • Print
        • Create Print Job
        • Get Print Job Status
        • Print Job Webhook (inbound — implemented by your POS)
  • Appian - Submerchant Register
    • Release Notes
    • Submerchant Validation in Batch
    • Query submerchant status by requestId/submerchantId
    • Submerchant Document Upload
    • Get submerchantIds
    • Get credentials for submerchants
  • Schemas
    • RequestBodies
      • one-and-two-step-payment
    • Card
    • Channel
    • Amount-cash-in
    • ChargebackListResponse
    • TransactionResponse
    • PrintJobRequest
    • one-and-two-step-payment-2
    • Card Present (CP)
    • one-and-two-step-payment-2
    • SubscriptionTransactionsResponse
    • FraudAlertRequest
    • StatusComponent
    • SettlementDateRangeRequest
    • amount
    • ChargebackItem
    • SubscriptionTransaction
    • extra_taxes
    • RawResponse
    • CommandText
    • Card Not Present (CNP)
    • Deferred
    • networkToken
    • FraudAlertResponse
    • ErrorResponse400
    • SettlementRecord
    • card
    • CardData
    • CommandColumns
    • FraudAlertRecord
    • SettlementResponse
    • currency
    • webhooksItem
    • ErrorResponse
    • Country
    • ErrorResponse401
    • LinkFailure
    • ColumnItem
    • ValidationError
    • Amount
    • card_details
    • ErrorResponse403
    • enc_tlv
    • CommandDivider
    • TransactionEvent
    • extraTaxes
    • payment_method
    • ErrorResponse500
    • CommandFeed
    • TransactionStatus
    • deferred
    • CommandSpace
    • ReadingType
    • pos_details
    • ContactDetails
    • sub_merchant
    • CommandCut
    • FailureReason
    • contact_details
    • Subscription
    • metadata
    • CommandImage
    • EventTerminal
    • documentType
    • orderDetails
    • Language
    • TransactionSearchRequest
    • CommandQR
    • EventOperation
    • Shipping Address
    • payment_submethod
    • CommandBarcode
    • EventAmount
    • Billing-Address
    • SubscriptionUpdate
    • EventExtraTaxes
    • PrintJobAccepted
    • PrinterError
    • EventMetadata
    • SubscriptionAdjustmentRequest
    • product
    • AmountWithTaxes
    • PrintJobStatus
    • PrintJobStatusRequest
    • threeDomainSecure
    • AmountCore
    • webhooks
    • headers
    • ExtraTaxes
    • PrintWebhookPayload
    • webhooksChargeback
    • Metadata
    • AmountWithTip
    • citMit
    • TransactionSearchBody
    • TransactionSearchOnlineBody
    • network
    • binInfo
    • AmountWithOptionalTip
    • TransactionSearchLocalBody
    • TransactionEvent_2
    • messageFields
    • UnexpectedErrorResponse
    • FailureReason_2
    • transactionType
    • ExternalReferenceId
    • EventTerminal_2
    • ExternalSubscriptionId
    • EventOperation_2
    • EventAmount_2
    • EventExtraTaxes_2
    • EventMetadata_2
    • SettlementTicketRequest
HomePerú 🇵🇪México 🇲🇽
Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
HomePerú 🇵🇪México 🇲🇽
Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
  1. Online Payments

Errores ISO

Este catálogo de errores aplica únicamente al Modelo de Adquirencia Kushki, disponible para Colombia, Chile, México y Perú.
El campo isoErrorCode se devuelve en cargos únicos, preautorizaciones y cargos con un solo clic declinados cuando fullResponse está en v2, y puede provenir tanto de las franquicias de tarjetas como de los procesadores.
Nota

Si tiene el valor 228, corresponde a un rechazo interno de Kushki.
Si este código proviene de las franquicias de tarjetas (Visa, Mastercard o Prosa), tendrá dos dígitos. A continuación encontrarás los códigos de error más comunes:

Mastercard#

Código de error ISODescripción
00Aprobada o completada con éxito
01Consulta al emisor de la tarjeta
03Comercio no válido
04Retén la tarjeta
05No autorizada por el emisor
08Autoriza con identificación
10Aprobación parcial
12Transacción no válida
13Monto no válido
14Número de tarjeta no válido
15Emisor no válido
30Error de formato
41Tarjeta extraviada
43Tarjeta robada
51Fondos insuficientes o límite de crédito excedido
54Tarjeta vencida
55PIN no válido
57Transacción no permitida al emisor o al tarjetahabiente
58Transacción no permitida al adquirente o a la terminal
61Excede el límite de monto de retiro
62Tarjeta restringida
63Violación de seguridad
65Excede el límite de cantidad de retiros O soft-decline de Identity Check en la autenticación EMV 3DS (el comercio debe reenviar la autenticación con 3DSv1)
70Contacta al emisor de la tarjeta
71El emisor no cambió el PIN
75Se excedió el número de intentos de PIN permitidos
76La cuenta destino (“To Account”) indicada no es válida o no existe
77La cuenta origen (“From Account”) indicada no es válida o no existe
78La cuenta indicada no es válida o no existe (general)
79Ciclo de vida (uso exclusivo de Mastercard para mensajes 0110)
81Transacción de débito doméstica no permitida (solo uso regional)
82Política (uso exclusivo de Mastercard para mensajes 0110)
83Fraude o seguridad (uso exclusivo de Mastercard para mensajes 0110)
84Ciclo de vida de la autorización no válido
85No declinada. Válida para todas las transacciones de monto cero.
86No es posible validar el PIN
87Solo monto de compra, no se permite cash back
88Falla criptográfica
89PIN no aceptable— transacción declinada— reintenta
91El sistema de autorización o el sistema del emisor no está operativo
92No es posible enrutar la transacción
94Se detectó una transmisión duplicada
96Error del sistema

Visa#

Código de error ISODescripción
00Aprobada y completada con éxito. Aceptada y procesada
01Consulta al emisor de la tarjeta
02Consulta al emisor de la tarjeta, condición especial
03Comercio no válido
04Retén la tarjeta (sin fraude)
05No autorizada por el emisor
06Error
07Retén la tarjeta, condición especial (cuenta con fraude)
10Aprobación parcial
11Aprobada
12Transacción no válida
13Monto no válido o desbordamiento del campo de conversión de moneda
14Número de tarjeta no válido, no cumple la validación módulo 10, longitud no válida para el emisor o no está en el archivo positivo de verificación de PIN, o el separador está en la posición incorrecta
15El emisor no existe (los primeros 8 dígitos del número de cuenta no corresponden a un identificador de emisor)
19Vuelve a ingresar la transacción
21No se realizó ninguna acción
25No es posible ubicar el registro en el archivo
28El archivo no está disponible temporalmente para actualización o consulta
39Sin cuenta de crédito
41Tarjeta extraviada, retén la tarjeta (cuenta con fraude)
43Tarjeta robada, retenla (cuenta con fraude)
46Cuenta cerrada
51Fondos insuficientes
52Sin cuenta corriente
53Sin cuenta de ahorros
54Tarjeta vencida o falta la fecha de expiración
55PIN incorrecto o ausente
57Lo usa el switch cuando la función solicitada no está permitida para el producto o el tipo de tarjeta
58Transacción no permitida en la terminal
59Sospecha de fraude
61Excede el límite de monto de aprobación
62Tarjeta restringida (no válida en la región o el país)
63Violación de seguridad (el origen no es el emisor correcto)
64La transacción no cumple el requisito AML
65Excede el límite de frecuencia de retiros
70Se requieren los datos del PIN
74Valor distinto al usado para los errores de cifrado del PIN
75Se excedió el número de intentos de ingreso de PIN permitidos
76Reversa no solicitada: reversa sin transacción original en el historial. V.I.P. no pudo asociar la solicitud de reversa con un mensaje original
78Bloqueada, primer uso o condición especial—tarjetahabiente nuevo sin activar o tarjeta bloqueada temporalmente
79Reversada (por el switch)
80Sin impacto financiero (se usa en respuestas de reversa a originales declinadas)
81Error criptográfico en el PIN (se usa para la condición de error criptográfico detectada por el módulo de seguridad durante el descifrado del PIN)
82Resultados negativos en línea de CAM, dCVV, iCVV, CVV, CAVV, dCVV2, TAVV o DTVV, o autenticación de PIN offline interrumpida
85Sin motivo para declinar una solicitud de verificación de dirección, verificación de CVV2, comprobante de crédito o devolución de mercadería
86No se puede verificar el PIN; por ejemplo, no hay PVV
91Emisor no disponible o switch no operativo (STIP no aplica o no está disponible para esta transacción). Time-out cuando no hay STIP. Autorizaciones de comprobante de crédito y devolución de mercadería: V.I.P. envió la transacción al emisor, pero el emisor no estaba disponible. Los adquirentes que reciban este código deben enviar las transacciones de nuevo. No se crean avisos. Los emisores pueden responder con este código, que V.I.P. transmite al adquirente sin invocar STIP. Los emisores lo usan para indicar que no pueden realizar la autorización en nombre del emisor.Provoca el rechazo en el POS.
92No se encuentra la institución financiera ni la red intermedia para el enrutamiento (el ID de la institución receptora no es válido)
93La transacción no se puede completar- violación de la ley.
94Transmisión duplicada. Se envió una transacción con valores en los campos de trazabilidad que duplican los de una transacción enviada previamente.
96Falla del sistema
1ASe requiere autenticación adicional del cliente
6PLos datos de verificación fallaron
B1Monto de recargo no permitido en tarjetas Visa ni en EBT food stamps (solo adquirentes de EE. UU.)
N0Force STIP. Los emisores pueden responder con este código, que enruta las transacciones a STIP. Lo usan cuando no pueden realizar la autorización pero quieren que STIP la realice.
N3Servicio de efectivo no disponible
N4La solicitud de efectivo excede el límite del emisor o el límite aprobado
N7Declinada por falla del CVV2
N8El monto de la transacción excede el monto aprobado en la preautorización
P5Desbloqueo de PIN denegado: el emisor declinó la solicitud de cambio o desbloqueo del PIN
P6Cambio de PIN denegado: el PIN solicitado no es seguro
Q1Falló la autenticación de la tarjeta o se interrumpió la autenticación de PIN offline
R0Orden de suspensión de pago
R1Orden de revocación de la autorización
R2La transacción no califica para Visa PIN
R3Orden de revocación de todas las autorizaciones
Z3No es posible conectarse en línea; declinada offline

Prosa#

Código de error ISODescripción
00Aprobada o completada con éxito
01Consulta al emisor de la tarjeta
02Consulta las condiciones especiales del emisor de la tarjeta
03Comercio no válido
04Retén la tarjeta
05No autorizada por el emisor
06Error
07Retén la tarjeta, condición especial
09Solicitud en proceso (duplicada)
10Aprobada parcialmente
11Aprobada (VIP) *
12Transacción no válida
13Monto no válido
14Número de tarjeta no válido (el número no existe)
15El emisor no existe
30Error de formato
31Banco no soportado por el switch
33Tarjeta vencida
34Sospecha de fraude
35El aceptante de la tarjeta debe contactar al adquirente
36Tarjeta restringida
37El aceptante de la tarjeta debe llamar a seguridad del adquirente
38Se excedieron los intentos de PIN permitidos
39Sin cuenta de crédito
41Tarjeta extraviada
43Tarjeta robada, retenla
51Fondos insuficientes
54Tarjeta vencida
55Número de identificación personal incorrecto *
56Sin registro de la tarjeta
57Transacción no permitida al tarjetahabiente
58Transacción no permitida a la terminal
61Excede el límite de monto de retiro
62Tarjeta restringida
65Excede el límite de frecuencia de retiros
75Se excedió el número de intentos de PIN permitidos *
76Reservado para uso privado o aprobada country club *
77Reservado para uso privado o aprobada pendiente de identificación (firma el comprobante en papel)*
78Reservado para uso privado o aprobada a ciegas *
79Reservado para uso privado o transacción administrativa aprobada *
80Reservado para uso privado o aprobada, coincidencia en el archivo negativo nacional OK *
81Reservado para uso privado o aprobada comercial *
82Reservado para uso privado o sin módulo de seguridad
83Reservado para uso privado o sin cuentas
84Reservado para uso privado o sin PBF *
85Reservado para uso privado o error al actualizar el PBF *
86Reservado para uso privado o tipo de autorización no válido
87Reservado para uso privado o datos de banda incorrectos
88Reservado para uso privado o error de PTLF *
89Reservado para uso privado o servicio de ruteo no válido
91El corte está en proceso: el switch está cerrando el día y comenzando el siguiente (puedes reenviar la transacción en unos minutos). El emisor o el switch no está operativo
92No se encuentra la institución financiera ni la red intermedia para el enrutamiento
94Transmisión duplicada
96Falla del sistema
N0Reservado para uso privado o no es posible autorizar
N1Reservado para uso privado o longitud del PAN no válida
N2Reservado para uso privado o preautorización completa
N3Reservado para uso privado o se alcanzó el máximo de reembolsos en línea
N4Reservado para uso privado o se alcanzó el máximo de reembolsos offline
N5Reservado para uso privado o crédito máximo por reembolso
N6Reservado para uso privado o se alcanzó el crédito máximo de reembolso
N7Reservado para uso privado o motivo del archivo negativo seleccionado por el cliente
N8Reservado para uso privado o excede el floor limit
N9Reservado para uso privado o número máximo de créditos por reembolso
O0Reservado para uso privado o archivo de referidos lleno
O1Reservado para uso privado o problema con el archivo NEG *
O2Reservado para uso privado o avance menor al mínimo
O3Reservado para uso privado o en mora
O4Reservado para uso privado o excede la tabla de límites
OSReservado para uso privado o se requiere PIN *
O6Reservado para uso privado o validación módulo 10
O7Reservado para uso privado o forzar el posteo
O8Reservado para uso privado o PBF incorrecto *
O9Reservado para uso privado o problema con el archivo NEG *
P0Reservado para uso privado o problema con el CAF *
P1Reservado para uso privado o excede el límite diario *
P2Reservado para uso privado o CAPF no encontrado *
P3Reservado para uso privado o avance menor al mínimo
P4Reservado para uso privado o número de veces utilizada
PSReservado para uso privado o en mora
P6Reservado para uso privado o excede la tabla de límites
P7Reservado para uso privado o avance menor al mínimo
P8Reservado para uso privado o se requiere tarjeta administrativa
P9Reservado para uso privado o ingresa un monto menor
Q0Reservado para uso privado o fecha de transacción no válida
Q1Reservado para uso privado o fecha de expiración no válida
Q2Reservado para uso privado o código de transacción no válido
Q3Reservado para uso privado o avance menor al mínimo
Q4Reservado para uso privado o número de veces utilizada
Q5Reservado para uso privado o en mora
Q6Reservado para uso privado o excede la tabla de límites
Q7Reservado para uso privado o monto superior al máximo
Q8Reservado para uso privado o tarjeta administrativa no encontrada
Q9Reservado para uso privado o tarjeta administrativa no permitida
R0Reservado para uso privado o solicitud administrativa aprobada realizada dentro de la ventana *
R1Reservado para uso privado o solicitud administrativa aprobada realizada fuera de la ventana *
R2Reservado para uso privado o solicitud administrativa aprobada realizada en cualquier momento *
R3Reservado para uso privado o chargeback, archivo del cliente actualizado
R4Reservado para uso privado o chargeback, archivo del cliente actualizado, adquirente no encontrado
R5Reservado para uso privado o chargeback, número de prefijo incorrecto
R6Reservado para uso privado o chargeback, código de respuesta o configuración del CPF incorrectos
R7Reservado para uso privado o transacciones administrativas no soportadas
R8Reservado para uso privado o tarjeta en el archivo negativo nacional *
S4PTLF lleno *
S5Reservado para uso privado o chargeback aprobado, archivo del cliente sin actualizar
S6Reservado para uso privado o chargeback aprobado, archivo del cliente sin actualizar, adquirente no encontrado
S7Reservado para uso privado o chargeback aceptado, destino incorrecto
S8Reservado para uso privado o problema con el archivo ADMN
S9Reservado para uso privado o no es posible validar el PIN; el módulo de seguridad está caído *
T1Reservado para uso privado o monto de avance con tarjeta de crédito no válido
T2Reservado para uso privado o fecha de transacción no válida
T3Reservado para uso privado o tarjeta no soportada
T4Reservado para uso privado o monto superior al máximo
T5Reservado para uso privado o estado del CAF = 0 o 9 *
T6Reservado para uso privado o UAF incorrecto *
T7Reservado para uso privado o el cash back excede el límite diario
T8Reservado para uso privado o cuenta no válida
U0Declinada por falla de ARQC *
U1Error de parámetros del módulo de seguridad *
U2Falla del módulo de seguridad *
U3Registro KEY1 no encontrado *
U4Falla en la validación del ATC *
U5Declinada por CVR *
U6Declinada por TVR *
U7Declinada por el código de motivo en línea *
U8Declinada por fallback *
V0Referida por falla de ARQC *
V1Referida por CVR *
V2Referida por TVR *
V3Referida por el código de motivo en línea *
V4Referida por fallback *
V7Captura por falla de ARQC *
V8Captura por CVR *
V9Captura por TVR *
40Comando rechazado
R9Destino no disponible
17Cancelación del cliente
22Sospecha de falla
S0Reversa sospechosa
68Respuesta recibida demasiado tarde
64Monto original incorrecto
S1Anulación de reversa sospechosa
S2Reversa por dispensación incorrecta
95Error de conciliación
Modified at 2026-09-11 14:42:06
Previous
Online Payments
Next
Errores del API de Kushki
Built with