Guía

Solución de problemas

Encuentre lo que ve, verifique la causa probable y siga la solución. Si un pago estaba en curso, verifique primero su resultado: arreglar una conexión no le indica si se realizó un pago anterior.

Un pago o reembolso muestra Resultado desconocido

Advertencia

No vuelvas a cobrar ni reembolsar solo porque la aplicación no tiene respuesta. Es posible que la solicitud haya llegado a Adyen.

  1. Abra Historial, filtrar por Necesita atención y abra el pago o reembolso original.
  2. Toque Comprobar el resultado de nuevo. Para una terminal, la aplicación le pregunta el resultado de esa transacción.
  3. Si aún desconoce el resultado, busque el pago en Área de Clientes › Pagos › Lista de pagos por referencia, tiempo y monto. Decide qué hacer solo después de comprobarlo.

Un bloqueo o reinicio deja la operación interrumpida en el Historial como desconocida. No borre los datos de la aplicación para eliminarla.

Con Tap to Pay, Comprobar el resultado de nuevo usa primero una respuesta tardía y luego consulta el resultado original en la aplicación Payments seleccionada. Las consultas requieren la versión 1.8.0 o posterior; confirma el acceso beta con Adyen. Sin respuesta o con NotFound, el resultado sigue siendo desconocido. Revisa Customer Area › Payments › Payment list antes de volver a cobrar.

Volver al contenido

Un pago es rechazado o no procesado

La pantalla de resultados muestra el estado, el motivo y el consejo de Adyen. Sigue los consejos:

"No vuelva a intentarlo con esta tarjeta. Pídale al comprador una tarjeta o método de pago diferente".

ArreglarPregunta por otra tarjeta o método de pago. El banco del cliente puede explicar el rechazo; el Motivos de rechazo de Adyen explique el motivo mostrado.

causa

El emisor de la tarjeta rechazó esta tarjeta por un motivo que no cambiará, como una tarjeta bloqueada o restringida o sospecha de fraude, o la tarjeta no está permitida para este pago.

"Puedes intentarlo de nuevo".

ArreglarToque Inténtalo de nuevo, o pedir otra tarjeta.

causa

El pago fue cancelado, el PIN fue incorrecto o la tarjeta fue rechazada por un motivo que puede no repetirse, como fondos insuficientes.

"La terminal está ocupada con otra transacción o su menú de administración".

ArreglarFinalice el otro pago o abandone el menú y vuelva a intentarlo. Si la pantalla ofrece Cancelar la transacción actual del terminal, úselo solo para detener esa transacción y verifique su resultado antes de volver a intentarlo.

causa

El terminal está gestionando otro pago o mostrando su menú de administración.

"La terminal no está disponible en este momento".

ArreglarEspera un momento, comprueba que el terminal está encendido y conectado y vuelve a intentarlo. Ver abandonos de la red.

causa

El terminal o su lector de tarjetas no están disponibles temporalmente.

"El terminal no aceptó la solicitud. Verifique la configuración del Terminal antes de volver a intentarlo".

ArreglarEjecute las pruebas en Configuración › Terminal; ver emparejamiento y configuración. Si pasan, pídale a Adyen que verifique la configuración del terminal.

causa

El terminal rechazó la solicitud tal como fue enviada, generalmente debido a un problema de configuración.

"El terminal o su cuenta de Adyen no admite esta solicitud. Pídale al soporte de Adyen que verifique que esté habilitado y luego vuelva a intentarlo".

ArreglarPídale a Soporte de Adyen que verifique que esté habilitado para la cuenta de comerciante. Para Tap to Pay, verifique que Tap to Pay en Android esté habilitado, no solo Adyen Payments App role. Luego inténtalo de nuevo.

causa

El terminal o Adyen no ofrece lo que pidió el pago, muchas veces porque no está habilitado para la cuenta.

“No vuelvas a cobrar: este pago se realizó”.

ArreglarNo vuelvas a cargar. Reembolsarlo si el cliente no debe pagar.

causa

El pago fue aprobado a pesar de que el terminal informó una cancelación.

Volver al contenido

Falta una función de terminal opcional o los totales difieren

Falta una característica del terminal o se rechaza

