Herramientas para la integración de dispositivos de pago: UDemo

Los desarrolladores de aplicaciones de pago que necesiten acelerar la integración de los lectores de tarjetas de ID TECH en sus sistemas POS (u otros) pueden avanzar rápidamente aprovechando el Universal SDK de ID TECH. El SDK proporciona bibliotecas (y una API común) para gestionar todos los lectores de tarjetas de producción actual de ID TECH, incluidos los lectores de tarjetas chip (EMV), de banda magnética (MSR) y sin contacto, en varios lenguajes (como C# para Windows, Java para Android, Swift para iOS y C para Linux).

Sin embargo, no es necesario instalar el SDK para ejecutar el programa de demostración asociado, una aplicación independiente que llamamos Universal Demo o, abreviadamente, UDemo. Puede obtener UDemo (versión independiente para Windows) accediendo aquí.

Recomendamos que todos nuestros clientes desarrolladores se familiaricen con la aplicación UDemo, ya que ilustra detalladamente el aspecto de las solicitudes y respuestas en bruto (hacia y desde el dispositivo), permite configurar un dispositivo con ajustes específicos y ofrece un entorno de pruebas donde los desarrolladores pueden probar fácilmente diversos comandos con distintos valores de argumentos, en tiempo real. UDemo también es una excelente manera de aprender más sobre EMV.

Después de ejecutar el instalador de UDemo, inicie la aplicación. Verá una ventana similar a la siguiente:

Tenga en cuenta que puede conectar cualquier lector de tarjetas de ID TECH compatible al puerto USB de su ordenador en cualquier momento, y será detectado automáticamente por UDemo. Al reconocer el dispositivo, el árbol de comandos (consulte «COMMANDS», más arriba) se rellenará con comandos específicos del dispositivo en cuestión (mostrando, por ejemplo, un grupo «CTLS» si el dispositivo admite interacciones sin contacto, «EMV» si admite transacciones con tarjeta chip de contacto EMV, etc.).

La forma básica de uso es:

1. Conecte un dispositivo.
2. Navegue por el árbol de comandos hasta encontrar el comando que le interese.
3. Haga doble clic en el comando dentro del árbol, O haga clic una vez en el botón verde Ejecutar comando situado en la parte inferior de la ventana.
4. Consulte el panel Log para ver cuáles fueron las solicitudes y respuestas. (Los valores enviados al dispositivo se indican con «OUT», mientras que los valores recibidos del dispositivo se indican con «IN»).
5. Consulte el panel Resultados (a la derecha) para ver la explicación, en lenguaje claro, de lo sucedido.

En la captura de pantalla anterior, se ejecutó el comando Start EMV Transaction (con un lector de tarjetas ID TECH VP3300) utilizando el importe de transacción predeterminado de 1,00 $. El comando real ejecutado se muestra en la parte superior del Log. Se recibieron cuatro respuestas «IN» del dispositivo. La primera respuesta fue un ACK, y las dos siguientes respuestas «IN» contienen información de estado correspondiente a mensajes de LCD (como «Processing…») que podrían tener que mostrarse en un POS mientras se ejecuta la transacción. La cuarta y última respuesta IN contiene un bloque de datos TLV (tag-length-value) devuelto por el lector. Algunas de las interpretaciones de los TLV se muestran en el panel Result.

Consejos sobre UDemo

UDemo es una herramienta altamente interactiva que se aprende mejor usándola. Para avanzar más rápido en la curva de aprendizaje, conviene tener en cuenta lo siguiente:

1. Muchos comandos aceptan valores como argumentos o pueden configurarse de alguna forma antes de ejecutarlos. Basta con hacer un clic en un comando de la lista Commands. Si el comando en cuestión admite valores adicionales, aparecerán automáticamente los campos de formulario correspondientes justo encima del panel Log. Proporcione los valores necesarios y, a continuación, haga doble clic en el comando para ejecutarlo con esos valores.
2. El teclado virtual de la parte superior derecha se activa cuando la tarjeta insertada en el lector requiere la introducción de un PIN como uno de sus métodos de verificación del titular.
3. Justo encima del listado de comandos hay un botón llamado Descifrado. Haga clic en este botón para abrir un cuadro de diálogo que le permitirá descifrar los datos de la transacción.
4. Debajo del panel Log encontrará un botón Iniciar captura en disco (junto con un botón Borrar registros y Enviar registros por correo al soporte). El botón Start Capture resulta útil cuando desea capturar los datos de una sesión para analizarlos posteriormente. Incluso puede enviarnos los resultados por correo electrónico (con el botón Email Logs) si decide abrir un caso de soporte técnico.

Antes de ejecutar una transacción EMV

Por supuesto, UDemo es solo una herramienta de pruebas y no permite realizar cargos reales sobre una tarjeta de crédito, pero sí simula las tres fases (Start, Authenticate y Completion) de una sesión EMV de contacto. Sin embargo, antes de poder ejecutar comandos de transacción, el lector de tarjetas deberá haber pasado al menos por algunas configuraciones. (De lo contrario, la simulación fallará).

Puede configurar un dispositivo rápidamente (con valores predeterminados razonables) ejecutando tres comandos:

1. En primer lugar, en el nodo AID del árbol de comandos, busque Load Default AID y ejecútelo. En realidad se trata de una operación por lotes que cargará media docena de AID habituales en el dispositivo. Espere unos diez segundos.
2. A continuación, en el nodo CAPK del árbol de comandos, busque el comando Load Default CAPK y ejecútelo. De nuevo, es un comando por lotes que tardará unos segundos. Carga claves públicas de varias marcas de tarjetas, que se utilizarán para validar los elementos criptográficos generados por la tarjeta chip en el momento de la transacción. (PRECAUCIÓN: Las claves son solo para pruebas y no están destinadas a usarse en producción. Obtenga las claves de producción a través de su pasarela o procesador de pagos).
3. Por último, en el nodo Terminal Config del árbol de comandos, localice y ejecute Save Terminal Data. Esto cargará en el lector unos TLV predeterminados razonables para admitir distintas funcionalidades del terminal.

Una vez ejecutados estos comandos, el lector de tarjetas contendrá los datos predeterminados adecuados, y comandos como Start Transaction deberían funcionar sin errores.

Más información

Evidentemente, en la aplicación UDemo ocurren muchas cosas; demasiadas como para describirlas aquí. ¿Cuál es la mejor manera de obtener más información? Mire la esquina inferior izquierda de la pantalla de UDemo (consulte la imagen anterior) y localice el botón rosa Documentación . Si haces clic en ese botón, se abrirá un PDF en Acrobat Reader (suponiendo que lo tengas instalado en tu equipo) con la Guía de Inicio Rápido de UDemo.

Para comprender el significado de todos los bytes hexadecimales que aparecen en UDemo, lo más probable es que necesites consultar la guía de la API de bajo nivel (firmware) correspondiente a tu lector. Normalmente puedes obtenerla directamente desde la sección de Descargas de nuestra Base de Conocimiento pública (no requiere registro), aunque algunos documentos solo están disponibles bajo petición. En tal caso, puedes ponerte en contacto con tu representante de ID TECH y se te facilitarán los documentos correspondientes sin coste alguno.

¿Tienes preguntas sobre el Universal SDK o cualquiera de los productos de ID TECH? Ponte en contacto con nuestros expertos en 1-800-984-1010!