Codigos de Respuesta

El comercio integrador recibe exclusivamente los valores públicos descritos en este documento. Los mensajes se reproducen conforme al catálogo proporcionado, incluidos códigos reservados, marcadores como xxx y erratas originales. La disponibilidad de cada código depende del tipo de operación y del procesamiento aplicable.

1. Campos de respuesta

Campo	Tipo	Uso
`codigoRespuesta`	Entero	Resultado general: habitualmente `0` = aprobada y `1` = declinada.
`ccErrorCode`	Entero	Código específico que describe el resultado o la incidencia.
`ccReturnMsg`	Cadena	Mensaje descriptivo asociado al código.
`codigoAprobacion`	Cadena	Código de autorización de exactamente seis dígitos numéricos, obligatorio para confirmar una operación aprobada.

Nota: codigoAprobacion es un campo de validación complementario; el catálogo de errores propiamente dicho está formado por ccErrorCode y ccReturnMsg.

2. Regla universal para confirmar una aprobación

En todas las operaciones de procesamiento financiero, tanto de Pagos en Línea como de Tarjeta Presente, el integrador debe verificar simultáneamente:

codigoRespuesta == 0.
ccErrorCode == 0.
codigoAprobacion presente y con exactamente seis dígitos (^[0-9]{6}$).

Si cualquiera de estas condiciones no se cumple, la operación no debe confirmarse como aprobada. Una respuesta inconsistente no es necesariamente una declinación: debe verificarse antes de volver a procesar.

La generación de sesiones y otras operaciones no financieras quedan fuera de esta regla.

Ejemplo de aprobación (valores ilustrativos)

<codigoRespuesta>0</codigoRespuesta>
<ccErrorCode>0</ccErrorCode>
<ccReturnMsg>Aprobada</ccReturnMsg>
<codigoAprobacion>004581</codigoAprobacion>

Ejemplo de declinación (valores ilustrativos)

<codigoRespuesta>1</codigoRespuesta>
<ccErrorCode>51</ccErrorCode>
<ccReturnMsg>Fondos Insuficientes</ccReturnMsg>
<codigoAprobacion></codigoAprobacion>

Ejemplo de resultado no confirmado (valores ilustrativos)

<codigoRespuesta>0</codigoRespuesta>
<ccErrorCode>0</ccErrorCode>
<ccReturnMsg>Aprobada</ccReturnMsg>
<codigoAprobacion></codigoAprobacion>

Resultado: no confirmado; requiere verificación o conciliación.

Ejemplo de validación en JavaScript

function isApproved(response) {
  return (
    Number(response.codigoRespuesta) === 0 &&
    Number(response.ccErrorCode) === 0 &&
    typeof response.codigoAprobacion === 'string' &&
    /^[0-9]{6}$/.test(response.codigoAprobacion)
  );
}

No convertir codigoAprobacion a número: los ceros iniciales son significativos para su formato.

3. Clasificación y manejo de respuestas

Situación	Interpretación para el integrador	Acción recomendada
Tres condiciones de aprobación satisfechas	APROBADA	Registrar aprobación y confirmar la operación comercial.
`codigoRespuesta = 1` y respuesta completa	DECLINADA	Registrar rechazo y utilizar `ccErrorCode` / `ccReturnMsg` para explicar la causa.
`codigoRespuesta = 0`, `ccErrorCode != 0`	NO CONFIRMADA / INCONSISTENTE	No confirmar; verificar el resultado.
`codigoRespuesta = 0`, sin código de aprobación válido	NO CONFIRMADA / INCONSISTENTE	No confirmar; verificar el resultado.
Sin respuesta, timeout o XML incompleto	INDETERMINADA	Consultar o conciliar antes de reintentar.
Código general distinto de `0` o `1`	REQUIERE REVISIÓN	Aplicar las reglas oficiales que correspondan; no inferir resultado.

Los estados en mayúsculas son estados internos sugeridos para la aplicación del comercio; no son valores adicionales devueltos por Bloomin.

Advertencia: recibir HTTP 200 no demuestra aprobación financiera. Tampoco debe considerarse un timeout como una declinación.

4. Catálogo público de códigos

Las tablas siguientes contienen únicamente los campos que el integrador puede utilizar: ccErrorCode y ccReturnMsg. Se agrupan por familia funcional para facilitar la consulta.

Respuestas del procesador

`ccErrorCode`	`ccReturnMsg`
0	Aprobada
1	Consulte al Emisor de la Tarjeta
2	Solicitar Autorización al Emisor
3	Comercio Inválido
4	Reintente con otra Tarjeta
5	Denegada. Intente con otra Tarjeta
6	Denegada. Contacte a su Banco
7	Reintente con otra Tarjeta
8	Identificador No Reconocido
9	No se puede revertir la transacción anterior
11	Approval VIP
12	Transacción Inválida
13	Monto Inválido
14	Tarjeta Inválida
15	Emisor Desconocido
30	Error de Formato
31	Tarjeta No Soportada
33	Tarjeta Vencida
34	Tarjeta Restringida
35	Tarjeta Restringida
36	Tarjeta Restringida
37	Tarjeta Restringida
38	Ha excedido los Intentos de PIN
39	Sin cuenta de ahorro
41	Tarjeta Extraviada
43	Tarjeta con Reporte de Robo
51	Fondos Insuficientes
54	Tarjeta Vencida
55	PIN Incorrecto
56	Tarjeta sin Activar
57	Transacción No Permitida
58	Transacción Invalida
59	Código CVV/CVC Requerido
61	Monto Excedido
62	Tarjeta Restringida
65	Excede la Frecuencia de Uso
68	Mal funcionamiento de la Plataforma
75	Número de Intentos Excedido
76	Reservado
77	Reservado
78	Cuenta Invalida
79	Reservado
81	Reservado
82	Violación de Seguridad
83	Reservado
84	Reservado
85	Reservado
86	Reservado
87	Datos de Track Erroneos
88	Reservado
89	Terminal Invalida
90	Emisor no disponible
91	Emisor no disponible
92	No se puede enrutar la transacción
94	No se puede revertir la transacción anterior
96	Emisor No Disponible
100	No es posible Autorizar
101	Reservado
102	La Autorización previa fue completada
103	Reservado
104	Reservado
105	Reservado
106	Reservado
107	Reservado
108	Reservado
109	Reservado
110	Reservado
111	Reservado
112	Reservado
113	Reservado
114	Reservado
115	Reservado
116	Reservado
117	Reservado
118	Reservado
119	Reservado
120	Reservado
121	Limite Diario Excedido
122	Reservado
123	Reservado
124	Reservado
125	Reservado
126	Reservado
127	Reservado
128	Reservado
129	Reservado
130	Reservado
131	Reservado
132	Reservado
133	Reservado
134	Reservado
135	Reservado
136	Reservado
137	Reservado
138	Reservado
139	Reservado
140	Reservado
141	Reservado
142	Reservado
143	Reservado
144	Reservado
145	Reservado
146	Reservado
147	Reservado
148	Reservado
154	PTLF Completo
155	Error
156	Reservado
157	Reservado
158	No existe el Registro
159	Reservado
161	Reservado
162	Reservado
163	Tarjeta No Soportada
164	Reservado
165	Declinado. Reservado CAF 3D
166	Reservado
167	Reservado
168	Limite Contactless Excedido. Favor de Insertar Tarjeta
199	Declinado General

Seguridad SSL y certificados

`ccErrorCode`	`ccReturnMsg`
701	El algoritmo definido para encriptar en SSL no está soportado en esta plataforma.
702	Falla inesperada al accesar almacén de llaves (keystore).
703	El almacén de llaves (keystore) especificado no existe en la ubicación configurada.
704	El almacén de llaves (keystore) configurado no es válido o está corrupto.
705	El acceso al almacén de llaves (keystore) fue denegado por falta de permisos.
706	Falla general de seguridad en manejo de SSL.

Sockets de servidor

`ccErrorCode`	`ccReturnMsg`
801	Falla al inicializar servidor de sockets.

Conectividad y sockets de cliente

`ccErrorCode`	`ccReturnMsg`
901	Falla al intentar crear socket en cliente hacia servidor xxx.
902	Incapaz de establecer conexión con servidor xxx.
903	No se tiene conexión actualmente con el servidor. Se intenta reconexión.

Formato y codificación ISO