Verifique el destino seleccionado y Capacidades de Adyen, actualice su configuración y confirme los roles API y la configuración de la cuenta Adyen. Los interruptores de caja locales por sí solos no habilitan un servicio en Adyen. Tap to Pay no ofrece flujos de trabajo de terminal físico. Para propinas, compare propinas en el terminal con propina de recibo.

Sólo se aprobó una parte del monto

Sigue el flujo de trabajo de pago parcial desde la pantalla de resultados. No vuelva a cargar el total original completo. Si se desconoce el resultado de un intento posterior, resolverlo antes de recolectar más.

Los totales del terminal no coinciden con Mini mPOS

Revise el período del terminal, otros dispositivos que utilizan ese terminal, el historial local retenido y las transacciones no resueltas en conciliación terminal. El cierre del período no soluciona diferencias ni confirma la liquidación.

Una venta offline no tiene referencia PSP o quedan lotes sin confirmar

Seguir cheques de pago fuera de línea. Restablezca la conexión del terminal con Adyen y verifique sus pagos cargados en el Área de Clientes. No vuelva a cobrar un pago aprobado solo porque falta su referencia PSP.

Volver al contenido

Falta la billetera escaneada o el escaneo falla

No aparece el botón Escanear billetera

Abra Configuración › Terminal y toque Actualizar billeteras escaneadas. Una verificación exitosa sin billeteras POS elegibles deja el botón oculto. Consulta la tienda asignada, la moneda actual y Roles de la clave API. Tap to Pay y preautorizaciones no ofrecen esta acción.

El descubrimiento de billetera informa un error

El error solo aparece en Configuración y no bloquea los pagos con tarjeta. Corrija allí la credencial, el entorno o el acceso de lectura y actualice. Una falla temporal conserva las últimas billeteras verificadas.

El código no es válido o no llega ningún código

Use el código de pago del comprador, no un QR de perfil, transferencia o recibo, y elija la billetera correcta. Un escaneo del terminal termina a los 30 segundos: toque Escanear de nuevo o Usar cámara.

Se rechaza el guardado o no se crea ningún token

Un pago aprobado sigue aprobado sin token guardado. Tras un rechazo, desactive Guardar tarjeta y vuelva a escanear si corresponde. Para Resultado desconocido, compruebe la transacción original.

Consulte el procedimiento de pago con billetera.

Volver al contenido

El emparejamiento o la configuración fallan

Comience con el mensaje en Inicio, luego abra Configuración › Terminal y completar la final Probar conexión paso. Esto verifica el acceso a API y las comprobaciones de conexión admitidas por su integración. Uso de configuración de red y nube Encuentra terminal para configurar para probar el acceso API y listar terminales; Prueba API se ofrece para terminales en el dispositivo y Tap to Pay. Para conocer los pasos completos, consulte Conéctate a Adyen.

Para cualquier integración, abra Configuración › Ayuda y solución de problemas › Detalles de solución de problemas. Los resultados incluyen brechas de configuración, acceso a API, comprobaciones de conexión admitidas, marcas de tiempo y detalles del dispositivo; Se identifican los controles no respaldados. Estos controles no prueban que los pagos, reembolsos o impresiones se realizarán correctamente y no aceptan pagos, registran teléfonos ni cambian claves. Use Compartir informe con datos sensibles ocultos para compartir los detalles mostrados: los ID de comerciante, terminal, instalación y credencial permanecen; Se excluyen los secretos, los mensajes no estructurados y los datos del comprador.

Inicio dice "Los pagos aún no están configurados"

ArreglarToque Terminar de configurar los pagos. en Configuración › Terminal, ingrese lo que falta o ingrese la clave nuevamente, luego toque Probar conexión.

causa

Un campo obligatorio está vacío, no se pudo leer una clave guardada en este dispositivo o no se pasó ninguna prueba de conexión desde que cambió la configuración. Hasta entonces, pagos, reembolsos, impresiones y otras acciones de Adyen explican esto en lugar de ejecutarse.

La prueba API falla o la configuración informa un problema de acceso

ArreglarVerifique las funciones y el acceso de la credencial con la requisitos de credenciales. Para LIVE, verifique el Prefijo de URL LIVE.

causa

