Códigos de error y descripciones

Este artículo brinda información sobre códigos de error y las posibles acciones que puede tomar.

Códigos HTTP

Código	Descripción	Uso
`200`	Ok	El request se ha procesado correctamente.
`400`	Bad Request	El request está malformado o falta algún parámetro requerido.
`401`	Unauthorized	Fallo de autenticación.
`403`	Forbidden	No tiene permiso para realizar la operación solicitada.
`404`	Not Found	No se ha encontrado el recurso solicitado.
`405`	Method not Allowed	Método de request incorrecto (por ejemplo, GET en lugar de POST).
`408`	Request Timeout	El request no ha podido completarse en el tiempo máximo configurado.
`500`	Internal Server Error	Se ha producido un error en el servicio.
`503`	Service Unavailable	El servicio está en mantenimiento o tiene problemas de acceso.

Multilenguaje para errores

Puede recibir la descripción del error basándose en las funciones de localización. Para ello, debe enviar el encabezado lang en su integración, utilizando cualquiera de los siguientes idiomas en formato ISO 639-1.

Código	Idioma
`en`	Inglés. Este es el idioma por defecto. Si no envía este encabezado o envía un idioma diferente a los soportados, recibirá los errores en este idioma.
`es`	Español.
`pt`	Portugués.

Códigos de Error

Info

El código de error para errores desconocidos o indeterminados es ERR999. En este caso, contacte a Soporte de Bamboo para obtener más información.

Errores del servicio Tokenization

Los errores del servicio Tokenization empiezan por TK.

Código	Descripción	Posible solución
`TK001`	El número de tarjeta introducido es incorrecto.	Pida a su cliente que compruebe el número de tarjeta y vuelva a intentar la transacción.
`TK002`	El número CVV introducido es incorrecto.	Pida a su cliente que compruebe el código de validación y vuelva a intentar la transacción.
`TK003`	La fecha de expiración de la tarjeta es incorrecta.	Pida a su cliente que compruebe la fecha de expiración y vuelva a intentar la transacción.
`TK004`	Se ha enviado un identificador de sesión no válido en una solicitud de token.	Regenere el token y vuelva a intentar la transacción.
`TK005`	Se ha introducido un correo electrónico con formato incorrecto.	Pida a su cliente que compruebe la dirección de correo electrónico y vuelva a intentar la transacción.
`TK006`	El token (de tipo One-Time) ya se ha utilizado o ha caducado.	Regenere el token (OTT) y vuelva a intentar la transacción.
`TK007`	Error con la información del medio de pago.	El `PaymentMediaId` no es correcto. Compruebe el valor del medio de pago en la lista de países correspondiente.
`TK008`	El banco emisor no coincide con el esperado.	Valide el banco emisor de la tarjeta de su cliente.
`TK009`	El código de activación del token no es válido.	Contacte a Soporte Bamboo para activar el medio de pago.
`TK010`	El token de comercio no es válido.	Regenere el token (CT) y vuelva a intentar la transacción.
`TK011`	El cliente especificado no es válido.	El cliente utilizado para crear el token no se ha encontrado o no es válido.
`TK012`	Error al activar el código.	Contacte a Soporte Bamboo para activar el medio de pago.
`TK013`	Error en el proceso de registro.	Contacte a Soporte Bamboo para activar el medio de pago.
`TK014`	Medio de pago deshabilitado.	Contacte a Soporte Bamboo para activar el medio de pago.
`TK015`	El medio de pago no está disponible para el comercio.	Compruebe que haya habilitado el medio de pago seleccionado.
`TK016`	Se ha producido un error en el proceso de registro del medio de pago.	Contacte a Soporte Bamboo para activar el medio de pago.
`TK017`	Documento no válido.	El documento proporcionado no es válido según las normas del país.
`TK018`	Tipo de documento no válido.	El tipo de documento enviado no es válido o no pertenece al país.
`TK019`	Tipo de pago no válido.	El tipo de pago enviado no es válido o no pertenece al país.
`TK999`	Error desconocido.	Contacte a Soporte Bamboo para más información.

Errores del servicio Transactions

Los errores del servicio Transactions empiezan por TR.