`ccErrorCode`	`ccReturnMsg`
1001	El mensaje ISO recibido no tiene el formato esperado.
1002	El mensaje ISO recibido contiene una TPDU no válida.
1003	El mensaje ISO recibido no tiene un mapa de bits consistente.
1004	El mensaje ISO recibido tiene un terminador no válido.
1005	Falla al decodificar el campo xxx.
1006	Falla al codificar el campo xxx. Valor: yyy
1007	El contenido del campo excede el máximo permisible.
1008	El tipo del campo xxx no es del tipo esperado
1009	El juego de caracteres ISO-8859-1 no está soportado en esta plataforma
1010	El campo xxx está incompleto
1011	El campo xxx no es válido.
1012	La longitud del campo variable xxx excede lo indicado en el prefijo.
1013	El contenido del campo xxx no es válido
1014	El modo de entrada (campo 22) no es válido.
1015	El campo xxx es requerido y no fue incluido en el mensaje ISO.
1016	El mensaje de estadísticos recibido no tiene el formato esperado

Validación y procesamiento de comandos

`ccErrorCode`	`ccReturnMsg`
2001	Falla inesperada al intentar procesar transacción
2002	El parámetro 'xxx' no puede incluirse en una transacción manual.
2003	El parámetro 'xxx' no puede incluirse en una transacción con plástico presente.
2004	El parámetro 'xxx' con valor 'yyy' sólo es requerido en una transacción de chip.
2005	El parámetro 'xxx' con valor 'yyy' no es compatible con una transacción manual.
2006	El parámetro 'xxx' con valor 'yyy' no es compatible con una transacción con plástico presente.
2007	La información sobre la promoción en la transacción no está completa.
2008	El parámetro 'xxx' con valor ''yyy' corresponde a una fecha expirada.
2009	El comando requiere 'REFERENCIA' o 'NUMERO_CONTROL'.
2010	No se especificó el parámetro requerido 'CMD_TRANS'.
2011	El comando/transacción 'xxx' no es válido(a) o no está soportado(a).
2012	El valor 'yyy' suministrado para el parámetro 'xxx' es inválido.
2013	El valor 'yyy' suministrado para el parámetro 'xxx' excede la longitud máxima permitida: zzz.
2014	El parámetro 'xxx' no puede ser nulo
2015	No hubo respuesta para el comando/transacción.

Reglas transaccionales, afiliación y permisos

`ccErrorCode`	`ccReturnMsg`
3001	Incapaz de realizar operación. Por favor intente más tarde.
3002	La afiliación o el usuario proporcionados no existen.
3003	Usuario o contraseña inválidos.
3004	La afiliación xxx no se encuentra activa.
3005	El cliente xxx no se encuentra activo.
3006	El usuario xxx no se encuentra activo.
3007	El usuario xxx no tiene el permiso necesario para ejecutar comandos/transacciones.
3008	La terminal xxx no existe para esta afiliación.
3009	La terminal xxx no se encuentra activa.
3010	Transacción no permitida para esta terminal y marca de tarjeta.
3011	El comando xxx no está soportado actualmente
3012	La transacción referenciada xxx no existe
3013	La transacción referenciada xxx ya había sido cancelada
3014	Rechazada: El 100% del importe de la transacción referenciada xxx ya ha sido devuelto
3015	Rechazada: La transacción referenciada xxx ya tiene devoluciones parciales aplicadas
3016	La transacción referenciada xxx no permite devoluciones
3017	No es posible efectuar una devolución sobre la transacción xxx, la cual no ha sido cerrada
3018	El importe de la devolución por xxx excede el máximo disponible: yyy
3019	No se admite el cierre de reautorizaciones; utilice la preautorización original
3020	Sólo se permiten postautorizaciones para preautorizaciones abiertas
3021	El monto de la postautorización por xxx excede el máximo disponible: yyy
3022	Sólo se permiten reautorizaciones para preautorizaciones abiertas
3023	El tipo de aplicación xxx no permite reautorizaciones
3024	La transacción referenciada xxx no permite cancelaciones
3025	No es posible efectuar una cancelación sobre la transacción xxx, la cual no ha sido cerrada
3026	No tiene el permiso para ejecutar una cancelación
3027	No tiene el permiso para ejecutar una transacción de cashback
3028	La transacción de crédito no está habilitada
3029	No se tiene el permiso necesario para ejecutar una transacción de devolución
3030	Las devoluciones tardías (sin restricción de batch) no están habilitadas
3031	No se tiene el permiso necesario para efectuar una transacción con promoción
3032	No se tiene el permiso necesario para ejecutar transacciones QPS
3033	No se tiene el permiso necesario para realizar una venta forzada
3034	El monto indicado en la transacción QPS excede el máximo permisible
3035	La afiliación requiere que se proporcione una terminal válida
3036	La terminal por defecto no ha sido creada en la base de datos
3037	No hay soporte para las tarjetas de marca xxx
3038	No hay soporte para el autorizador xxx
3039	El No. de Control xxx ya existe para una transacción anterior
3040	No se permite monto cero en una transacción
3041	Las transacciones FALLBACK no están permitidas
3042	El indicador de 3DSecure (ECI) recibido para esta transacción no está permitido
3043	La operación previa requerida para ejecutar esta transacción no tuvo éxito
3044	La operación previa requerida para ejecutar esta transacción fue declinada por el autorizador
3045	La operación previa requerida para ejecutar esta transacción no tuvo respuesta
3046	El código de seguridad es requerido y no fue proporcionado
3047	El modo de entrada de la transacción no es compatible con el tipo de afiliacion: xxx
3048	No se tiene el permiso necesario para ejecutar transacciones tecleadas o manuales
3049	La transacción referenciada xxx ya había sido reversada
3050	La transacción referenciada no admite reversas
3051	La transacción referenciada xxx no había sido aprobada
3052	La transacción referenciada xxx se encuentra en estado de suspensión
3054	No se encontró ninguna transacción para la afiliación/terminal suministrados
3055	La transacción referenciada existe, pero no fue generada por la terminal proporcionada
3056	La transacción referenciada existe, pero no pertenece a la afiliación proporcionada
3057	El cierre del lote xxx ya está en proceso; no puede ejecutarse concurrentemente más de una vez
3058	El cierre masivo para esta afiliación ya está en proceso; no puede ejecutarse concurrentemente más de una vez
3059	No se especificó modo de la transacción (si es ISO verifique que la afiliación sea de tipo TPV).
3060	La afiliación es de tipo TPV; no es válido proporcionar el parámetro MODO
3061	La afiliación ha sido configurada como agregador pero el indicador de formato es nulo
3062	La afiliación es un agregador; se requiere obligatoriamente el nombre del comercio asociado (SUB_AFILIACION)
3063	Esta transacción no es aceptable con pago móvil
3064	No se tiene el permiso necesario para ejecutar transacciones de pago móvil
3065	Esta tarjeta no está autorizada para realizar transacciones de pago móvil
3066	La transacciones de pago móvil únicamente pueden ser digitadas
3067	El valor del tipo de plan suministrado xxx es inválido
3068	La promoción proporcionada es inválida o no está soportada
3069	El tipo de plan xxx es inconsistente con la promoción proporcionada
3070	No se admite esta transacción en modo de prueba, ya que la transacción referenciada fue enviada en modo de producción
3071	No se admite esta transacción en modo de producción, ya que la transacción referenciada fue enviada en modo de prueba
3072	El monto a disponer en esta transacción está por debajo del mínimo requerido
3073	El monto a disponer en esta transacción excede el máximo autorizado
3074	El número máximo de transacciones cashback que pueden ejecutarse en un día ha sido ya alcanzado
3075	Transacción rechazada ya que se excedería el monto máximo diario autorizado de disposición cashback
3076	No se admiten reautorizaciones de una transacción previa de tipo EMV; se requiere nueva lectura de plástico

Conector y autorizador

`ccErrorCode`	`ccReturnMsg`
4001	El conector hacia el autorizador xxx no tiene canales configurados
4002	El autorizador xxx no está disponible
4003	La transacción xxx no está soportada para el autorizador yyy
4004	El tiempo máximo de espera para la transacción xxx ha sido excedido
4005	El track 1 es requerido por el autorizador para esta transacción
4006	No hay información en la base de datos sobreafiliación/terminal para enviar hacia el autorizador xxx
4007	No existe no. de terminal para enviar hacia el autorizador xxx
4008	No existe no. de afiliación para enviar hacia el autorizador xxx
4009	El valor para el tipo de plan ('xxx') no es válido
4010	El valor para el tipo de plan ('xxx') no es congruente con el resto de parámetros de la promoción
4011	La promoción debe incluir diferimiento inicial y/o número de pagos
4012	La información de EMV suministrada no es válida o está incompleta
4013	Falla al decodificar token xxx: El valor ‘yyy’ para el subcampo zzz no es aceptable de acuerdo a especificación.

