1. Online Payments
Español
  • English
  • Español
  • Docs para desarrolladores 🇪🇨
  • Online Payments
    • Notas de versión
    • Errores del API de Kushki
    • Card Payments
      • Solicitar un token de tarjeta
      • Hacer un cargo o cargo diferido
      • Reembolsar una transacción
      • Anular una transacción
      • Solicitar opciones de diferido
      • Validar OTP
      • Información de BIN V2
      • Información de BIN
    • One Click and Scheduled Payments
      • Solicitar un token de cargo recurrente
      • Crear un cargo recurrente
      • Actualizar los datos de la tarjeta del cargo recurrente
      • Hacer un pago One-click
      • Cancelar un cargo recurrente
      • Actualizar un cargo recurrente
      • Agregar un cargo o descuento temporal
      • Consultar información del cargo recurrente
    • Chargebacks
      • Consultar chargebacks
      • Solicitar exportación de chargebacks
    • Subscription Transactions
      • Consultar transacciones de suscripción
    • Cash in
      • Solicitar un token de Cash In
      • Iniciar transacción
      • Actualizar una transacción de Cash In
      • Estado de la transacción
      • Eliminar una transacción de Cash In
    • Transfer in
      • Solicitar un token de Transfer In
      • Iniciar transacción
      • Consultar estado
    • Analytics
      • Consultar listado de transacciones v2
    • Smartlinks
      • Crear un Smartlink
      • Actualizar un Smartlink
      • Consultar un Smartlink
      • Eliminar un Smartlink
    • Status
      • Consultar estado del gateway
      • Consultar estado de la plataforma
    • Commissions
      • Consultar configuración de comisiones
    • Payment Credentials
      • Crear una credencial
      • Buscar credenciales
      • Activar o desactivar
      • Eliminar credencial
      • Actualizar credencial
      • Regenerar una credencial
      • Búsqueda avanzada
    • Payment Button
      • Crear un Payment Button
    • Settlement
      • Consultar liquidación
  • Appian - Submerchant Register
    • Release Notes
    • Submerchant Validation in Batch
    • Query submerchant status by requestId/submerchantId
    • Get submerchantIds
    • Get credentials for submerchants
  • Schemas
    • threeDomainSecure
    • Card-old
    • Channel
    • SubscriptionTransactionsResponse
    • Card Present (CP)
    • Amount-cash-in
    • webhooks
    • ChargebackListResponse
    • StatusComponent
    • SettlementDateRangeRequest
    • Card
    • networkToken
    • ChargebackItem
    • SettlementRecord
    • Card Not Present (CNP)
    • currency
    • ErrorResponse
    • SubscriptionTransaction
    • Subscription
    • Amount
    • ErrorResponse400
    • SettlementResponse
    • Country
    • Deferred
    • extraTaxes
    • ErrorResponse401
    • Language
    • ErrorResponse403
    • Metadata
    • payment_method
    • ErrorResponse500
    • ContactDetails
    • orderDetails
    • Shipping Address
    • Billing-Address
    • payment_submethod
    • SubscriptionUpdate
    • documentType
    • SubscriptionAdjustmentRequest
    • threeDomainSecure
    • webhooks
    • headers
    • webhooksChargeback
    • citMit
    • network
    • binInfo
    • messageFields
    • UnexpectedErrorResponse
    • ExternalReferenceId
    • product
    • transactionType
    • SettlementTicketRequest
HomePerú 🇵🇪México 🇲🇽Ecuador 🇪🇨
Colombia 🇨🇴Chile 🇨🇱
HomePerú 🇵🇪México 🇲🇽Ecuador 🇪🇨
Colombia 🇨🇴Chile 🇨🇱
  1. Online Payments

Errores del API de Kushki

Conoce los errores más comunes y cómo resolverlos.

Códigos de estado HTTP#

Kushki puede devolver distintos códigos de estado HTTP según las solicitudes que realices. A continuación encontrarás los códigos de estado HTTP más comunes, su mensaje estándar asociado y una descripción más detallada de la respuesta.
CódigoMensajeDetalle
200OKEl proceso fue exitoso. Todo funcionó como se esperaba, según el método HTTP
400Bad RequestEl servidor no puede interpretar la solicitud (sintaxis incorrecta, tamaño excesivo, parámetros faltantes)
401Authorization RequiredLas credenciales deben autenticarse, o la autenticación falló
403ForbiddenNo tienes los permisos necesarios para realizar esta acción
404Not FoundNo se encontró el recurso o la página
409ConflictLa solicitud no se puede procesar por un conflicto con el recurso (por ejemplo, varias actualizaciones simultáneas)
410GoneEl recurso solicitado se eliminó del servidor y ya no estará disponible
429Too Many RequestsSe enviaron demasiadas solicitudes en un periodo corto de tiempo
430Request Header Fields Too LargeCódigo no oficial, aplica solo a Shopify. Similar al código 429
500Internal Server ErrorOcurrió un error inesperado del lado del servidor
502Bad GatewayEl servidor (actuando como proxy o gateway) recibió una respuesta no válida de otro servidor
503Service Temporarily UnavailableEl servidor no está disponible (normalmente porque está en mantenimiento o porque está sobrecargado)
504Gateway TimeoutEl servidor (actuando como proxy o gateway) no recibió a tiempo la respuesta del otro servidor