Código	Descripción	Posible solución
`TR001`	Error de comunicación con el servicio de adquisición.	Contacte a Soporte Bamboo para más información.
`TR002`	La transacción asociada a la compra se encuentra en un estado que no permite la ejecución de la operación actual. Este error se produce, por ejemplo, cuando se quiere realizar una operación Commit sobre una Compra que ya está autorizada o rechazada.	Contacte a Soporte Bamboo para más información.
`TR003`	Problemas con la cuenta de comercio en el Adquirente.	Contacte con Soporte Bamboo para más información.
`TR004`	Error al enviar la transacción a la entidad adquirente a través del proxy.	Contacte con Soporte Bamboo para más información.
`TR005`	Error interno del Adquirente.	Contacte con Soporte Bamboo para más información.
`TR006`	Número de orden duplicado en la Adquirente.	Contacte con Soporte Bamboo para más información.
`TR007`	Errores en los datos de pago (número de tarjeta, código de verificación o fecha de expiración).	Pida a su cliente que verifique la información de la tarjeta y vuelva a intentar la transacción.
`TR008`	El importe que pretende confirmar es superior al autorizado previamente.	La operación de confirmación se solicitó por un monto superior al autorizado. Envíe un valor igual o inferior al de la autorización original.
`TR009`	Error de Adquirente Desconocido.	Contacte a Soporte Bamboo para más información.
`TR010`	Número de documento del cliente no válido en la entidad adquirente.	El cliente debe comprobar el tipo y número de documento facilitado y volver a intentar la transacción. En caso contrario, deberá ponerse en contacto con el banco emisor de su tarjeta.
`TR011`	Tarjeta bloqueada o extraviada.	Su cliente debe comprobar la tarjeta utilizada o ponerse en contacto con el banco emisor de la tarjeta para desbloquearla antes de reintentar la transacción.
`TR012`	Se ha superado el límite de crédito.	Su cliente debe intentar realizar la compra utilizando una tarjeta diferente, aumentar el límite de la tarjeta o liberar fondos disponibles.
`TR013`	La entidad adquirente o el emisor han denegado la transacción.	La entidad adquirente o el banco emisor de la tarjeta ha rechazado la transacción. Este rechazo puede tener múltiples causas dependiendo de la entidad adquirente contratada y configurada por usted. Contacta con Soporte Bamboo para más información.
`TR014`	La Entidad Adquirente ha rechazado la operación por posible fraude.	La Adquirente ha rechazado la transacción basándose en su sistema antifraude. Las normas antifraude de la Adquirente están asociadas al tipo de negocio del comercio (línea, categoría, productos) y al contrato firmado para el terminal de compra online solicitado. Usted (como comercio) debe ponerse en contacto con la entidad adquirente para determinar si es necesario realizar un ajuste de las normas antifraude.
`TR015`	El Adquirente sugiere la revisión manual de la transacción. Por ejemplo, en caso de sospecha de fraude.	Contacte a Soporte Bamboo para más información.
`TR016`	Error en los parámetros comunicados a la entidad adquirente.	Algunos de los datos que proporciona el cliente al realizar la compra son incorrectos o incompletos. El cliente debe verificar si ha facilitado la dirección (junto con ciudad y país), nombre y apellidos, y documento. Contacte con Soporte Bamboo si no puede verificarlo.
`TR017`	Tipo de transacción no válida.	Contacte a Soporte Bamboo para más información.
`TR018`	La entidad adquirente ha denegado el registro de la tarjeta.	Contacte con Soporte Bamboo para más información.
`TR019`	La entidad adquirente o el procesador han rechazado la transacción.	La entidad adquirente o el banco emisor de la tarjeta ha rechazado la transacción. Este rechazo puede tener múltiples causas dependiendo de la adquirencia contratada y configurada por usted. Contacta con Soporte Bamboo para más información.
`TR020`	El emisor ha rechazado la transacción, sin embargo, el emisor puede autorizarla verbalmente.	El banco ha rechazado la compra online. El cliente debe ponerse en contacto con el banco emisor de la tarjeta para autorizar la compra. Error relacionado `TR023`
`TR021`	La fecha de expiración no coincide o tarjeta expirada.	La entidad adquirente indica que la tarjeta está caducada o que la fecha de caducidad facilitada por el cliente es incorrecta. El cliente debe validar esta información en la tarjeta antes de reintentar la compra.
`TR022`	El emisor indica que el CVV no es válido.	La entidad adquirente indica que el código de validación de la tarjeta (CVV) es incorrecto. Su cliente debe validar esta información en la tarjeta antes de reintentar la compra.
`TR023`	La tarjeta está inactiva, o usted no está autorizado a realizar esta transacción.	La tarjeta utilizada por el cliente no está habilitada para realizar compras online. El cliente debe ponerse en contacto con el banco emisor de la tarjeta y habilitar las compras en línea. Si la tarjeta está autorizada para realizar compras en línea, verifique su autorización de uso dentro de la región geográfica de la tienda.
`TR024`	Se ha superado la frecuencia de uso o el importe máximo.	La tarjeta del cliente ha sobrepasado la frecuencia de uso permitida o ha superado el límite de importe especificado en un periodo determinado. El cliente debe ponerse en contacto con el banco emisor de su tarjeta para determinar el periodo de espera adecuado antes de volver a intentar la compra.
`TR025`	Los datos de dirección no se pueden validar o son incorrectos.	Contacte a Soporte Bamboo para más información.
`TR026`	Fondos insuficientes.	Su cliente debe intentar realizar la compra utilizando una tarjeta diferente, aumentar el límite de la tarjeta o liberar fondos disponibles.
`TR027`	La entidad adquirente ha rechazado la transacción y debe solicitar autorización.	El banco ha rechazado la compra online. El cliente debe ponerse en contacto con el banco emisor de la tarjeta para autorizar la compra. Error relacionado `TR023`
`TR028`	La entidad adquirente denegó la transacción porque el monto pagado por el cliente no coincidía con el monto de la compra. En este caso, el banco devuelve al cliente el monto pagado.	El cliente debe reintentar el pago con el mismo valor del monto de la compra.
`TR030`	Se ha excedido el límite de intentos permitidos	El cliente debe utilizar otra tarjeta para realizar la compra, la tarjeta utilizada ha excedido la cantidad de compras permitidas en el mes, semana o día.
`TR031`	Cuenta cerrada	El banco ha detectado que la cuenta asociada a la tarjeta, ha sido cerrada. El cliente debe contactarse con el banco de la tarjeta para habilitar la cuenta nuevamente o utilizar otra tarjeta.
`TR032`	Declinada - contacte al banco emisor de su tarjeta	El banco ha rechazado la compra online. El cliente debe ponerse en contacto con el banco emisor.
`TR033`	Cuotas no permitidas para tarjetas internacionales	El cliente debe utilizar una tarjeta no internacional para realizar la compra en cuotas
`TR075`	La respuesta de 3DSecure indica que debe solicitar la validación del cliente.	Respuesta de la entidad adquirente indicando que se requiere la validación del cliente (Verified by Visa o HighProtection siendo Santander).
`TR076`	La autenticación del pagador falla.	La entidad adquirente indica que ha fallado la verificación adicional (o verificación en dos pasos) (HighProtection para Santander o Verified By Visa para otros bancos). El cliente debe ponerse en contacto con el banco emisor de la tarjeta o con el home banking del banco para comprobar si el servicio está habilitado. Si está habilitado, verifique qué configuración tiene (verificación por email, SMS, token, etc) y vuelva a intentar la compra.
`TR100`	La entidad adquirente rechaza por muchos motivos.	Contacta a Soporte Bamboo para más información.
`TR101`	La entidad adquirente no puede procesar el reembolso. Póngase en contacto con la entidad adquirente.	Contacte con Soporte Bamboo para más información.
`TR301`	Rechazado por el sistema antifraude	Sistema antifraude de Bamboo. Valide con Soporte Bamboo qué regla se vio afectada antes de que tu cliente reintente la compra.
`TR302`	Parámetros no válidos para el sistema antifraude de Bamboo. Valide con Soporte de Bamboo qué regla se vio afectada antes de que tu cliente reintente la compra.
`TR996`	Ocurrió un error interno ejecutando la solicitud.	Vuelva a intentarlo más tarde. Si el error persiste, contacte a Soporte Bamboo para más información.
`TR997`	Se ha producido un error al ejecutar el proceso actual.	Contacte a Soporte Bamboo para más información.
`TR999`	Error indeterminado al ejecutar la transacción.	Contacte a Soporte Bamboo para más información .