Base de datos

`ccErrorCode`	`ccReturnMsg`
5001	Falla al intentar ejecutar la siguiente operación en base de datos: xxx.

Reglas configurables de negocio

`ccErrorCode`	`ccReturnMsg`
6001	Transacción rechazada por aplicación de la regla xxx asignada para esta afiliación.
6002	Transacción rechazada por error en la fórmula definida para la regla xxx asignada para esta afiliación.
6003	Transacción rechazada por falla al procesar la fórmula definida para la regla xxx asignada para esta afiliación.
6004	La clase definida para la regla xxx no ha sido implementada.
6005	Falla al instanciar clase definida para la regla xxx
6006	Condición inválida de búsqueda en regla xxx.
6007	La tala de búsqueda proporcionada en la fórmula para la regla xxx no existe.
6008	El archivo Excel requerido por la fórmula definida para la regla xxx no existe.
6009	Falla al intentar accesar el archivo Excel requerido por la fórmula definida para la regla xxx.
6010	Falla al ejecutar búsqueda en tabla requerida por la regla xxx.
6011	Incapaz de cargar driver Excel para ejecutar regla xxx.

Error general de aplicación

`ccErrorCode`	`ccReturnMsg`
9999	Falla inesperada en aplicación.

Código general de aplicación

El código 9999 está incluido en el catálogo y corresponde al mensaje «Falla inesperada en aplicación.» cuando se asigna esa descripción. En determinadas situaciones de error no clasificado, el código 9999 puede recibirse sin un mensaje descriptivo nuevo. Por ello, la aplicación no debe depender exclusivamente de ccReturnMsg.

5. Guía de tratamiento por tipo de error

Códigos orientativos	Tipo de incidencia	Manejo recomendado
`1`–`9`, `12`–`15`, `30`–`96`, `100`–`168`, `199`	Respuestas del procesador y rechazos de tarjeta	Mostrar un mensaje apropiado y registrar el resultado. No asumir que cualquier código permite reintento inmediato.
`701`–`706`	Seguridad y configuración SSL	Escalar al equipo técnico; no pedir al comprador que repita indefinidamente.
`801`, `901`–`903`	Conectividad	Evaluar posible resultado indeterminado y verificar antes de reenviar.
`1001`–`1016`	Formato de mensajes	Revisar la construcción de la solicitud y la integración.
`2001`–`2015`	Parámetros y procesamiento	Corregir parámetros o verificar estado según el mensaje específico.
`3001`–`3076` (códigos existentes en catálogo)	Reglas, permisos, afiliaciones y transacciones previas	Revisar configuración, estado original y elegibilidad de la operación.
`4001`–`4013`	Autorizador y conectores	Escalar a soporte o conciliar; especial atención al timeout `4004`.
`5001`	Base de datos	Registrar incidencia y escalar a soporte.
`6001`–`6011`	Reglas configurables	Revisar reglas y configuración; escalar a soporte técnico.
`9999`	Error general	Registrar incidencia y solicitar diagnóstico.

Las agrupaciones son orientativas; cada código debe interpretarse por su mensaje y contexto, no solo por su rango.

6. Casos que requieren especial atención

Devoluciones

3014: la transacción ya tiene devuelto el 100 % del importe.
3015: la transacción ya tiene devoluciones parciales aplicadas.
3016: la transacción no permite devoluciones.
3017: la transacción no ha sido cerrada.
3018: el importe solicitado supera el máximo disponible.

Estos códigos describen validaciones que pueden ocurrir. No constituyen, por sí mismos, una política completa sobre devoluciones parciales múltiples.

Postautorizaciones y operaciones previas

3019: no se admite el cierre de reautorizaciones; se requiere la preautorización original.
3020: solo se permiten postautorizaciones de preautorizaciones abiertas.
3021: el importe supera el máximo disponible.
3043–`3045`: problemas con la operación previa requerida.

Cancelaciones y reversas

3024–`3026`: restricciones de cancelación y permisos.
3049: la transacción ya fue reversada.
3050: la transacción no admite reversas.
3051: la transacción referenciada no fue aprobada.
3052: la transacción está suspendida.

Timeouts e indisponibilidad

903: sin conexión actual; se intenta reconexión.
2015: no hubo respuesta para el comando o transacción.
4002: autorizador no disponible.
4004: tiempo máximo de espera excedido.

Importante: estos mensajes no prueban que una operación financiera no haya sido aplicada. Antes de reenviar una solicitud debe verificarse su estado mediante el procedimiento oficial de consulta o conciliación.

7. Recomendaciones para mostrar mensajes

Al comprador: presentar una explicación breve y segura, sin mostrar detalles de SSL, servidores, afiliaciones, reglas internas o bases de datos.

Al personal de soporte: conservar el código, el mensaje, el método invocado, la referencia de la operación, el importe, la fecha y los identificadores de correlación disponibles. No registrar credenciales ni datos completos de tarjeta.

Al sistema de pagos: conservar el resultado técnico separado del estado comercial; solo confirmar aprobación cuando se cumplan las tres validaciones.

8. Lista de verificación de integración

Interpretar codigoRespuesta conforme a los valores acordados.
Evaluar ccErrorCode y ccReturnMsg como detalle del resultado.
Validar codigoAprobacion como cadena numérica de seis dígitos en todas las operaciones financieras.
No confirmar respuestas inconsistentes.
Tratar timeouts y ausencia de respuesta como indeterminados.
Evitar reintentos automáticos cuando no se conoce el resultado.
Registrar identificadores y referencias para conciliación.
No exponer datos sensibles ni detalles de infraestructura a compradores.
Validar las reglas operativas de cada método antes de ejecutar operaciones posteriores.

9. Alcance y mantenimiento del catálogo

El catálogo reproduce las 261 correspondencias explícitas suministradas por el equipo de Bloomin (119 del procesador y 142 de errores técnicos u operativos), más el código general 199 definido para una respuesta no reconocida. El código 9999 también puede utilizarse como código general de error. La asignación del resultado general codigoRespuesta no se muestra en el fragmento fuente; su interpretación 0/`1` proviene de la confirmación operativa del equipo.

Las descripciones se mantienen fieles a la fuente, incluso cuando contienen términos reservados, marcadores variables o erratas. No se garantiza que todos los códigos sean aplicables a todos los métodos, canales o adquirentes.

Regla editorial: este documento describe únicamente la interfaz pública del comercio integrador. No expone variables, códigos de origen ni detalles de interpretación internos.

1. Campos de respuesta

Campo	Tipo	Uso
`codigoRespuesta`	Entero	Resultado general: habitualmente `0` = aprobada y `1` = declinada.
`ccErrorCode`	Entero	Código específico que describe el resultado o la incidencia.
`ccReturnMsg`	Cadena	Mensaje descriptivo asociado al código.
`codigoAprobacion`	Cadena	Código de autorización de exactamente seis dígitos numéricos, obligatorio para confirmar una operación aprobada.

Nota: codigoAprobacion es un campo de validación complementario; el catálogo de errores propiamente dicho está formado por ccErrorCode y ccReturnMsg.

2. Regla universal para confirmar una aprobación

En todas las operaciones de procesamiento financiero, tanto de Pagos en Línea como de Tarjeta Presente, el integrador debe verificar simultáneamente:

codigoRespuesta == 0.
ccErrorCode == 0.
codigoAprobacion presente y con exactamente seis dígitos (^[0-9]{6}$).

La generación de sesiones y otras operaciones no financieras quedan fuera de esta regla.

Ejemplo de aprobación (valores ilustrativos)

<codigoRespuesta>0</codigoRespuesta>
<ccErrorCode>0</ccErrorCode>
<ccReturnMsg>Aprobada</ccReturnMsg>
<codigoAprobacion>004581</codigoAprobacion>

Ejemplo de declinación (valores ilustrativos)

<codigoRespuesta>1</codigoRespuesta>
<ccErrorCode>51</ccErrorCode>
<ccReturnMsg>Fondos Insuficientes</ccReturnMsg>
<codigoAprobacion></codigoAprobacion>

Ejemplo de resultado no confirmado (valores ilustrativos)

<codigoRespuesta>0</codigoRespuesta>
<ccErrorCode>0</ccErrorCode>
<ccReturnMsg>Aprobada</ccReturnMsg>
<codigoAprobacion></codigoAprobacion>