La clave API, la cuenta de comerciante o el prefijo de URL LIVE son incorrectos, falta una función o la credencial proviene de otra cuenta o entorno de la empresa.

"La cuenta del comerciante no coincide con la asignación actual de esta terminal".

ArreglarIngrese la cuenta de comerciante a la que está asignado el terminal o reasigne el terminal en el Área de Clientes.

causa

El terminal está asignado a una cuenta comercial diferente en Adyen.

Falla la prueba de conexión en un terminal Adyen o terminal de red

ArreglarCompare el identificador, la frase de contraseña y la versión de la clave compartida con el Área de Clientes. Para un terminal de red, verifique la dirección IP y POIID en la pantalla de información del dispositivo del terminal.

causa

La clave compartida no coincide, o la dirección IP o ID de terminal (POIID) está desactualizado.

La conexión es rechazada debido al entorno.

ArreglarPara un terminal de red/nube o Tap to Pay, consulte Entorno en Configuración › Terminal. En un terminal Adyen, utilice un dispositivo del entorno adecuado.

causa

TEST y LIVE son mixtos: el terminal, la cuenta y la clave API deben ser de un mismo entorno.

No se puede acceder a un terminal en la nube

ArreglarVerifique que el terminal esté encendido y en línea, luego verifique el POIID y las funciones de la credencial.

causa

El terminal está fuera de línea, el POIID está incorrecto o a la clave API le falta el Cloud Device API role.

Falta la aplicación Adyen Payments seleccionada

Arreglarcomprobar Configuración › Terminal › Entorno e instale la aplicación correspondiente desde Google Play. Ambas aplicaciones pueden permanecer instaladas. Finalice el registro e ingrese la clave compartida correspondiente; confirmar con un pago TEST.

causa

La aplicación Adyen Payments para el entorno TEST o LIVE seleccionado no está instalada.

Tap to Pay devuelve UnavailableService antes de la presentación de la tarjeta

La aplicación Adyen Payments no pudo completar la solicitud. Este error genérico no prueba una interrupción de Adyen o la falta de una clave de cliente.

correr Probar conexión en Configuración › Terminal. Para obtener una tabla compacta de verificaciones y un informe redactado, expanda Configuración › Ayuda y solución de problemas › Detalles de solución de problemas.

Configurar Tap to Pay aprovisiona automáticamente la credencial de registro y la clave de cliente utilizando su clave API principal. Comprueba su roles requeridos si se deniega el aprovisionamiento. Espere unos minutos para que se propaguen las nuevas claves y luego ejecute Probar conexión otra vez. Si la recuperación aún falla, vuelva a intentarlo más tarde o solicite al soporte de Adyen que inspeccione la coincidencia. TEST Área de Clientes o LIVE Área de Clientes. Ver el Requisitos de la aplicación Adyen Payments.

La clave de cliente debe pertenecer a la misma credencial utilizada para el registro.

Al pedir ayuda, use Compartir informe con datos sensibles ocultos.

"La nueva clave está guardada. Actualice la configuración de este terminal"

ArreglarEn la terminal, abra Menú de administración › Configuración › Actualizar, luego regrese a Mini mPOS y toque Comprobar de nuevo. Si se interrumpió la creación, toque Reanudar configuración de la clave; no crea una segunda clave. Ver creación de claves y el Guía de actualización de configuración de Adyen.

causa

La clave de cifrado se creó en Adyen, pero el terminal aún no la ha cargado.

Las acciones sobre un pago anterior están bloqueadas

ArreglarRestaure la configuración que aceptó el pago o manéjelo en el Área de Clientes. No lo procese bajo otra cuenta.

causa

La cuenta comercial, el entorno o la terminal cambiaron después de ese pago.

Volver al contenido

Se cae la conexión o el terminal no contesta

importante

Si un pago estaba en curso cuando se cortó la conexión, comprobar su resultado antes de volver a cargar.

“El terminal no respondió”, o un terminal de red funciona sólo a veces

Arreglar

  1. Verifique la dirección IP del terminal en la pantalla Información del dispositivo y actualícela en Configuración › Terminal.
  2. Conecte el dispositivo y el terminal a la misma red. Evite el invitado Wi-Fi, que a menudo aísla los dispositivos.
  3. Solicite al administrador de red que permita TCP 8443 entre ellos y reserve la dirección IP del terminal; ver requisitos de red.
