1. Online Payments
Español
  • English
  • Español
  • Docs de API 🇨🇴
  • Online Payments
    • Errores del API de Kushki
    • Errores ISO
    • Notas de versión
    • Card Payments
      • Solicitar un token de tarjeta
      • Hacer un cargo o cargo diferido
      • Crear pago (sin token)
      • Anular una transacción
      • Reembolsar una transacción
      • Solicitar opciones de diferido
      • Autorizar pagos
      • Preautorización (sin token)
      • Reautorizar pagos
      • Capturar un pago autorizado
      • Verificar cuenta
      • Validar OTP
      • Información de BIN
      • Información de BIN V2
    • One-Click & 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
    • Chargebacks
      • Consultar chargebacks
      • Solicitar exportación de chargebacks
    • Transfer in
      • Consultar lista de bancos
      • Solicitar un token de Transfer In
      • Iniciar transacción
      • Consultar estado
      • Cancelar transacción
    • 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
    • Cash in
      • Solicitar un token de Cash In
      • Iniciar transacción
      • Estado de la transacción
      • Eliminar una transacción de Cash In
      • Actualizar una transacción de Cash In
    • Cash-out
      • Solicitar un token de Cash Out
      • Iniciar transacción
      • Estado de la transacción
      • Actualizar una transacción de Cash Out
      • Eliminar una transacción de Cash Out
    • Smartlinks-v2
      • Crear un Smartlink
      • Consultar un Smartlink
      • Actualizar un Smartlink
      • Eliminar un Smartlink
    • Analytics
      • Consultar listado de transacciones v2
    • Gateway-status
      • Consultar estado del gateway
      • Consultar estado de la plataforma
    • Payment Credentials
      • Crear una credencial
      • Buscar credenciales
      • Búsqueda avanzada
      • Eliminar credencial
      • Regenerar una credencial
      • Activar o desactivar
      • Actualizar credencial
    • Payment Button
      • Crear un Payment Button
    • Settlement
      • Consultar liquidación
    • Subscription Transactions
      • Consultar transacciones de suscripción
    • 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)
  • API Raw Card Present Payments
    • Notas de versión
    • Catálogo de errores
    • El objeto Amount
    • Proceso de intercambio de llaves
    • Datos de prueba
    • One-time Payments
      • Pago único
    • Two-step Payments
      • Autorización y captura
    • Card Information
      • Consultar información de BIN
      • Información de BIN V2
      • Solicitar opciones de diferido
    • Voids & Refunds
      • Anular y reversar
      • Reembolsar una transacción
    • Query Transactions
      • Búsqueda de transacciones
    • Webhooks
      • Introducción
      • Buenas prácticas
      • Webhooks-Pagos con tarjeta
      • Webhooks-Reembolsos
      • Revisa tus webhooks
    • Chargebacks
      • Consultar chargebacks
      • Solicitar exportación de chargebacks
    • Fraud Report
      • Consultar alertas de fraude
  • Appian - Submerchant Register
    • Release Notes
    • Submerchant Validation in Batch
    • Query submerchant status by requestId/submerchantId
    • Get submerchantIds
    • Get credentials for submerchants
  • Schemas
    • RequestBodies
      • one-and-two-step-payment
    • Card
    • Channel
    • ChargebackListResponse
    • TransactionResponse
    • PrintJobRequest
    • card
    • one-and-two-step-payment-3
    • Card Present (CP)
    • one-and-two-step-payment-3
    • SubscriptionTransactionsResponse
    • Amount-cash-in
    • SettlementDateRangeRequest
    • amount
    • FraudAlertRequest
    • SubscriptionTransaction
    • ChargebackItem
    • SettlementRecord
    • RawResponse
    • CommandText
    • Card Not Present (CNP)
    • networkToken
    • FraudAlertResponse
    • ErrorResponse400
    • CardData
    • CommandColumns
    • extra_taxes
    • FraudAlertRecord
    • ErrorResponse
    • currency
    • Deferred
    • webhooksItem
    • SettlementResponse
    • ErrorResponse401
    • LinkFailure
    • ColumnItem
    • Amount
    • ValidationError
    • pos_details
    • ErrorResponse403
    • CommandDivider
    • enc_tlv
    • TransactionEvent
    • extraTaxes
    • card_details
    • Country
    • payment_method
    • ErrorResponse500
    • CommandFeed
    • TransactionStatus
    • deferred
    • CommandSpace
    • ReadingType
    • contact_details
    • ContactDetails
    • CommandCut
    • sub_merchant
    • FailureReason
    • CommandImage
    • metadata
    • EventTerminal
    • documentType
    • Subscription
    • orderDetails
    • Language
    • TransactionSearchRequest
    • CommandQR
    • EventOperation
    • Shipping Address
    • payment_submethod
    • CommandBarcode
    • EventAmount
    • Billing-Address
    • EventExtraTaxes
    • PrintJobAccepted
    • PrinterError
    • EventMetadata
    • SubscriptionUpdate
    • AmountWithTaxes
    • PrintJobStatus
    • PrintJobStatusRequest
    • threeDomainSecure
    • SubscriptionAdjustmentRequest
    • AmountCore
    • product
    • webhooks
    • headers
    • ExtraTaxes
    • PrintWebhookPayload
    • Metadata
    • webhooksChargeback
    • 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
    • ErrorResponse
    • TransactionEvent_23
    • TransactionStatus4
    • ReadingType5
    • FailureReason_26
    • EventTerminal_27
    • EventOperation_28
    • EventAmount_29
    • EventMetadata_210
    • EventExtraTaxes_211
    • PrintWebhookPayload12
    • TransactionEvent13
    • FailureReason14
    • EventTerminal15
    • EventOperation16
    • EventAmount17
    • EventMetadata18
    • EventExtraTaxes19
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 hagas. 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 FoundRecurso o página no encontrada
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ÁLIDASe produce si algún dato de la tarjeta no es válido.
005NÚMERO DE CUENTA NO VÁLIDOSe produce si el número de cuenta (número de tarjeta) no es válido.
006TRANSACCIÓN RECHAZADASe produce cuando el procesador rechaza la transacción. Llega con distintos conjuntos de mensajes según el error.
007CVC NO VÁLIDOSe produce si el CVV de la tarjeta no es válido.
017TARJETA NO VÁLIDASe produce cuando el número de tarjeta no es válido.
018TARJETA VENCIDASe produce cuando se usa una tarjeta vencida.
019FONDOS INSUFICIENTES PARA REMBOLSOSSe produce cuando la transacción de reembolso llega por un monto mayor que la del cargo.
022TIPO DE TARJETA NO COMPATIBLE POR MRCSe produce cuando el tipo de tarjeta está deshabilitado en la configuración del comercio y la transacción llega con esa tarjeta.
023FECHA DE EXPIRACIÓN NO VÁLIDASe produce cuando la fecha de expiración no es válida.
201ID DE COMERCIO NO VÁLIDOSe produce cuando el ID del comercio no es válido.
202TIPO DE TRANSACCIÓN NO VÁLIDOSe produce cuando el tipo de transacción no es válido.
203MONTO DE TRANSACCIÓN NO VÁLIDOSe produce cuando el monto de la transacción no es válido.
205TIPO DE MONEDA NO VÁLIDASe produce cuando el código de moneda de la transacción no es válido.
207ID DE TRANSACCIÓN NO VÁLIDOSe produce cuando el ticket number de la transacción no es válido.
211SOLICITUD NO VÁLIDASe produce si la solicitud no tiene el formato correcto, por ejemplo sin encriptar o con JSON no válido
212INFORMACIÓN ENCRIPTADA NO VÁLIDASe produce cuando la solicitud encriptada no es válida.
215EL COMERCIO NO TIENE PERMISO PARA PROCESAR UNA TRANSACCIÓNSe produce cuando deshabilitamos una transacción en la configuración del comercio.
216TRANSACCIÓN REEMBOLSADASe produce cuando se reembolsa una transacción que ya había sido reembolsada.
219EL MONTO ES CEROSe produce cuando el monto enviado en la solicitud es cero.
220MONTO DE LA TRANSACCIÓN ES DIFERENTE AL MONTO DE LA VENTA INICIALSe produce cuando el monto de la transacción no coincide entre el token, el cargo o el init.
222TRANSACCIÓN NO ENCONTRADASe produce cuando el ticket number de la transacción no existe en nuestra base de datos.
223TRANSACCIÓN NO SOPORTADASe produce cuando la transacción no está soportada por Kushki ni por el procesador
225TIPO DE TRANSACCIÓN NO VÁLIDOSe produce cuando el tipo de transacción no es válido.
226PROCESADOR CC NO ASIGNADOSe produce cuando no se asignó el procesador de tarjetas de crédito al comercio durante su configuración.
228PROCESADOR INALCANZABLESe produce cuando no logramos conectarnos con el procesador.
229EL COMERCIO NO SOPORTA LA TRANSACCIÓNSe produce cuando el comercio no soporta la transacción.
231ANULACIÓN DE VENTA NO PERMITIDASe produce cuando se anula una venta después de haber reembolsado esa misma venta.
238TRANSACCÓN ANULADASe produce cuando se anula una transacción que ya estaba anulada.
277INDICADOR DE IDIOMA NO VÁLIDOSe produce cuando el indicador de idioma no es válido.
322TRANSACCIÓN NO PERMITIDASe produce cuando el comercio no permite la transacción.
478SERVIDOR NO DISPONIBLESe produce cuando hay algún problema de conectividad con el servidor.
509EL MONTO INGRESADO ES MAYOR O MENOR A LO PERMITIDOSe produce cuando el monto de la transacción es menor o mayor que el monto permitido.
577EL TOKEN DE LA TRANSACCIÓN NO ES VÁLIDOSe produce cuando el token de la transacción no es válido o no existe en la base de datos.
578EL TOKEN DE LA TRANSACCIÓN HA EXPIRADOSe produce cuando la transacción se intenta después de 30 min de haber generado el token, o cuando el token se reutiliza en otra transacción.
579TRANSACCIÓN RECHAZADASe produce cuando no logramos procesar la solicitud.
597NO HAY RESPUESTA DEL PROCESADORSe produce cuando no recibimos ninguna respuesta del procesador.
701EL TOKEN DE LA TRANSACCIÓN ES REQUERIDOSe produce cuando no se envía el token de la transacción en la venta.
702EL MONTO DE LA TRANSACCIÓN NO ES VÁLIDOSe produce cuando se ingresa un monto no válido.
703EL MONTO DE LA TRANSACCIÓN ES REQUERIDOSe produce cuando no se ingresa el monto de la transacción.
704EL NÚMERO DE TICKET DE LA TRANSACCIÓN NO ES VÁLIDOSe produce cuando se ingresa un ticket number no válido.
705EL NÚMERO DE TICKET DE LA TRANSACCIÓN ES REQUERIDOSe produce cuando no se ingresa el ticket number.
706LA CANTIDAD DE MESES ES REQUERIDASe produce cuando no se ingresa la cantidad de meses en la transacción diferida.
707LA CANTIDAD DE MESES NO ES VÁLIDASe produce cuando se ingresa una cantidad de meses no válida en la transacción diferida.
710EL COMERCIO NO HA SIDO ENCONTRADOSe produce cuando no se encuentra el comercio.
890DATOS NO ENCONTRADOSSe produce cuando no hay datos para la cookie.
1000EL ID DE LA TARJETA ES REQUERIDASe produce cuando no se ingresa el token de la tarjeta.
1001EL TOKEN DE LA TARJETA NO ES VÁLIDOSe produce cuando el token de la tarjeta ingresado no es válido.
1002EL NOMBRE DEL CONSUMIDOR ES REQUERIDOSe produce cuando no se ingresa el nombre del cliente.
1003EL NOMBRE DEL CONSUMIDOR NO ES VÁLIDOSe produce cuando el nombre del cliente ingresado no es válido.
1004EL APELLIDO DEL CONSUMIDOR ES REQUERIDOSe produce cuando no se ingresa el apellido del cliente.
1005EL APELLIDO DEL CONSUMIDOR NO ES VÁLIDOSe produce cuando el apellido del cliente ingresado no es válido.
1006NOMBRE DEL PLAN ES REQUERIDOSe produce cuando no se ingresa el nombre del plan.
1007NOMBRE DEL PLAN NO ES VÁLIDOSe produce cuando el nombre del plan ingresado no es válido.
1008FECHA DE INICIO ES REQUERIDASe produce cuando no se ingresa la fecha de inicio.
1009FECHA DE INICIO NO ES VÁLIDASe produce cuando la fecha de inicio ingresada no es válida.
1014EL TIPO DE AJUSTE NO ES VÁLIDOSe produce cuando el tipo de ajuste ingresado no es válido.
1015LA FECHA DE AJUSTE NO ES VÁLIDASe produce cuando la fecha de ajuste ingresada no es válida.
1016EL MONTO DE AJUSTE NO ES VÁLIDOSe produce cuando el monto de ajuste ingresado no es válido.
1017LOS PERIODOS DE AJUSTE NO SON VÁLIDOSSe produce cuando los periodos de ajuste ingresados no son válidos.
1018NO ES POSIBLE AGREGAR SUBSCRIPCIÓNSe produce cuando ocurre un error de red al insertar la suscripción.
1019TOKEN DE SUBSCRIPCIÓN NO ENCONTRADOSe produce cuando el token de la suscripción no existe en la base de datos.
1020ERROR EN LA CREACIÓN DE LA SUBSCRIPCIÓNSe produce cuando ocurre algún error al crear la suscripción.
1021EL ID DE SUBSCRIPCIÓN ES REQUERIDOSe produce cuando no se ingresa el ID de la suscripción.
1022EL ID DE SUBSCRIPCIÓN NO ES VÁLIDOSe produce cuando el ID de la suscripción ingresado no es válido.
1023EL CAMPO "PLANID" NO ES VALIDOSe produce cuando el ID del plan ingresado no es válido.
1024LA FECHA DE FINALIDAD NO ES VÁLIDASe produce cuando la fecha de fin ingresada no es válida.
1025DIA DEL MES NO ES VÁLIDOSe produce cuando el día del mes ingresado no es válido.
1026ERROR AL ELIMINAR LA SUBSCRIPCIÓNSe produce cuando falla la cancelación de la suscripción.
1027ID DE SUBSCRIPCIÓN NO ENCONTRADOSe produce cuando el ID de la suscripción no existe en la base de datos.
1028ERROR AL ACTUALIZAR LA SUBSCRIPCIÓNSe produce cuando falla la actualización de la suscripción.
1029TOKEN DE SUBSCRIPCIÓN EXPIRADOSe produce cuando el token está en uso.
1031LA FECHA DE FIN ES REQUERIDASe produce cuando la fecha de fin no es válida.
1032NO HAY SUSCRIPCIONES PARA ID DE COMERCIOSe produce cuando no hay suscripciones en la base de datos para el ID de comercio solicitado.
1033AJUSTE NO VÁLIDO: MONTO SUBTOTALIVASe produce cuando el monto SUBTOTAL_IVA del objeto Amount del ajuste no es válido.
1034AJUSTE NO VÁLIDO: MONTO IVASe produce cuando el monto IVA del objeto Amount del ajuste no es válido.
1035AJUSTE NO VÁLIDO: MONTO SUBTOTALIVA0Se produce cuando el monto SUBTOTAL_IVA0 del objeto Amount del ajuste no es válido.
1036AJUSTE NO VÁLIDO: MONTO ICESe produce cuando el monto ICE del objeto Amount del ajuste no es válido.
CódigoMensaje (español)Descripción
K001EL CUERPO DE LA PETICIÓN ES INVÁLIDOCuerpo de la petición mal formado
K002HA OCURRIDO UN ERROR INESPERADOOcurrió un error no identificado, contacta a soporte.
K003TARJETA NO HABILITADA POR EL EMISORBIN deshabilitado para eCommerce
K004ID DE COMERCIO O CREDENCIAL NO VÁLIDOEl ID de login del comercio no es válido
K005TOKEN EXPIRADOEl token está expirado o se reutilizó en otra transacción
K006MONTO NO ES IGUAL AL ESPERADOEl monto ingresado es diferente al monto cobrado.
K007ESTE RECIBO YA FUE PAGADOEl recibo ya fue pagado
K008ESTE RECIBO YA FUE CANCELADOEl recibo ya fue cancelado
K009RECIBO EXPIRADORecibo expirado
K010TICKET NUMBER INVÁLIDOEl ticket number no se envió correctamente en la solicitud
K011CREDENCIALES INVÁLIDASSe produce cuando las credenciales no son correctas
K012ACCESO NO AUTORIZADOEl token de autenticación está desactualizado o es incorrecto
K013TRANSACCIÓN TOKENIZADA COMO DIFERIDOLa solicitud del token se configuró para una transacción diferida, pero la información del diferido no se incluye en la solicitud del cargo.
K014TOKEN INVÁLIDOEl token de la transacción utilizado no es el correcto
K015Transacción no permitida sin ccv2.Debes enviar el cvv, o verificar la configuración del comercio para enviar cargos recurrentes sin cvv
K020TRANSACCIÓN RECHAZADASe produce cuando no logramos procesar la transacción
K021TRANSACCIÓN RECHAZADASe produce cuando el sistema antifraude rechaza la transacción
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 RECHAZADASe produce cuando no logramos procesar la transacción por una regla de seguridad
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 petición mal formado
CCH010Fechas inválidasFechas no válidas al obtener la lista de chargebacks

Respuestas de error de la consulta de transacciones#

CódigoMensaje (español)Descripción
ANL001Cuerpo de la petición inválido.Cuerpo de la petición mal formado
ANL005Error en la consultaLos filtros usados para consultar las transacciones podrían estar incorrectos

Transfer out#

Si hay algún problema con una dispersión por transferencia, el API de Kushki devuelve un código y un mensaje de error.
CódigoMensaje (español)Descripción
PT001Cuerpo de la petición inválido.Verifica que la información enviada esté acorde con la documentación.
PT007El comercio no existeEl comercio no existe. Ingresa un merchant id válido.
PT008El comercio no existeEl comercio no existe. Ingresa un merchant id válido.
PT0013Número de documento no válidoNúmero de documento no válido
PT0015Número de cuenta inválidoNúmero de cuenta no válido
PT057La moneda enviada es diferente a la definida por el procesador.Verifica la moneda enviada.
Modified at 2026-09-11 14:47:59
Previous
Online Payments
Next
Errores ISO
Built with