Resultado: no confirmado; requiere verificación o conciliación.

Ejemplo de validación en JavaScript

function isApproved(response) {
  return (
    Number(response.codigoRespuesta) === 0 &&
    Number(response.ccErrorCode) === 0 &&
    typeof response.codigoAprobacion === 'string' &&
    /^[0-9]{6}$/.test(response.codigoAprobacion)
  );
}

No convertir codigoAprobacion a número: los ceros iniciales son significativos para su formato.

3. Clasificación y manejo de respuestas

Situación	Interpretación para el integrador	Acción recomendada
Tres condiciones de aprobación satisfechas	APROBADA	Registrar aprobación y confirmar la operación comercial.
`codigoRespuesta = 1` y respuesta completa	DECLINADA	Registrar rechazo y utilizar `ccErrorCode` / `ccReturnMsg` para explicar la causa.
`codigoRespuesta = 0`, `ccErrorCode != 0`	NO CONFIRMADA / INCONSISTENTE	No confirmar; verificar el resultado.
`codigoRespuesta = 0`, sin código de aprobación válido	NO CONFIRMADA / INCONSISTENTE	No confirmar; verificar el resultado.
Sin respuesta, timeout o XML incompleto	INDETERMINADA	Consultar o conciliar antes de reintentar.
Código general distinto de `0` o `1`	REQUIERE REVISIÓN	Aplicar las reglas oficiales que correspondan; no inferir resultado.

Los estados en mayúsculas son estados internos sugeridos para la aplicación del comercio; no son valores adicionales devueltos por Bloomin.

Advertencia: recibir HTTP 200 no demuestra aprobación financiera. Tampoco debe considerarse un timeout como una declinación.

4. Catálogo público de códigos

Las tablas siguientes contienen únicamente los campos que el integrador puede utilizar: ccErrorCode y ccReturnMsg. Se agrupan por familia funcional para facilitar la consulta.

Respuestas del procesador

`ccErrorCode`	`ccReturnMsg`
0	Aprobada
1	Consulte al Emisor de la Tarjeta
2	Solicitar Autorización al Emisor
3	Comercio Inválido
4	Reintente con otra Tarjeta
5	Denegada. Intente con otra Tarjeta
6	Denegada. Contacte a su Banco
7	Reintente con otra Tarjeta
8	Identificador No Reconocido
9	No se puede revertir la transacción anterior
11	Approval VIP
12	Transacción Inválida
13	Monto Inválido
14	Tarjeta Inválida
15	Emisor Desconocido
30	Error de Formato
31	Tarjeta No Soportada
33	Tarjeta Vencida
34	Tarjeta Restringida
35	Tarjeta Restringida
36	Tarjeta Restringida
37	Tarjeta Restringida
38	Ha excedido los Intentos de PIN
39	Sin cuenta de ahorro
41	Tarjeta Extraviada
43	Tarjeta con Reporte de Robo
51	Fondos Insuficientes
54	Tarjeta Vencida
55	PIN Incorrecto
56	Tarjeta sin Activar
57	Transacción No Permitida
58	Transacción Invalida
59	Código CVV/CVC Requerido
61	Monto Excedido
62	Tarjeta Restringida
65	Excede la Frecuencia de Uso
68	Mal funcionamiento de la Plataforma
75	Número de Intentos Excedido
76	Reservado
77	Reservado
78	Cuenta Invalida
79	Reservado
81	Reservado
82	Violación de Seguridad
83	Reservado
84	Reservado
85	Reservado
86	Reservado
87	Datos de Track Erroneos
88	Reservado
89	Terminal Invalida
90	Emisor no disponible
91	Emisor no disponible
92	No se puede enrutar la transacción
94	No se puede revertir la transacción anterior
96	Emisor No Disponible
100	No es posible Autorizar
101	Reservado
102	La Autorización previa fue completada
103	Reservado
104	Reservado
105	Reservado
106	Reservado
107	Reservado
108	Reservado
109	Reservado
110	Reservado
111	Reservado
112	Reservado
113	Reservado
114	Reservado
115	Reservado
116	Reservado
117	Reservado
118	Reservado
119	Reservado
120	Reservado
121	Limite Diario Excedido
122	Reservado
123	Reservado
124	Reservado
125	Reservado
126	Reservado
127	Reservado
128	Reservado
129	Reservado
130	Reservado
131	Reservado
132	Reservado
133	Reservado
134	Reservado
135	Reservado
136	Reservado
137	Reservado
138	Reservado
139	Reservado
140	Reservado
141	Reservado
142	Reservado
143	Reservado
144	Reservado
145	Reservado
146	Reservado
147	Reservado
148	Reservado
154	PTLF Completo
155	Error
156	Reservado
157	Reservado
158	No existe el Registro
159	Reservado
161	Reservado
162	Reservado
163	Tarjeta No Soportada
164	Reservado
165	Declinado. Reservado CAF 3D
166	Reservado
167	Reservado
168	Limite Contactless Excedido. Favor de Insertar Tarjeta
199	Declinado General

Seguridad SSL y certificados

`ccErrorCode`	`ccReturnMsg`
701	El algoritmo definido para encriptar en SSL no está soportado en esta plataforma.
702	Falla inesperada al accesar almacén de llaves (keystore).
703	El almacén de llaves (keystore) especificado no existe en la ubicación configurada.
704	El almacén de llaves (keystore) configurado no es válido o está corrupto.
705	El acceso al almacén de llaves (keystore) fue denegado por falta de permisos.
706	Falla general de seguridad en manejo de SSL.

Sockets de servidor

`ccErrorCode`	`ccReturnMsg`
801	Falla al inicializar servidor de sockets.

Conectividad y sockets de cliente

`ccErrorCode`	`ccReturnMsg`
901	Falla al intentar crear socket en cliente hacia servidor xxx.
902	Incapaz de establecer conexión con servidor xxx.
903	No se tiene conexión actualmente con el servidor. Se intenta reconexión.

Formato y codificación ISO

`ccErrorCode`	`ccReturnMsg`
1001	El mensaje ISO recibido no tiene el formato esperado.
1002	El mensaje ISO recibido contiene una TPDU no válida.
1003	El mensaje ISO recibido no tiene un mapa de bits consistente.
1004	El mensaje ISO recibido tiene un terminador no válido.
1005	Falla al decodificar el campo xxx.
1006	Falla al codificar el campo xxx. Valor: yyy
1007	El contenido del campo excede el máximo permisible.
1008	El tipo del campo xxx no es del tipo esperado
1009	El juego de caracteres ISO-8859-1 no está soportado en esta plataforma
1010	El campo xxx está incompleto
1011	El campo xxx no es válido.
1012	La longitud del campo variable xxx excede lo indicado en el prefijo.
1013	El contenido del campo xxx no es válido
1014	El modo de entrada (campo 22) no es válido.
1015	El campo xxx es requerido y no fue incluido en el mensaje ISO.
1016	El mensaje de estadísticos recibido no tiene el formato esperado

Validación y procesamiento de comandos

`ccErrorCode`	`ccReturnMsg`
2001	Falla inesperada al intentar procesar transacción
2002	El parámetro 'xxx' no puede incluirse en una transacción manual.
2003	El parámetro 'xxx' no puede incluirse en una transacción con plástico presente.
2004	El parámetro 'xxx' con valor 'yyy' sólo es requerido en una transacción de chip.
2005	El parámetro 'xxx' con valor 'yyy' no es compatible con una transacción manual.
2006	El parámetro 'xxx' con valor 'yyy' no es compatible con una transacción con plástico presente.
2007	La información sobre la promoción en la transacción no está completa.
2008	El parámetro 'xxx' con valor ''yyy' corresponde a una fecha expirada.
2009	El comando requiere 'REFERENCIA' o 'NUMERO_CONTROL'.
2010	No se especificó el parámetro requerido 'CMD_TRANS'.
2011	El comando/transacción 'xxx' no es válido(a) o no está soportado(a).
2012	El valor 'yyy' suministrado para el parámetro 'xxx' es inválido.
2013	El valor 'yyy' suministrado para el parámetro 'xxx' excede la longitud máxima permitida: zzz.
2014	El parámetro 'xxx' no puede ser nulo
2015	No hubo respuesta para el comando/transacción.

Reglas transaccionales, afiliación y permisos