causa

La dirección IP del terminal cambió, el dispositivo se movió a otra red o la red bloquea la conexión.

Los pagos o las pruebas API fallan en cada configuración

ArreglarVerifique la conexión a Internet, luego asegúrese de que HTTPS en TCP 443 para los dominios de Adyen esté permitido.

causa

El dispositivo o terminal no tiene acceso a Internet o un firewall bloquea Adyen.

Tiempo de espera para pagos en la nube

ArreglarVerifique el Wi-Fi, Ethernet o datos móviles del terminal, luego ejecute Probar conexión.

causa

El terminal perdió su conexión a Internet.

Volver al contenido

Una captura o ajuste falló o se desconoce

Abra la entrada original en Historial y lee su razón. Si falta la configuración de Checkout API, complétela; Si la cuenta o el entorno cambiaron, restaure el original.

Error de captura o Resultado de captura desconocido

ArreglarToque Reintentar captura. Reenvía la misma captura de forma segura; no cree un nuevo pago.

Un ajuste de monto no está resuelto

ArreglarVuelva a intentarlo con la misma importe. Un monto diferente es una solicitud separada y puede bloquearse hasta que se resuelva la primera.

Un propina no fue guardado

ArreglarIngresa una propina más pequeña o toca Sin propina.

causa

El emisor de la tarjeta se negó a aumentar la retención por una propina superior al 20%.

Captura solicitada o Reembolso solicitado no cambia

ArreglarComprueba el resultado final en el Área de Clientes.

causa

Esto significa que Adyen aceptó la solicitud. Mini mPOS no tiene servidor, por lo que nunca recibe la confirmación final.

Las retenciones caducan, así que resuélvelas lo antes posible. Para conocer los pasos normales, consulte depósitos y propinas sobre el recibo.

Volver al contenido

La impresora o los recibos por correo electrónico no funcionan.

No se imprime nada o Imprimir recibo falta

Arreglar

  1. en Configuración › Acerca de, comprobar que Impresora muestra Disponible. Si no, corre Probar conexión en Configuración › Terminal.
  2. en Configuración › Recibos, establecer Impresora a Detectar automáticamente y comprobar Imprimir automáticamente.
  3. Toque Imprimir recibo de prueba. Si no se imprime nada, revise el rollo de papel del terminal.
causa

El terminal no tiene impresora, no se detectó la impresora o la conexión no funciona. Los terminales AMS1 y teléfonos Tap to Pay no tienen impresora.

El diseño está cortado o mal ajustado.

ArreglarCambiar Caracteres por línea en Configuración › Recibos e imprimir un recibo de prueba.

El correo electrónico de prueba falla

Arreglaren Configuración › Recibos por correo, comprobar el servidor, puerto, STARTTLS o SSL/TLS, nombre de usuario y contraseña. Su proveedor puede requerir que el acceso SMTP esté activado o una contraseña de la aplicación; ver configuración de correo electrónico.

causa

Servidor, puerto, seguridad o contraseña incorrectos, o el proveedor bloquea SMTP o el inicio de sesión con contraseña.

Los correos electrónicos de prueba funcionan, pero los clientes no reciben recibo

Arreglaren Configuración › Recibos por correo, compruebe cuándo se solicita el correo electrónico y si los recibos se envían automáticamente.

El logotipo no se imprimió

Revisa la vista previa en Configuración › Recibos e imprime un recibo de prueba. Si el terminal rechaza el logotipo, Mini mPOS puede imprimir el texto y muestra un aviso en el primer rechazo. Los problemas de papel, la falta de impresora o una solicitud de impresión sin respuesta detienen la impresión. Consulta los ajustes del logotipo para probar una imagen más sencilla o quitarlo.

Volver al contenido

PIN y problemas de transferencia de configuración

El personal se olvidó del Gerente PIN

ArreglarUn administrador puede reemplazarlo o eliminarlo en Configuración › Seguridad. El PIN de administrador y el PIN de gerente protegen diferentes acciones; uno no desbloquea el otro.

El PIN de administrador esta olvidado

causaNo hay recuperación de PIN.