Errores del servicio Purchase

Los errores del servicio Purchase empiezan por PR.

Código	Descripción
`PR001`	El token informado no es válido, ha caducado o no corresponde al comercio.
`PR002`	El número de orden no es válido.
`PR003`	El monto proporcionado es inválido. Asegúrese de que no esté nulo o vacío y, en caso de reembolsos, de que no exceda el monto de la compra original.
`PR004`	El parámetro de moneda de la compra es inválido.
`PR005`	El número de factura no es válido (debe ser numérico).
`PR006`	Identificador inválido para la compra.
`PR007`	Identificador de transacción inválido.
`PR008`	No se encuentra la compra solicitada.
`PR009`	El estado actual de la compra no permite la operación solicitada.
`PR010`	El campo `TaxableAmount` es obligatorio.
`PR011`	El campo `Invoice` es obligatorio.
`PR012`	Se requiere la captura del código de verificación de la tarjeta.
`PR013`	Los plazos seleccionados para la compra no son válidos para la tarjeta.
`PR014`	Descripción de longitud de parámetro no válida.
`PR015`	El parámetro `UserAgent` está vacío.
`PR016`	El parámetro `CustomerIP` está vacío.
`PR017`	El campo `TaxableAmount` no puede ser mayor que el importe total de la compra.
`PR018`	Para filtrar por fechas, debe introducir el valor de los parámetros `From` y `To`.
`PR019`	El periodo de búsqueda excede el número máximo de días.
`PR020`	Documento registrado inválido.
`PR021`	No se permiten devoluciones parciales para el medio de pago utilizado.
`PR034`	El valor del campo `TargetCountryISO` enviado en la compra es inválido.