`ccErrorCode`	`ccReturnMsg`
3001	Incapaz de realizar operación. Por favor intente más tarde.
3002	La afiliación o el usuario proporcionados no existen.
3003	Usuario o contraseña inválidos.
3004	La afiliación xxx no se encuentra activa.
3005	El cliente xxx no se encuentra activo.
3006	El usuario xxx no se encuentra activo.
3007	El usuario xxx no tiene el permiso necesario para ejecutar comandos/transacciones.
3008	La terminal xxx no existe para esta afiliación.
3009	La terminal xxx no se encuentra activa.
3010	Transacción no permitida para esta terminal y marca de tarjeta.
3011	El comando xxx no está soportado actualmente
3012	La transacción referenciada xxx no existe
3013	La transacción referenciada xxx ya había sido cancelada
3014	Rechazada: El 100% del importe de la transacción referenciada xxx ya ha sido devuelto
3015	Rechazada: La transacción referenciada xxx ya tiene devoluciones parciales aplicadas
3016	La transacción referenciada xxx no permite devoluciones
3017	No es posible efectuar una devolución sobre la transacción xxx, la cual no ha sido cerrada
3018	El importe de la devolución por xxx excede el máximo disponible: yyy
3019	No se admite el cierre de reautorizaciones; utilice la preautorización original
3020	Sólo se permiten postautorizaciones para preautorizaciones abiertas
3021	El monto de la postautorización por xxx excede el máximo disponible: yyy
3022	Sólo se permiten reautorizaciones para preautorizaciones abiertas
3023	El tipo de aplicación xxx no permite reautorizaciones
3024	La transacción referenciada xxx no permite cancelaciones
3025	No es posible efectuar una cancelación sobre la transacción xxx, la cual no ha sido cerrada
3026	No tiene el permiso para ejecutar una cancelación
3027	No tiene el permiso para ejecutar una transacción de cashback
3028	La transacción de crédito no está habilitada
3029	No se tiene el permiso necesario para ejecutar una transacción de devolución
3030	Las devoluciones tardías (sin restricción de batch) no están habilitadas
3031	No se tiene el permiso necesario para efectuar una transacción con promoción
3032	No se tiene el permiso necesario para ejecutar transacciones QPS
3033	No se tiene el permiso necesario para realizar una venta forzada
3034	El monto indicado en la transacción QPS excede el máximo permisible
3035	La afiliación requiere que se proporcione una terminal válida
3036	La terminal por defecto no ha sido creada en la base de datos
3037	No hay soporte para las tarjetas de marca xxx
3038	No hay soporte para el autorizador xxx
3039	El No. de Control xxx ya existe para una transacción anterior
3040	No se permite monto cero en una transacción
3041	Las transacciones FALLBACK no están permitidas
3042	El indicador de 3DSecure (ECI) recibido para esta transacción no está permitido
3043	La operación previa requerida para ejecutar esta transacción no tuvo éxito
3044	La operación previa requerida para ejecutar esta transacción fue declinada por el autorizador
3045	La operación previa requerida para ejecutar esta transacción no tuvo respuesta
3046	El código de seguridad es requerido y no fue proporcionado
3047	El modo de entrada de la transacción no es compatible con el tipo de afiliacion: xxx
3048	No se tiene el permiso necesario para ejecutar transacciones tecleadas o manuales
3049	La transacción referenciada xxx ya había sido reversada
3050	La transacción referenciada no admite reversas
3051	La transacción referenciada xxx no había sido aprobada
3052	La transacción referenciada xxx se encuentra en estado de suspensión
3054	No se encontró ninguna transacción para la afiliación/terminal suministrados
3055	La transacción referenciada existe, pero no fue generada por la terminal proporcionada
3056	La transacción referenciada existe, pero no pertenece a la afiliación proporcionada
3057	El cierre del lote xxx ya está en proceso; no puede ejecutarse concurrentemente más de una vez
3058	El cierre masivo para esta afiliación ya está en proceso; no puede ejecutarse concurrentemente más de una vez
3059	No se especificó modo de la transacción (si es ISO verifique que la afiliación sea de tipo TPV).
3060	La afiliación es de tipo TPV; no es válido proporcionar el parámetro MODO
3061	La afiliación ha sido configurada como agregador pero el indicador de formato es nulo
3062	La afiliación es un agregador; se requiere obligatoriamente el nombre del comercio asociado (SUB_AFILIACION)
3063	Esta transacción no es aceptable con pago móvil
3064	No se tiene el permiso necesario para ejecutar transacciones de pago móvil
3065	Esta tarjeta no está autorizada para realizar transacciones de pago móvil
3066	La transacciones de pago móvil únicamente pueden ser digitadas
3067	El valor del tipo de plan suministrado xxx es inválido
3068	La promoción proporcionada es inválida o no está soportada
3069	El tipo de plan xxx es inconsistente con la promoción proporcionada
3070	No se admite esta transacción en modo de prueba, ya que la transacción referenciada fue enviada en modo de producción
3071	No se admite esta transacción en modo de producción, ya que la transacción referenciada fue enviada en modo de prueba
3072	El monto a disponer en esta transacción está por debajo del mínimo requerido
3073	El monto a disponer en esta transacción excede el máximo autorizado
3074	El número máximo de transacciones cashback que pueden ejecutarse en un día ha sido ya alcanzado
3075	Transacción rechazada ya que se excedería el monto máximo diario autorizado de disposición cashback
3076	No se admiten reautorizaciones de una transacción previa de tipo EMV; se requiere nueva lectura de plástico

Conector y autorizador

`ccErrorCode`	`ccReturnMsg`
4001	El conector hacia el autorizador xxx no tiene canales configurados
4002	El autorizador xxx no está disponible
4003	La transacción xxx no está soportada para el autorizador yyy
4004	El tiempo máximo de espera para la transacción xxx ha sido excedido
4005	El track 1 es requerido por el autorizador para esta transacción
4006	No hay información en la base de datos sobreafiliación/terminal para enviar hacia el autorizador xxx
4007	No existe no. de terminal para enviar hacia el autorizador xxx
4008	No existe no. de afiliación para enviar hacia el autorizador xxx
4009	El valor para el tipo de plan ('xxx') no es válido
4010	El valor para el tipo de plan ('xxx') no es congruente con el resto de parámetros de la promoción
4011	La promoción debe incluir diferimiento inicial y/o número de pagos
4012	La información de EMV suministrada no es válida o está incompleta
4013	Falla al decodificar token xxx: El valor ‘yyy’ para el subcampo zzz no es aceptable de acuerdo a especificación.

Base de datos

`ccErrorCode`	`ccReturnMsg`
5001	Falla al intentar ejecutar la siguiente operación en base de datos: xxx.

Reglas configurables de negocio

`ccErrorCode`	`ccReturnMsg`
6001	Transacción rechazada por aplicación de la regla xxx asignada para esta afiliación.
6002	Transacción rechazada por error en la fórmula definida para la regla xxx asignada para esta afiliación.
6003	Transacción rechazada por falla al procesar la fórmula definida para la regla xxx asignada para esta afiliación.
6004	La clase definida para la regla xxx no ha sido implementada.
6005	Falla al instanciar clase definida para la regla xxx
6006	Condición inválida de búsqueda en regla xxx.
6007	La tala de búsqueda proporcionada en la fórmula para la regla xxx no existe.
6008	El archivo Excel requerido por la fórmula definida para la regla xxx no existe.
6009	Falla al intentar accesar el archivo Excel requerido por la fórmula definida para la regla xxx.
6010	Falla al ejecutar búsqueda en tabla requerida por la regla xxx.
6011	Incapaz de cargar driver Excel para ejecutar regla xxx.

Error general de aplicación

`ccErrorCode`	`ccReturnMsg`
9999	Falla inesperada en aplicación.

Código general de aplicación

5. Guía de tratamiento por tipo de error

Códigos orientativos	Tipo de incidencia	Manejo recomendado
`1`–`9`, `12`–`15`, `30`–`96`, `100`–`168`, `199`	Respuestas del procesador y rechazos de tarjeta	Mostrar un mensaje apropiado y registrar el resultado. No asumir que cualquier código permite reintento inmediato.
`701`–`706`	Seguridad y configuración SSL	Escalar al equipo técnico; no pedir al comprador que repita indefinidamente.
`801`, `901`–`903`	Conectividad	Evaluar posible resultado indeterminado y verificar antes de reenviar.
`1001`–`1016`	Formato de mensajes	Revisar la construcción de la solicitud y la integración.
`2001`–`2015`	Parámetros y procesamiento	Corregir parámetros o verificar estado según el mensaje específico.
`3001`–`3076` (códigos existentes en catálogo)	Reglas, permisos, afiliaciones y transacciones previas	Revisar configuración, estado original y elegibilidad de la operación.
`4001`–`4013`	Autorizador y conectores	Escalar a soporte o conciliar; especial atención al timeout `4004`.
`5001`	Base de datos	Registrar incidencia y escalar a soporte.
`6001`–`6011`	Reglas configurables	Revisar reglas y configuración; escalar a soporte técnico.
`9999`	Error general	Registrar incidencia y solicitar diagnóstico.