Para empezar de nuevo sin el PIN de administrador, siga recuperación de almacenamiento. Lea la advertencia de pérdida de datos antes de reiniciar.

El código de transferencia se rechaza o faltan claves después de la importación

ArreglarUtilice el código que se muestra con estos códigos QR, no uno recién generado. Cada transferencia necesita su código. Un código incorrecto o en blanco no importa nada. Después de copiar, verifique el destino y las credenciales en el nuevo dispositivo; ver más dispositivos.

causa

El código no pertenece a estos códigos QR o se dejó en blanco.

Para revisar qué acciones protege cada PIN, consulte personal PINs.

Volver al contenido

Las configuraciones o credenciales guardadas no se pueden leer ni escribir

Mini mPOS se detiene en lugar de reemplazar configuraciones o credenciales ilegibles. Esto preserva los archivos, incluidos los registros de configuración o recuperación de pagos sin terminar.

Advertencia

Al borrar el almacenamiento o desinstalar se eliminan todos los productos locales, configuraciones, credenciales, PIN, historial y registros de recuperación de operaciones no finalizadas. Una transferencia de configuración no puede restaurar el historial ni esos registros de recuperación. Restablecer no deshace pagos, reembolsos o capturas ya enviadas a Adyen.

  1. Reinicie el dispositivo y abra Mini mPOS nuevamente. Si el almacenamiento del dispositivo está lleno, primero libere espacio fuera de Mini mPOS. Borrar solo el caché de la aplicación no restablece la configuración guardada.
  2. Antes de resetear, mantén los registros que necesites y resuelve pagos, reembolsos, capturas y ajustes pendientes. Si la aplicación no se puede abrir, verifique sus resultados en el Área de Clientes; ver resultados desconocidos. Si un resultado aún es incierto, conserve los datos de la aplicación y concilie primero con Adyen. No vuelvas a enviar la operación solo porque la aplicación no se puede abrir.
  3. Si el error persiste y acepta perder todos los datos locales, reinicie Mini mPOS. En un teléfono o tableta, abra Android Configuración › Aplicaciones › Mini mPOS › Almacenamiento y caché › Borrar almacenamiento (las etiquetas varían según el dispositivo), o desinstale Mini mPOS y reinstálelo desde el último lanzamiento. En un terminal Adyen, haga que la persona que administra las aplicaciones de su terminal organice el reinicio o la eliminación y reinstalación; ver el Guía de implementación de la aplicación Adyen.
  4. Configure Mini mPOS nuevamente o importe una transferencia de configuración confiable y luego complete Probar conexión antes de realizar pagos reales. Ver Conéctate a Adyen.

La instalación de una actualización sobre la aplicación existente no restablece su almacenamiento. Si el error regresa, informar un problema de aplicación en GitHub; no adjunte archivos de configuración ni credenciales guardados.

Volver al contenido

La aplicación no se instala en un terminal.

INSTALL_PARSE_FAILED_NO_CERTIFICATES

ArreglarSube el firmado minimpos-<version>.apk desde el último lanzamiento.

causa

El APK no está firmado.

INVALID_SIGNING_CERTIFICATE_MISMATCH

ArreglarConserve la fuente de firma original. Si necesita cambiarlo, consulte con el soporte de Adyen sobre cómo eliminar versiones anteriores.

causa

El APK está firmado con una clave diferente a la de cargas anteriores.

La versión Android no es compatible

ArreglarUtilice un terminal compatible; ver instalación .

causa

Mini mPOS necesita Android 9 o posterior; el S1E más antiguo ejecuta Android 7.1.

Volver al contenido

Un mensaje de error nombra un problema

Cada mensaje nombra el problema y lo que se debe verificar. Los detalles entre paréntesis, como una dirección IP, un estado HTTP o las propias palabras de Adyen, ayudan al soporte de Adyen: inclúyalos cuando solicite ayuda. Si un pago estaba en curso, comprobar su resultado antes de arreglar cualquier otra cosa.

Mensajes de error
"No se pudo acceder al terminal. Verifique que esté encendido, en la misma red y en esta dirección IP".

ArreglarSeguir abandonos de la red.

causa

Mini mPOS no pudo abrir una conexión al terminal de red en la dirección IP guardada.