Errores del servicio Customers

Los errores del servicio Customer empiezan por CS.

Código	Descripción
`CS001`	Dirección de correo electrónico no válida.
`CS002`	Tipo de dirección no válida.
`CS003`	Identificador de cliente no válido.
`CS004`	Se ha producido un error en la creación del token.
`CS005`	E-mail ya registrado.
`CS006`	El parámetro `AdditionalData` no fue enviado correctamente, debe ser `key:value` separado por punto y coma.
`CS007`	Número de documento de cliente no válido.
`CS008`	Tipo de documento de cliente inválido.
`CS009`	Ya existía un `CommerceToken` para la tarjeta.
`CS010`	Perfil de pago no válido.
`CS011`	Identificador de perfil de pago no válido.

Errores del servicio Planes de fidelización

Los errores de Planes de fidelización empiezan por LP.

Código	Descripción
`LP0001`	El token es requerido.
`LP0002`	Plan de fidelización inválido.
`LP0003`	Error al consultar saldo de puntos.
`LP0004`	El programa no existe.
`LP0005`	El centro de Canje no existe.
`LP0006`	La sucursal no existe.
`LP0007`	El programa no está activo.
`LP0008`	El centro de Canje no está habilitado.
`LP0009`	El centro de Canje no pertenece al programa.
`LP0010`	El centro de Canje no activo para el programa.
`LP0011`	Sucursal no pertenece al Centro de Canje.
`LP0012`	El usuario no existe.
`LP0013`	El usuario no pertenece al Programa.
`LP0014`	La moneda no existe.
`LP0015`	La cotización no existe.
`LP0016`	El tipo de documento no existe.
`LP0017`	El cliente no existe.
`LP0018`	El saldo no existe.
`LP0019`	Token no encontrado.
`LP0020`	Tarjeta no encontrada.
`LP0021`	Tarjeta vencida.
`LP0022`	Error de sintaxis en el Programa.
`LP0023`	Error de sintaxis en el Centro de Canje.
`LP0024`	Error de sintaxis en la Sucursal.
`LP0025`	Error de sintaxis en la Moneda.
`LP0026`	Error de sintaxis en el Importe.
`LP0027`	Error de sintaxis en la Identificación de usuario (`LoyaltyPlanUserIdentification`).
`LP0028`	Error de sintaxis en la Tarjeta enmascarada.
`LP0029`	Error de sintaxis en el Id de la Transacción.
`LP0030`	Error de sintaxis en el Id de la Transacción de la Pasarela.
`LP0031`	Error de sintaxis en la cantidad de puntos.
`LP0032`	Error de sintaxis en la cantidad de cuotas.
`LP0033`	Error en el token (Authorization).
`LP0034`	La solicitud tiene una sintaxis incorrecta, es demasiado grande o tiene un formato de mensaje no válido.
`LP0035`	Credenciales inválidas.
`LP0036`	El usuario que inició sesión no tiene permiso para ver los datos del cliente.
`LP0037`	No se puede encontrar el recurso solicitado.
`LP0038`	El plan de fidelización es requerido.
`LP0039`	El identificador del cliente dentro del plan de fidelización es requerido.
`LP0040`	Error en los datos de ingreso.
`LP0041`	Cliente no autorizado.
`LP0042`	Saldo insuficiente.
`LP0043`	El token ha expirado.
`LP0044`	El movimiento está cancelado.
`LP0045`	El movimiento no existe.
`LP0046`	No coincide cantidad de puntos enviada con puntos del movimiento.
`LP0047`	El movimiento ya fue devuelto.
`LP0048`	El movimiento es una devolución.
`LP0049`	La pasarela de pagos no existe.
`LP0050`	`CustomerId` con formato incorrecto.
`LP0051`	No existe el punto.
`LP0052`	No coincide monto enviado con monto del movimiento.
`LP0053`	No coincide moneda enviada con moneda del movimiento.
`LP0054`	El cliente no existe o está inactivo.
`LP0055`	Cliente está bloqueado.

Última modificación 28 de noviembre de 2024