Las agrupaciones son orientativas; cada código debe interpretarse por su mensaje y contexto, no solo por su rango.

6. Casos que requieren especial atención

Devoluciones

3014: la transacción ya tiene devuelto el 100 % del importe.
3015: la transacción ya tiene devoluciones parciales aplicadas.
3016: la transacción no permite devoluciones.
3017: la transacción no ha sido cerrada.
3018: el importe solicitado supera el máximo disponible.

Estos códigos describen validaciones que pueden ocurrir. No constituyen, por sí mismos, una política completa sobre devoluciones parciales múltiples.

Postautorizaciones y operaciones previas

3019: no se admite el cierre de reautorizaciones; se requiere la preautorización original.
3020: solo se permiten postautorizaciones de preautorizaciones abiertas.
3021: el importe supera el máximo disponible.
3043–`3045`: problemas con la operación previa requerida.

Cancelaciones y reversas

3024–`3026`: restricciones de cancelación y permisos.
3049: la transacción ya fue reversada.
3050: la transacción no admite reversas.
3051: la transacción referenciada no fue aprobada.
3052: la transacción está suspendida.

Timeouts e indisponibilidad

903: sin conexión actual; se intenta reconexión.
2015: no hubo respuesta para el comando o transacción.
4002: autorizador no disponible.
4004: tiempo máximo de espera excedido.

7. Recomendaciones para mostrar mensajes

Al comprador: presentar una explicación breve y segura, sin mostrar detalles de SSL, servidores, afiliaciones, reglas internas o bases de datos.

Al sistema de pagos: conservar el resultado técnico separado del estado comercial; solo confirmar aprobación cuando se cumplan las tres validaciones.

8. Lista de verificación de integración

Interpretar codigoRespuesta conforme a los valores acordados.
Evaluar ccErrorCode y ccReturnMsg como detalle del resultado.
Validar codigoAprobacion como cadena numérica de seis dígitos en todas las operaciones financieras.
No confirmar respuestas inconsistentes.
Tratar timeouts y ausencia de respuesta como indeterminados.
Evitar reintentos automáticos cuando no se conoce el resultado.
Registrar identificadores y referencias para conciliación.
No exponer datos sensibles ni detalles de infraestructura a compradores.
Validar las reglas operativas de cada método antes de ejecutar operaciones posteriores.

9. Alcance y mantenimiento del catálogo

Regla editorial: este documento describe únicamente la interfaz pública del comercio integrador. No expone variables, códigos de origen ni detalles de interpretación internos.

1. Campos de respuesta

Campo	Tipo	Uso
`codigoRespuesta`	Entero	Resultado general: habitualmente `0` = aprobada y `1` = declinada.
`ccErrorCode`	Entero	Código específico que describe el resultado o la incidencia.
`ccReturnMsg`	Cadena	Mensaje descriptivo asociado al código.
`codigoAprobacion`	Cadena	Código de autorización de exactamente seis dígitos numéricos, obligatorio para confirmar una operación aprobada.

Nota: codigoAprobacion es un campo de validación complementario; el catálogo de errores propiamente dicho está formado por ccErrorCode y ccReturnMsg.

2. Regla universal para confirmar una aprobación

En todas las operaciones de procesamiento financiero, tanto de Pagos en Línea como de Tarjeta Presente, el integrador debe verificar simultáneamente:

codigoRespuesta == 0.
ccErrorCode == 0.
codigoAprobacion presente y con exactamente seis dígitos (^[0-9]{6}$).

La generación de sesiones y otras operaciones no financieras quedan fuera de esta regla.

Ejemplo de aprobación (valores ilustrativos)

<codigoRespuesta>0</codigoRespuesta>
<ccErrorCode>0</ccErrorCode>
<ccReturnMsg>Aprobada</ccReturnMsg>
<codigoAprobacion>004581</codigoAprobacion>

Ejemplo de declinación (valores ilustrativos)

<codigoRespuesta>1</codigoRespuesta>
<ccErrorCode>51</ccErrorCode>
<ccReturnMsg>Fondos Insuficientes</ccReturnMsg>
<codigoAprobacion></codigoAprobacion>

Ejemplo de resultado no confirmado (valores ilustrativos)

<codigoRespuesta>0</codigoRespuesta>
<ccErrorCode>0</ccErrorCode>
<ccReturnMsg>Aprobada</ccReturnMsg>
<codigoAprobacion></codigoAprobacion>

Resultado: no confirmado; requiere verificación o conciliación.

Ejemplo de validación en JavaScript

function isApproved(response) {
  return (
    Number(response.codigoRespuesta) === 0 &&
    Number(response.ccErrorCode) === 0 &&
    typeof response.codigoAprobacion === 'string' &&
    /^[0-9]{6}$/.test(response.codigoAprobacion)
  );
}

No convertir codigoAprobacion a número: los ceros iniciales son significativos para su formato.

3. Clasificación y manejo de respuestas

Situación	Interpretación para el integrador	Acción recomendada
Tres condiciones de aprobación satisfechas	APROBADA	Registrar aprobación y confirmar la operación comercial.
`codigoRespuesta = 1` y respuesta completa	DECLINADA	Registrar rechazo y utilizar `ccErrorCode` / `ccReturnMsg` para explicar la causa.
`codigoRespuesta = 0`, `ccErrorCode != 0`	NO CONFIRMADA / INCONSISTENTE	No confirmar; verificar el resultado.
`codigoRespuesta = 0`, sin código de aprobación válido	NO CONFIRMADA / INCONSISTENTE	No confirmar; verificar el resultado.
Sin respuesta, timeout o XML incompleto	INDETERMINADA	Consultar o conciliar antes de reintentar.
Código general distinto de `0` o `1`	REQUIERE REVISIÓN	Aplicar las reglas oficiales que correspondan; no inferir resultado.

Los estados en mayúsculas son estados internos sugeridos para la aplicación del comercio; no son valores adicionales devueltos por Bloomin.

Advertencia: recibir HTTP 200 no demuestra aprobación financiera. Tampoco debe considerarse un timeout como una declinación.

4. Catálogo público de códigos

Las tablas siguientes contienen únicamente los campos que el integrador puede utilizar: ccErrorCode y ccReturnMsg. Se agrupan por familia funcional para facilitar la consulta.

Respuestas del procesador

`ccErrorCode`	`ccReturnMsg`
0	Aprobada
1	Consulte al Emisor de la Tarjeta
2	Solicitar Autorización al Emisor
3	Comercio Inválido
4	Reintente con otra Tarjeta
5	Denegada. Intente con otra Tarjeta
6	Denegada. Contacte a su Banco
7	Reintente con otra Tarjeta
8	Identificador No Reconocido
9	No se puede revertir la transacción anterior
11	Approval VIP
12	Transacción Inválida
13	Monto Inválido
14	Tarjeta Inválida
15	Emisor Desconocido
30	Error de Formato
31	Tarjeta No Soportada
33	Tarjeta Vencida
34	Tarjeta Restringida
35	Tarjeta Restringida
36	Tarjeta Restringida
37	Tarjeta Restringida
38	Ha excedido los Intentos de PIN
39	Sin cuenta de ahorro
41	Tarjeta Extraviada
43	Tarjeta con Reporte de Robo
51	Fondos Insuficientes
54	Tarjeta Vencida
55	PIN Incorrecto
56	Tarjeta sin Activar
57	Transacción No Permitida
58	Transacción Invalida
59	Código CVV/CVC Requerido
61	Monto Excedido
62	Tarjeta Restringida
65	Excede la Frecuencia de Uso
68	Mal funcionamiento de la Plataforma
75	Número de Intentos Excedido
76	Reservado
77	Reservado
78	Cuenta Invalida
79	Reservado
81	Reservado
82	Violación de Seguridad
83	Reservado
84	Reservado
85	Reservado
86	Reservado
87	Datos de Track Erroneos
88	Reservado
89	Terminal Invalida
90	Emisor no disponible
91	Emisor no disponible
92	No se puede enrutar la transacción
94	No se puede revertir la transacción anterior
96	Emisor No Disponible
100	No es posible Autorizar
101	Reservado
102	La Autorización previa fue completada
103	Reservado
104	Reservado
105	Reservado
106	Reservado
107	Reservado
108	Reservado
109	Reservado
110	Reservado
111	Reservado
112	Reservado
113	Reservado
114	Reservado
115	Reservado
116	Reservado
117	Reservado
118	Reservado
119	Reservado
120	Reservado
121	Limite Diario Excedido
122	Reservado
123	Reservado
124	Reservado
125	Reservado
126	Reservado
127	Reservado
128	Reservado
129	Reservado
130	Reservado
131	Reservado
132	Reservado
133	Reservado
134	Reservado
135	Reservado
136	Reservado
137	Reservado
138	Reservado
139	Reservado
140	Reservado
141	Reservado
142	Reservado
143	Reservado
144	Reservado
145	Reservado
146	Reservado
147	Reservado
148	Reservado
154	PTLF Completo
155	Error
156	Reservado
157	Reservado
158	No existe el Registro
159	Reservado
161	Reservado
162	Reservado
163	Tarjeta No Soportada
164	Reservado
165	Declinado. Reservado CAF 3D
166	Reservado
167	Reservado
168	Limite Contactless Excedido. Favor de Insertar Tarjeta
199	Declinado General