Códigos devueltos por el API#

Nota: Para una referencia completa de los códigos de error que puedes recibir en transacciones con tarjeta de crédito, consulta Error codes.
CódigoTexto de respuesta (español)Descripción
004INFORMACIÓN DE CUENTA NO VÁLIDASi algún dato de la tarjeta no es válido, se produce este error.
005NÚMERO DE CUENTA NO VÁLIDOSi el número de cuenta (número de tarjeta) no es válido, se produce este error.
006TRANSACCIÓN RECHAZADACuando el procesador rechaza la transacción, se produce este error. Llega con distintos mensajes según el error.
007CVC NO VÁLIDOSi el CVV de la tarjeta no es válido, se produce este error.
017TARJETA NO VÁLIDACuando el número de tarjeta no es válido, se produce este error.
018TARJETA VENCIDACuando se usa una tarjeta vencida, se produce este error.
019FONDOS INSUFICIENTES PARA REMBOLSOSCuando el reembolso solicitado es mayor que el monto del cargo, se produce este error.
022TIPO DE TARJETA NO COMPATIBLE POR MRCCuando el tipo de tarjeta está deshabilitado en la configuración del comercio y la transacción llega con esa tarjeta, se produce este error.
023FECHA DE EXPIRACIÓN NO VÁLIDACuando la fecha de expiración no es válida, se produce este error.
201ID DE COMERCIO NO VÁLIDOCuando el ID del comercio no es válido, se produce este error.
202TIPO DE TRANSACCIÓN NO VÁLIDOCuando el tipo de transacción no es válido, se produce este error.
203MONTO DE TRANSACCIÓN NO VÁLIDOCuando el monto de la transacción no es válido, se produce este error.
205TIPO DE MONEDA NO VÁLIDACuando el código de moneda de la transacción no es válido, se produce este error.
207ID DE TRANSACCIÓN NO VÁLIDOCuando el número de ticket de la transacción no es válido, se produce este error.
211SOLICITUD NO VÁLIDASi la solicitud no tiene el formato correcto, por ejemplo sin encriptar o con JSON no válido
212INFORMACIÓN ENCRIPTADA NO VÁLIDACuando la solicitud encriptada no es válida, se produce este error.
215EL COMERCIO NO TIENE PERMISO PARA PROCESAR UNA TRANSACCIÓNCuando deshabilitamos una transacción en la configuración del comercio, se produce este error.
216TRANSACCIÓN REEMBOLSADACuando se solicita un reembolso sobre una transacción ya reembolsada, se produce este error.
219EL MONTO ES CEROCuando el monto de la solicitud es cero, se produce este error.
220MONTO DE LA TRANSACCIÓN ES DIFERENTE AL MONTO DE LA VENTA INICIALCuando el monto de la transacción no coincide entre el token, el cargo o el init, se produce este error.
222TRANSACCIÓN NO ENCONTRADACuando el número de ticket de la transacción no se encuentra en nuestra base de datos, se produce este error.
223TRANSACCIÓN NO SOPORTADACuando la transacción no está soportada por Kushki ni por el procesador, se produce este error
225TIPO DE TRANSACCIÓN NO VÁLIDOCuando el tipo de transacción no es válido, se produce este error.
226PROCESADOR CC NO ASIGNADOCuando el procesador de crédito no se asignó al comercio durante la configuración, se produce este error.
228PROCESADOR INALCANZABLECuando no podemos conectarnos con el procesador, se produce este error.
229EL COMERCIO NO SOPORTA LA TRANSACCIÓNCuando el comercio no soporta la transacción, se produce este error.
231ANULACIÓN DE VENTA NO PERMITIDACuando se intenta anular una venta que ya fue reembolsada, se produce este error.
238TRANSACCÓN ANULADACuando se intenta anular una transacción que ya está anulada, se produce este error.
277INDICADOR DE IDIOMA NO VÁLIDOCuando el indicador de idioma no es válido, se produce este error.
322TRANSACCIÓN NO PERMITIDACuando el comercio no permite la transacción, se produce este error.
478SERVIDOR NO DISPONIBLECuando hay algún problema de conectividad con el servidor, se produce este error.
509EL MONTO INGRESADO ES MAYOR O MENOR A LO PERMITIDOCuando el monto de la transacción es menor o mayor al monto permitido, se produce este error.
577EL TOKEN DE LA TRANSACCIÓN NO ES VÁLIDOCuando el token de la transacción no es válido o no existe en la base de datos, se produce este error.
578EL TOKEN DE LA TRANSACCIÓN HA EXPIRADOCuando la transacción se intenta más de 30 minutos después de generar el token, o cuando el token se reutiliza en otra transacción, se produce este error.
579TRANSACCIÓN RECHAZADACuando no podemos procesar la solicitud, se produce este error.
597NO HAY RESPUESTA DEL PROCESADORCuando no recibimos respuesta del procesador, se produce este error.
701EL TOKEN DE LA TRANSACCIÓN ES REQUERIDOCuando no se envía el token de la transacción en la venta, se produce este error.
702EL MONTO DE LA TRANSACCIÓN NO ES VÁLIDOCuando se envía un monto no válido, se produce este error.
703EL MONTO DE LA TRANSACCIÓN ES REQUERIDOCuando no se envía el monto de la transacción, se produce este error.
704EL NÚMERO DE TICKET DE LA TRANSACCIÓN NO ES VÁLIDOCuando se envía un número de ticket no válido, se produce este error.
705EL NÚMERO DE TICKET DE LA TRANSACCIÓN ES REQUERIDOCuando no se envía el número de ticket, se produce este error.
706LA CANTIDAD DE MESES ES REQUERIDACuando no se envía la cantidad de meses en la transacción diferida, se produce este error.
707LA CANTIDAD DE MESES NO ES VÁLIDACuando se envía una cantidad de meses no válida en la transacción diferida, se produce este error.
710EL COMERCIO NO HA SIDO ENCONTRADOCuando no se encuentra el comercio, se produce este error.
890DATOS NO ENCONTRADOSCuando no hay datos para la cookie, se produce este error.
1000EL ID DE LA TARJETA ES REQUERIDACuando no se envía el token de la tarjeta, se produce este error.
1001EL TOKEN DE LA TARJETA NO ES VÁLIDOCuando el token de la tarjeta enviado no es válido, se produce este error.
1002EL NOMBRE DEL CONSUMIDOR ES REQUERIDOCuando no se envía el nombre del cliente, se produce este error.
1003EL NOMBRE DEL CONSUMIDOR NO ES VÁLIDOCuando el nombre del cliente enviado no es válido, se produce este error.
1004EL APELLIDO DEL CONSUMIDOR ES REQUERIDOCuando no se envía el apellido del cliente, se produce este error.
1005EL APELLIDO DEL CONSUMIDOR NO ES VÁLIDOCuando el apellido del cliente enviado no es válido, se produce este error.
1006NOMBRE DEL PLAN ES REQUERIDOCuando no se envía el nombre del plan, se produce este error.
1007NOMBRE DEL PLAN NO ES VÁLIDOCuando el nombre del plan enviado no es válido, se produce este error.
1008FECHA DE INICIO ES REQUERIDACuando no se envía la fecha de inicio, se produce este error.
1009FECHA DE INICIO NO ES VÁLIDACuando la fecha de inicio enviada no es válida, se produce este error.
1014EL TIPO DE AJUSTE NO ES VÁLIDOCuando el tipo de ajuste enviado no es válido, se produce este error.
1015LA FECHA DE AJUSTE NO ES VÁLIDACuando la fecha de ajuste enviada no es válida, se produce este error.
1016EL MONTO DE AJUSTE NO ES VÁLIDOCuando el monto de ajuste enviado no es válido, se produce este error.
1017LOS PERIODOS DE AJUSTE NO SON VÁLIDOSCuando los periodos de ajuste enviados no son válidos, se produce este error.
1018NO ES POSIBLE AGREGAR SUBSCRIPCIÓNCuando ocurre un error de red al insertar la suscripción, se produce este error.
1019TOKEN DE SUBSCRIPCIÓN NO ENCONTRADOCuando el token de la suscripción no existe en la base de datos, se produce este error.
1020ERROR EN LA CREACIÓN DE LA SUBSCRIPCIÓNCuando ocurre un error al crear la suscripción, se produce este error.
1021EL ID DE SUBSCRIPCIÓN ES REQUERIDOCuando no se envía el ID de la suscripción, se produce este error.
1022EL ID DE SUBSCRIPCIÓN NO ES VÁLIDOCuando el ID de la suscripción enviado no es válido, se produce este error.
1023EL CAMPO "PLANID" NO ES VALIDOCuando el ID del plan enviado no es válido, se produce este error.
1024LA FECHA DE FINALIDAD NO ES VÁLIDACuando la fecha de fin enviada no es válida, se produce este error.
1025DIA DEL MES NO ES VÁLIDOCuando el día del mes enviado no es válido, se produce este error.
1026ERROR AL ELIMINAR LA SUBSCRIPCIÓNCuando falla la cancelación de la suscripción, se produce este error.
1027ID DE SUBSCRIPCIÓN NO ENCONTRADOCuando el ID de la suscripción no existe en la base de datos, se produce este error.
1028ERROR AL ACTUALIZAR LA SUBSCRIPCIÓNCuando falla la actualización de la suscripción, se produce este error.
1029TOKEN DE SUBSCRIPCIÓN EXPIRADOCuando el token está en uso, se produce este error.
1031LA FECHA DE FIN ES REQUERIDACuando la fecha de fin no es válida, se produce este error.
1032NO HAY SUSCRIPCIONES PARA ID DE COMERCIOCuando no hay suscripciones en la base de datos para el ID de comercio consultado, se produce este error.
1033AJUSTE NO VÁLIDO: MONTO SUBTOTALIVACuando el monto SUBTOTAL_IVA del objeto Amount del ajuste no es válido, se produce este error.
1034AJUSTE NO VÁLIDO: MONTO IVACuando el monto IVA del objeto Amount del ajuste no es válido, se produce este error.
1035AJUSTE NO VÁLIDO: MONTO SUBTOTALIVA0Cuando el monto SUBTOTAL_IVA0 del objeto Amount del ajuste no es válido, se produce este error.
1036AJUSTE NO VÁLIDO: MONTO ICECuando el monto ICE del objeto Amount del ajuste no es válido, se produce este error.
CódigoMensaje (español)Descripción
K001EL CUERPO DE LA PETICIÓN ES INVÁLIDOCuerpo de la solicitud mal formado
K002HA OCURRIDO UN ERROR INESPERADOOcurrió un error no identificado; contacta a soporte.
K003TARJETA NO HABILITADA POR EL EMISORBIN deshabilitado para comercio electrónico
K004ID DE COMERCIO O CREDENCIAL NO VÁLIDOEl ID de acceso del comercio no es válido
K005TOKEN EXPIRADOEl token expiró o se reutilizó en otra transacción
K006MONTO NO ES IGUAL AL ESPERADOEl monto enviado es distinto al monto cobrado.
K007ESTE RECIBO YA FUE PAGADOEl recibo ya fue pagado
K008ESTE RECIBO YA FUE CANCELADOEl recibo ya fue cancelado
K009RECIBO EXPIRADOEl recibo expiró
K010TICKET NUMBER INVÁLIDOEl número de ticket no se envió correctamente en la solicitud
K011CREDENCIALES INVÁLIDASCuando las credenciales no son correctas, se produce este error
K012ACCESO NO AUTORIZADOEl token de autenticación está vencido o es incorrecto
K013TRANSACCIÓN TOKENIZADA COMO DIFERIDOLa solicitud de token se generó para una transacción diferida, pero la información del diferido no se incluyó en la solicitud de cargo.
K014TOKEN INVÁLIDOEl token de transacción utilizado no es el correcto
K015Transacción no permitida sin ccv2.Debes enviar el cvv, o revisar la configuración del comercio para permitir cargos recurrentes sin cvv
K020TRANSACCIÓN RECHAZADACuando no podemos procesar la transacción, se produce este error
K021TRANSACCIÓN RECHAZADACuando el sistema antifraude rechaza la transacción, se produce este error
K023MONTO DEL VOID SUPERIOR AL DEL SALEEste mensaje aparece cuando el monto de la anulación parcial es mayor que el monto de la venta
K051Transacción de captura realizada anteriormenteLa transacción de captura ya se procesó anteriormente
K055Tipo de moneda no permitidoEl tipo de moneda enviado en la solicitud no es válido para el país del comercio.
K322TRANSACCIÓN RECHAZADACuando no podemos procesar la transacción por una regla de seguridad, se produce este error
K325Autenticación externa fallida - Datos enviados por comercio no son segurosTransacción 3DS insegura sin el campo acceptRisk en true
K505La transacción fue declinada por el procesador o emisor.Tarjeta bloqueada. Usa otra tarjeta.
K555Solicitud enviada no es válidaVerifica que la información requerida se envíe correctamente.

Respuestas de error de chargebacks#

CódigoMensaje (español)Descripción
CCH001Cuerpo de la petición inválido.Cuerpo de la solicitud mal formado
CCH010Fechas inválidasFechas no válidas al obtener la lista de chargebacks

Respuestas de error de Get transaction List#

CódigoMensaje (español)Descripción
ANL001Cuerpo de la petición inválido.Cuerpo de la solicitud mal formado
ANL005Error en la consultaLos filtros usados para consultar las transacciones podrían estar mal
Modified at 2026-09-11 14:46:59
Previous
Notas de versión
Next
Card Payments
Built with