"Esta dirección no es un terminal Adyen del entorno seleccionado. Verifique la dirección IP y TEST o LIVE".

ArreglarVerifique la dirección IP en la pantalla de información del dispositivo del terminal y Entorno en Configuración › Terminal.

causa

Algo respondió en esa dirección, pero no un terminal Adyen del entorno seleccionado: la dirección ahora pertenece a otro dispositivo, o se mezclan TEST y LIVE.

"El terminal rechazó la clave compartida. Verifique el identificador de la clave, la versión y la frase de contraseña en la configuración del Terminal".

ArreglarCompárelos con el Área de Clientes, o configurar la clave de nuevo.

causa

El identificador, versión o frase de contraseña de la clave compartida difiere de la del terminal.

"No se pudo verificar la respuesta del terminal. Verifique la clave compartida en la configuración del terminal".

ArreglarComprueba el resultado antes de volver a cargar, luego arregle la clave compartida.

causa

El terminal respondió con una clave compartida diferente, por lo que es posible que le haya llegado la solicitud.

"El terminal no está conectado a Adyen. Verifique que esté encendido y en línea".

ArreglarVerifique el Wi-Fi, Ethernet o datos móviles del terminal, luego ejecute Probar conexión.

causa

El terminal en la nube está apagado o no tiene conexión a Internet.

"Adyen no aceptó la clave API. Verifíquela en la configuración del Terminal".

ArreglarIngrese la clave nuevamente y verifíquela con la requisitos de credenciales.

causa

La clave API es incorrecta, revocada o del otro entorno.

"La clave API carece de función o acceso a esta cuenta de comerciante. Verifique la credencial API en su Área de Clientes".

ArreglarAgregue el rol o acceso a la cuenta en Área de Clientes; ver el requisitos de credenciales.

causa

La credencial carece de función o acceso a esta cuenta de comerciante. Los corchetes nombran el rol que falta cuando se conoce.

"Adyen está ocupado o no está disponible temporalmente".

ArreglarEspere un momento y vuelva a intentarlo. Para un pago, captura o enlace de pago, comprobar su resultado primero.

causa

Adyen está limitando las solicitudes o no está disponible brevemente.

"No llegó ninguna respuesta a tiempo".

ArreglarComprueba el resultado. No vuelvas a cargar hasta que lo sepas.

causa

La solicitud fue enviada, pero no llegó respuesta, por lo que se desconoce su resultado.

“El resultado de Payments sigue siendo desconocido. Actualiza la aplicación Payments seleccionada, confirma el acceso a las consultas con Adyen y revisa el Área de Clientes antes de volver a cobrar.”

ArreglarEncuentra el pago en el Área de Clientes antes de volver a cobrar.

causa

Recuperar el resultado de Tap to Pay.

"No se pudo abrir la aplicación Adyen Payments. Verifique que esté instalada".

ArreglarInstale la aplicación Adyen Payments para su entorno y vuelva a intentarlo. Ver Conéctate a Adyen.

causa

La aplicación Adyen Payments no está instalada o se eliminó.

"El servidor de correo no aceptó el nombre de usuario o la contraseña. Verifíquelos en Configuración > Recibos de correo electrónico".

ArreglarCorrígelos y luego envía un correo electrónico de prueba.

causa

El nombre de usuario o la contraseña de SMTP son incorrectos o el proveedor requiere una contraseña de la aplicación.

"El almacenamiento seguro de este dispositivo no funcionó. Inténtelo de nuevo o reinicie el dispositivo".

ArreglarSi continúa después de reiniciar, ingrese las claves y contraseñas nuevamente.

causa

El almacén de claves de Android no pudo cifrar ni leer un secreto guardado.

Volver al contenido

¿Aún necesitas ayuda?

Para cuentas de Adyen, implementación de terminales, métodos de pago o resultados de pago finales, comuníquese con Adyen. Para un problema de aplicación, abrir un problema de GitHub con la versión de la aplicación, modelo del dispositivo, configuración, entorno TEST o LIVE y los pasos a reproducir.

importante

Nunca incluya claves, contraseñas, PIN o datos de clientes. Informe las vulnerabilidades sospechosas de forma privada bajo el política de seguridad.

Volver al contenido