Seguridad SSL y certificados

`ccErrorCode`	`ccReturnMsg`
701	El algoritmo definido para encriptar en SSL no está soportado en esta plataforma.
702	Falla inesperada al accesar almacén de llaves (keystore).
703	El almacén de llaves (keystore) especificado no existe en la ubicación configurada.
704	El almacén de llaves (keystore) configurado no es válido o está corrupto.
705	El acceso al almacén de llaves (keystore) fue denegado por falta de permisos.
706	Falla general de seguridad en manejo de SSL.

Sockets de servidor

`ccErrorCode`	`ccReturnMsg`
801	Falla al inicializar servidor de sockets.

Conectividad y sockets de cliente

`ccErrorCode`	`ccReturnMsg`
901	Falla al intentar crear socket en cliente hacia servidor xxx.
902	Incapaz de establecer conexión con servidor xxx.
903	No se tiene conexión actualmente con el servidor. Se intenta reconexión.

Formato y codificación ISO

`ccErrorCode`	`ccReturnMsg`
1001	El mensaje ISO recibido no tiene el formato esperado.
1002	El mensaje ISO recibido contiene una TPDU no válida.
1003	El mensaje ISO recibido no tiene un mapa de bits consistente.
1004	El mensaje ISO recibido tiene un terminador no válido.
1005	Falla al decodificar el campo xxx.
1006	Falla al codificar el campo xxx. Valor: yyy
1007	El contenido del campo excede el máximo permisible.
1008	El tipo del campo xxx no es del tipo esperado
1009	El juego de caracteres ISO-8859-1 no está soportado en esta plataforma
1010	El campo xxx está incompleto
1011	El campo xxx no es válido.
1012	La longitud del campo variable xxx excede lo indicado en el prefijo.
1013	El contenido del campo xxx no es válido
1014	El modo de entrada (campo 22) no es válido.
1015	El campo xxx es requerido y no fue incluido en el mensaje ISO.
1016	El mensaje de estadísticos recibido no tiene el formato esperado

Validación y procesamiento de comandos

`ccErrorCode`	`ccReturnMsg`
2001	Falla inesperada al intentar procesar transacción
2002	El parámetro 'xxx' no puede incluirse en una transacción manual.
2003	El parámetro 'xxx' no puede incluirse en una transacción con plástico presente.
2004	El parámetro 'xxx' con valor 'yyy' sólo es requerido en una transacción de chip.
2005	El parámetro 'xxx' con valor 'yyy' no es compatible con una transacción manual.
2006	El parámetro 'xxx' con valor 'yyy' no es compatible con una transacción con plástico presente.
2007	La información sobre la promoción en la transacción no está completa.
2008	El parámetro 'xxx' con valor ''yyy' corresponde a una fecha expirada.
2009	El comando requiere 'REFERENCIA' o 'NUMERO_CONTROL'.
2010	No se especificó el parámetro requerido 'CMD_TRANS'.
2011	El comando/transacción 'xxx' no es válido(a) o no está soportado(a).
2012	El valor 'yyy' suministrado para el parámetro 'xxx' es inválido.
2013	El valor 'yyy' suministrado para el parámetro 'xxx' excede la longitud máxima permitida: zzz.
2014	El parámetro 'xxx' no puede ser nulo
2015	No hubo respuesta para el comando/transacción.

Reglas transaccionales, afiliación y permisos

`ccErrorCode`	`ccReturnMsg`
3001	Incapaz de realizar operación. Por favor intente más tarde.
3002	La afiliación o el usuario proporcionados no existen.
3003	Usuario o contraseña inválidos.
3004	La afiliación xxx no se encuentra activa.
3005	El cliente xxx no se encuentra activo.
3006	El usuario xxx no se encuentra activo.
3007	El usuario xxx no tiene el permiso necesario para ejecutar comandos/transacciones.
3008	La terminal xxx no existe para esta afiliación.
3009	La terminal xxx no se encuentra activa.
3010	Transacción no permitida para esta terminal y marca de tarjeta.
3011	El comando xxx no está soportado actualmente
3012	La transacción referenciada xxx no existe
3013	La transacción referenciada xxx ya había sido cancelada
3014	Rechazada: El 100% del importe de la transacción referenciada xxx ya ha sido devuelto
3015	Rechazada: La transacción referenciada xxx ya tiene devoluciones parciales aplicadas
3016	La transacción referenciada xxx no permite devoluciones
3017	No es posible efectuar una devolución sobre la transacción xxx, la cual no ha sido cerrada
3018	El importe de la devolución por xxx excede el máximo disponible: yyy
3019	No se admite el cierre de reautorizaciones; utilice la preautorización original
3020	Sólo se permiten postautorizaciones para preautorizaciones abiertas
3021	El monto de la postautorización por xxx excede el máximo disponible: yyy
3022	Sólo se permiten reautorizaciones para preautorizaciones abiertas
3023	El tipo de aplicación xxx no permite reautorizaciones
3024	La transacción referenciada xxx no permite cancelaciones
3025	No es posible efectuar una cancelación sobre la transacción xxx, la cual no ha sido cerrada
3026	No tiene el permiso para ejecutar una cancelación
3027	No tiene el permiso para ejecutar una transacción de cashback
3028	La transacción de crédito no está habilitada
3029	No se tiene el permiso necesario para ejecutar una transacción de devolución
3030	Las devoluciones tardías (sin restricción de batch) no están habilitadas
3031	No se tiene el permiso necesario para efectuar una transacción con promoción
3032	No se tiene el permiso necesario para ejecutar transacciones QPS
3033	No se tiene el permiso necesario para realizar una venta forzada
3034	El monto indicado en la transacción QPS excede el máximo permisible
3035	La afiliación requiere que se proporcione una terminal válida
3036	La terminal por defecto no ha sido creada en la base de datos
3037	No hay soporte para las tarjetas de marca xxx
3038	No hay soporte para el autorizador xxx
3039	El No. de Control xxx ya existe para una transacción anterior
3040	No se permite monto cero en una transacción
3041	Las transacciones FALLBACK no están permitidas
3042	El indicador de 3DSecure (ECI) recibido para esta transacción no está permitido
3043	La operación previa requerida para ejecutar esta transacción no tuvo éxito
3044	La operación previa requerida para ejecutar esta transacción fue declinada por el autorizador
3045	La operación previa requerida para ejecutar esta transacción no tuvo respuesta
3046	El código de seguridad es requerido y no fue proporcionado
3047	El modo de entrada de la transacción no es compatible con el tipo de afiliacion: xxx
3048	No se tiene el permiso necesario para ejecutar transacciones tecleadas o manuales
3049	La transacción referenciada xxx ya había sido reversada
3050	La transacción referenciada no admite reversas
3051	La transacción referenciada xxx no había sido aprobada
3052	La transacción referenciada xxx se encuentra en estado de suspensión
3054	No se encontró ninguna transacción para la afiliación/terminal suministrados
3055	La transacción referenciada existe, pero no fue generada por la terminal proporcionada
3056	La transacción referenciada existe, pero no pertenece a la afiliación proporcionada
3057	El cierre del lote xxx ya está en proceso; no puede ejecutarse concurrentemente más de una vez
3058	El cierre masivo para esta afiliación ya está en proceso; no puede ejecutarse concurrentemente más de una vez
3059	No se especificó modo de la transacción (si es ISO verifique que la afiliación sea de tipo TPV).
3060	La afiliación es de tipo TPV; no es válido proporcionar el parámetro MODO
3061	La afiliación ha sido configurada como agregador pero el indicador de formato es nulo
3062	La afiliación es un agregador; se requiere obligatoriamente el nombre del comercio asociado (SUB_AFILIACION)
3063	Esta transacción no es aceptable con pago móvil
3064	No se tiene el permiso necesario para ejecutar transacciones de pago móvil
3065	Esta tarjeta no está autorizada para realizar transacciones de pago móvil
3066	La transacciones de pago móvil únicamente pueden ser digitadas
3067	El valor del tipo de plan suministrado xxx es inválido
3068	La promoción proporcionada es inválida o no está soportada
3069	El tipo de plan xxx es inconsistente con la promoción proporcionada
3070	No se admite esta transacción en modo de prueba, ya que la transacción referenciada fue enviada en modo de producción
3071	No se admite esta transacción en modo de producción, ya que la transacción referenciada fue enviada en modo de prueba
3072	El monto a disponer en esta transacción está por debajo del mínimo requerido
3073	El monto a disponer en esta transacción excede el máximo autorizado
3074	El número máximo de transacciones cashback que pueden ejecutarse en un día ha sido ya alcanzado
3075	Transacción rechazada ya que se excedería el monto máximo diario autorizado de disposición cashback
3076	No se admiten reautorizaciones de una transacción previa de tipo EMV; se requiere nueva lectura de plástico

Conector y autorizador

`ccErrorCode`	`ccReturnMsg`
4001	El conector hacia el autorizador xxx no tiene canales configurados
4002	El autorizador xxx no está disponible
4003	La transacción xxx no está soportada para el autorizador yyy
4004	El tiempo máximo de espera para la transacción xxx ha sido excedido
4005	El track 1 es requerido por el autorizador para esta transacción
4006	No hay información en la base de datos sobreafiliación/terminal para enviar hacia el autorizador xxx
4007	No existe no. de terminal para enviar hacia el autorizador xxx
4008	No existe no. de afiliación para enviar hacia el autorizador xxx
4009	El valor para el tipo de plan ('xxx') no es válido
4010	El valor para el tipo de plan ('xxx') no es congruente con el resto de parámetros de la promoción
4011	La promoción debe incluir diferimiento inicial y/o número de pagos
4012	La información de EMV suministrada no es válida o está incompleta
4013	Falla al decodificar token xxx: El valor ‘yyy’ para el subcampo zzz no es aceptable de acuerdo a especificación.

Base de datos

`ccErrorCode`	`ccReturnMsg`
5001	Falla al intentar ejecutar la siguiente operación en base de datos: xxx.

Reglas configurables de negocio

`ccErrorCode`	`ccReturnMsg`
6001	Transacción rechazada por aplicación de la regla xxx asignada para esta afiliación.
6002	Transacción rechazada por error en la fórmula definida para la regla xxx asignada para esta afiliación.
6003	Transacción rechazada por falla al procesar la fórmula definida para la regla xxx asignada para esta afiliación.
6004	La clase definida para la regla xxx no ha sido implementada.
6005	Falla al instanciar clase definida para la regla xxx
6006	Condición inválida de búsqueda en regla xxx.
6007	La tala de búsqueda proporcionada en la fórmula para la regla xxx no existe.
6008	El archivo Excel requerido por la fórmula definida para la regla xxx no existe.
6009	Falla al intentar accesar el archivo Excel requerido por la fórmula definida para la regla xxx.
6010	Falla al ejecutar búsqueda en tabla requerida por la regla xxx.
6011	Incapaz de cargar driver Excel para ejecutar regla xxx.

Error general de aplicación

`ccErrorCode`	`ccReturnMsg`
9999	Falla inesperada en aplicación.

Código general de aplicación

5. Guía de tratamiento por tipo de error

Códigos orientativos	Tipo de incidencia	Manejo recomendado
`1`–`9`, `12`–`15`, `30`–`96`, `100`–`168`, `199`	Respuestas del procesador y rechazos de tarjeta	Mostrar un mensaje apropiado y registrar el resultado. No asumir que cualquier código permite reintento inmediato.
`701`–`706`	Seguridad y configuración SSL	Escalar al equipo técnico; no pedir al comprador que repita indefinidamente.
`801`, `901`–`903`	Conectividad	Evaluar posible resultado indeterminado y verificar antes de reenviar.
`1001`–`1016`	Formato de mensajes	Revisar la construcción de la solicitud y la integración.
`2001`–`2015`	Parámetros y procesamiento	Corregir parámetros o verificar estado según el mensaje específico.
`3001`–`3076` (códigos existentes en catálogo)	Reglas, permisos, afiliaciones y transacciones previas	Revisar configuración, estado original y elegibilidad de la operación.
`4001`–`4013`	Autorizador y conectores	Escalar a soporte o conciliar; especial atención al timeout `4004`.
`5001`	Base de datos	Registrar incidencia y escalar a soporte.
`6001`–`6011`	Reglas configurables	Revisar reglas y configuración; escalar a soporte técnico.
`9999`	Error general	Registrar incidencia y solicitar diagnóstico.

Las agrupaciones son orientativas; cada código debe interpretarse por su mensaje y contexto, no solo por su rango.

6. Casos que requieren especial atención

Devoluciones

3014: la transacción ya tiene devuelto el 100 % del importe.
3015: la transacción ya tiene devoluciones parciales aplicadas.
3016: la transacción no permite devoluciones.
3017: la transacción no ha sido cerrada.
3018: el importe solicitado supera el máximo disponible.

Estos códigos describen validaciones que pueden ocurrir. No constituyen, por sí mismos, una política completa sobre devoluciones parciales múltiples.

Postautorizaciones y operaciones previas

3019: no se admite el cierre de reautorizaciones; se requiere la preautorización original.
3020: solo se permiten postautorizaciones de preautorizaciones abiertas.
3021: el importe supera el máximo disponible.
3043–`3045`: problemas con la operación previa requerida.

Cancelaciones y reversas

3024–`3026`: restricciones de cancelación y permisos.
3049: la transacción ya fue reversada.
3050: la transacción no admite reversas.
3051: la transacción referenciada no fue aprobada.
3052: la transacción está suspendida.

Timeouts e indisponibilidad

903: sin conexión actual; se intenta reconexión.
2015: no hubo respuesta para el comando o transacción.
4002: autorizador no disponible.
4004: tiempo máximo de espera excedido.

7. Recomendaciones para mostrar mensajes

Al comprador: presentar una explicación breve y segura, sin mostrar detalles de SSL, servidores, afiliaciones, reglas internas o bases de datos.

Al sistema de pagos: conservar el resultado técnico separado del estado comercial; solo confirmar aprobación cuando se cumplan las tres validaciones.

8. Lista de verificación de integración

Interpretar codigoRespuesta conforme a los valores acordados.
Evaluar ccErrorCode y ccReturnMsg como detalle del resultado.
Validar codigoAprobacion como cadena numérica de seis dígitos en todas las operaciones financieras.
No confirmar respuestas inconsistentes.
Tratar timeouts y ausencia de respuesta como indeterminados.
Evitar reintentos automáticos cuando no se conoce el resultado.
Registrar identificadores y referencias para conciliación.
No exponer datos sensibles ni detalles de infraestructura a compradores.
Validar las reglas operativas de cada método antes de ejecutar operaciones posteriores.

9. Alcance y mantenimiento del catálogo

Regla editorial: este documento describe únicamente la interfaz pública del comercio integrador. No expone variables, códigos de origen ni detalles de interpretación internos.

¿Listo para integrar?

Comienza en ambiente de desarrollo, valida tus primeras operaciones y prepara tu integración para certificación. Cuando el flujo este completo, podrás solicitar el paso a produccion.

Ver Ambiente de Desarrollio

Consultar Referencia API

¿Listo para integrar?

Comienza en ambiente de desarrollo, valida tus primeras operaciones y prepara tu integración para certificación. Cuando el flujo este completo, podrás solicitar el paso a produccion.

Ver Ambiente de Desarrollio

Consultar Referencia API

OEL

Politica de Privacidad

Terminos y Condiciones

OEL

Politica de Privacidad

Terminos y Condiciones