FAQ - SDK¶

¿Dónde puedo encontrar la documentación de PayStore?

La documentación de Paystore (API, SDK) debe accederse a través del Portal Paystore, solo ingresar con sus credenciales de desarrollador.

¿Cuál es el Ambiente de desarrollo (IDE) utilizado por PlayStore?

Recomendamos utilizar el Eclipse, las versiones actualmente aprobadas son: Marks, Neon e Oxygen.

¿Cuál es la URL para instalar el plugin en Eclipse?

http://177.69.97.18:3434

¿Puedo utilizar la misma configuración de un terminal en otro?

No. Cada terminal necesita de un número único y previamente registrado. De lo contrario, se mostrará el mensaje "Sequencial no válido".

¿Para que es el archivo PP.DAT?

Este archivo contiene información de lectura de una tarjeta con chip y magnética. Se usa para simular la lectura de tarjetas en el Emulador.

Por patrón, las informaciones dentro del archivo están comentadas. Caso necesario, vaya a "Run Configuration" en su Eclipse, con el plugin instalado, y, en su ajustes (PhScript POS VM),elija la opción deseada en “Card Emulator”.

image alt text

Ese archivo foe creado para evitar la necesidad de utilizar un PinPad en el emulador.

El emulador también acepta pegar el número de tarjeta (CTRL-V) en lugar de teclear los números.

No puedo realizar transacciones ni inicializar la terminal. ¿Que puede ser?

Verifique la configuración de comunicación de la terminal conforme abajo:

INCLUYE TEXTO CON LA SECUENCIA DE MENÚS Y PARÁMETROS.

¿Para instalar la aplicación en un terminal físico, necesito de una Tarjeta SD?

No. Las terminales convencionales no son compatibles con la tarjeta SD.

Si la carga está en su máquina, use un cable USB o serial, dependiendo del modelo de la terminal.

Las terminales Verifone soportan carga de memorias USB.

Las terminales PAX no soportan carga de memorias USB.

La terminal exhibe "Número de serie no válido". ¿Que puede ser?

Probablemente falte el registro de este terminal en la PayStore. Solicita que tu terminal sea registrado.

Si el problema persistir, comuníquese con el Soporte.

¿Por qué ocurre el error "Bad request"?

Comuníquese con el Soporte con la fecha, hora y serie del equipo para que podamos investigar la causa de este problema.

¿Hay alguna forma de actualizar la aplicación que no sea a través de USB?

Sí. A través del sistema de carga remota, denominado PhDM, es posible realizar cargas en la terminal de forma remota.

Si necesita instalar una aplicación, colóquela en la tienda de aplicaciones para descargarla en la terminal, sin tener que cargarla localmente o realizar una actualización remota en la terminal.

Es posible realizar la primera carga vía del sistema de telecarga. (**PhDM**)?

No. La primera carga debe realizarse mediante carga local, a través de uno USB o Serie.

¿Qué aplicación debo cargar inicialmente en la terminal?

Usted recibirá un paquete que contiene las siguientes aplicaciones:

PhVM: Máquina virtual responsable por ejecutar/interpretar todas las demás aplicaciones escritas en Script.
PhAST: Aplicación principal.
App Tef: Aplicación financiera.
App PayStore: Aplicación encargada de comunicarse con la tienda de aplicaciones.
Apps de los adquirentes: Hay un conjunto de aplicaciones específicas para cada adquirente aprobadas en Play Store.

Esto paquete de aplicación es puesto a disposición por nuestro equipo de soporte.

¿Cómo cargo la aplicación en la terminal?

Vea el documento "\Guias\Processo de carga" en GitLab a través del enlace: https://gitlab.com/phoebus/phscript-sdk/blob/master/SDK/Guias/Processo%20de%20carga/ProcessoCarga.md

¿Dónde puedo conseguir los drivers windows para cargar vía USB en las terminales?

Comuníquese con el fabricante o proveedor de su terminal para solicitar los drivers.

¿Puedo realizar una venta ingresando el número de mi tarjeta de crédito o débito?

Eso depende. El adquirente debe permitir las transacciones ingresadas.

¿Por qué aparece el mensaje "Operación manual no permitida"?

Lo más probable es que haya intentado realizar una transacción de venta escrita y la adquirente no permite.

¿Cómo puedo simular la captura de una tarjeta en la terminal virtual (Emulador)?

Deberá utilizar el archivo PP.DAT, que contiene informaciones de lectura de una tarjeta magnética y con chip. Se usa este archivo para simular la lectura de tarjetas en el Emulador.

Por patrón, las informaciones dentro del archivo están comentadas. Caso necesario, vaya a "Run Configuration" en su Eclipse, con el plugin instalado, y, en su ajustes (PhScript POS VM),elija la opción deseada en “Card Emulator”.

Este archivo fue creado para evitar la necesidad de usar un PinPad en el Emulador.

El emulador también acepta pegar el número de tarjeta (CTRL-V) en lugar de teclear los números.

¿Es posible iniciar una aplicación específica tan pronto como se enciende la terminal?

Sí, es necesario sobrescribir la función outset().

Vea un ejemplo abajo:

/******************************************************************/

/* Funcíón llamada en main de la VM después de las llamadas principales en main de las applicaciones. Juntamente

con la presentation de la VM, junto con las demás aplicaciones en la VM, siguiendo el orden de inicialización
@return invalid, true o false

*/

extern function outset()

{

Haga la llamada de su aplicación aquí.

return true;

}

/******************************************************************/

¿Es posible configurar mi App para siempre exhibirse y tome el control de la terminal, de forma similar a uno **_launcher _**de Android?

Si, esto sería como un terminal Android en Modo Kiosk.

Es necesario implementar la función. "onIdleRefresh()" y “onIdle()”. De esta manera, si el usuario sale de la aplicación, se volverá a ejecutar poco después.

Vea un ejemplo de cómo implementar:

/******************************************************************/

/* Función llamada al final del primer draw de la pantalla de Idle, junto de las demás aplicaciones en la VM,

siguiendo el orden de inicialización

*/

extern function onIdle()

{

Haga la llamada de su aplicación aquí.

}

/******************************************************************/

/*Función llamada al final de cada refresh de la pantalla de Idle, junto de las demás aplicaciones en la VM,

siguiendo el orden de inicialización

*/

extern function onIdleRefresh()

{

Haga la llamada de su aplicación aquí.

}

/******************************************************************/

¿Cómo cargo una aplicación con mi terminal físico?

Después de terminar el desarrollo de la aplicación, haga clic en el botón Generate Package en Eclipse image alt text .

Se generará una carpeta \dist dentro de su proyecto con dos subcarpetas, una con la carga local y la otra para la distribución de su App para su publicación en PayStore.

Dentro de la carpeta \dist\Carga Local, se creará una carpeta con el modelo de su terminal.

¿Dónde debo colocar las imágenes de la aplicación y otras funciones?

El la carpeta \res del proyecto.

¿Cuáles son los formatos de imagen que soportan las aplicaciones?

Actualmente, solo BMP 24 bits.

¿Por qué mi imagen no se exhibe?

Comprueba de que su imagen se encuentre dentro de la carpeta \res del proyecto.

Comprueba si la imagen es de tipo BMP de 24bits.

Comprueba que el tamaño de la imagen no sea mayor que el tamaño del frame (tamaño de la pantalla de la terminal, por ejemplo, 240 x 320).

Comprueba si el nombre de referencia de la imagen en el archivo .jcss es correcta.

¿Es posible personalizar un componente visual, por ejemplo, un menú, una lista, una entrada, etc.?

Sí. Creando un proyecto de skin y personalícelo según sus necesidades.

A PayStore utiliza el concepto de skin. Es en este proyecto, usted puede cambiar colores, imágenes, fuentes, etc.

¿Es posible cambiar la fuente de un componente visual?

Sim. Creando un archivo .jcss en su proyecto y definir la fuente deseada.

Ver documentación para verificar cómo implementar.

¿Qué formato de color es soportado?

La representación del color es un número (base decimal).

Abajo, hay herramientas online que le permiten convertir la representación del color en formato hexadecimal(comúnmente usado en archivos .css)) al formato decimal usado en PayStore.

http://www.rinkydinkelectronics.com/calc_rgb565.php

http://www.binaryhexconverter.com/hex-to-decimal-converter

http://palettegenerator.com/

¿Dónde puedo encontrar las propiedades de un componente visual utilizado por la aplicación?

Además de la documentación, puede verificar el archivo llamado JCSS dentro de la carpeta \work. Este archivo es el patrón de layout.

¿Puedo cambiar el archivo JCSS?

No. Este archivo no se debe cambiar, ya que cada vez que se inicia la terminal, este archivo se sobrescribe.

Si desea cambiar las propiedades del archivo JCSS, es posible sobrescribir las propiedades de este archivo creando su propio archivo de layout .jcss en la carpeta \res de su proyecto. Consulte la documentación.

¿Por qué mi aplicación no se ejecuta en Terminal Emulator?

Probablemente, su carpeta work (la carpeta de salida de su terminal) esté corrupto.

Para solucionar el problema, es necesario hacer clic en el botón clean image alt text del plugin de Eclipse, para limpiar su carpeta. Después de eso, es necesario volver a configurar los datos de la terminal.

¿Cuando un terminal se actualiza mediante una telecarga, es necesario reinstalar las aplicaciones utilizadas o no se modifican?

Después de la telecarga, las aplicaciones siempre se guardan.

¿Cuando publico una App que desarrollé, Él estará disponiblepara todos las terminales de PayStore o solo para terminales de mi empresa??

Sus aplicaciones solo estará disponible para las terminales en su red. Estos niveles de visibilidad se pueden configurar en PayStore. Esta configuración se denomina filtros de publicación y puedem ser aplicadas por: Ciudad, Ramas de actividad, Grupo de Tenderos o Terminales específicos.

¿Puedo configurar el número de establecimiento de acuerdo con el ID de mi cliente?

Si, en PayStore, a través de la consola del adquirente, se puede definir el identificador del estabelecimiento en el registro de tenderos de una forma muy simples.

¿Cómo funciona la pantalla de idle?

La pantalla tiene una importancia fundamental en la arquitectura de la aplicación de terminal PayStore.

Es en esta pantalla donde la VM de la terminal comprueba si se ha insertado o pasado una tarjeta al terminal, y también, si hay algún evento para ser manejado. Por lo tanto, se deben desarrollar aplicaciones con el objetivo de reducir el retraso para volver a esta pantalla.

¿Es posible eliminar el botón "Salir" de las pantallas con menú de la terminal?

Sí. Para aprender cómo hacer esto, vea el script "sampleui_menu.wmls" del proyecto SampleUI.

¿Por qué la terminal muestra el mensaje "ERROR DE EJECUCIÓN ****3**", cuando ejecuto mi aplicación**

Por lo general, este mensaje de error se muestra cuando hay un error al pasar parámetros en una llamada de función.

Compruebe la definicion de la función en la documentación para ver el número y el tipo de los parámetros... Si el problema persiste, comuníquese con el soporte.

¿Cuál es el significado de cada código que viene después del mensaje ERROR DE EJECUCIÓN?

Código	Descripción
1	Ocurre cuando las llamadas remotas pasan URLs o funciones que no existen.
2	Uso interno del PhVM.
3	Ocurre cuando el número de parámetros no coincide con el número de argumentos.
4	Ocurre cuando la función no existe o es llamada externamente por otro script y la función no tiene el modificador "extern".
5	Ocurre cuando PhVM no ha encontrado el script compilado. Generalmente, hay un error en la importación de la URL.

Para ver todos los posibles códigos de error, consulte la sección "Exceções" en la documentación.

**¿Puedo hacer solicitudes HTTP? **

Sí. En el plugin, al crear un nuevo proyecto, usted encontrará un ejemplo utilizando el componente http.

Me gustaría que las transacciones financieras se realicen siempre desde mi App. Entonces, ¿es posible eliminar las opciones patrón de crédito y débito del menú en la pantalla iddle?

Sí. El servicio de integración "tef.enable" permite habilitar o deshabilitar las transacciones financieras de la terminal.

¿Puedo cambiar el orden en que se captura la información, por ejemplo, capturando el valor antes de deslizar la tarjeta?

Sí, solo capture la cantidad antes de llamar a la API de pago.

¿Puedo cambiar el logotipo de mi recibo?

Sí, en su proyecto de skin, reemplace la imagen PRINT.bmp con el logotipo que desea. Esta imagen debe ser monocromática (1 bit / blanco y negro).

¿Puedo cambiar la posición de los componentes visuales en la pantalla?

Sí. En su proyecto de skin,carpeta res, hay un archivo JCSS, busque el componente que desea cambiar y cambie sus propiedades como desee.

¿Cómo cargar una aplicación en la tienda de aplicaciones PayStore?

Después de finalizar el desarrollo de la aplicación, haga clic en el botón "Generate Package" en Eclipse image alt text .

Se generará una carpeta \dist dentro de su proyecto con dos subcarpetas, una con la carga local y la otra para la distribución de su App para publicación en PayStore.

Dentro de la carpeta \dist\PayStore estarán el paquete “PH” que debe publicarse en la Tienda de Aplicaciones.

Después de eso debes:

Acceda a la tienda de aplicaciones con tu usuario desarrollador;
Menú de aplicaciones -> pestaña "Borrador";
Agregar su respectiva Aplicación;
Espere a que el adquirente de la red apruebe su aplicación.

No consigo ejecutar los ejemplos http. ¿Como puedo resolver esto?

Para ejecutar los ejemplos http, debe utilizar un servidor rest y configurar los ejemplos de acuerdo con la IP y el puerto de ese servidor. Para esto, puede usar json-server. Para obtener más información, busque en Google "json-server".

Como pongo un **_frame _**para cerrar automáticamente después de x segundos?

Solo agregue un componente de temporizador del paquete Timer "package://phui#components/timer.wmlsc". Para obtener más informaciones, consulte la documentación.

¿Cómo veo la versión del SO (sistema operativo) de mi terminal PAX?

Al encender su terminal, qcuando aparezca la pantalla de SELF-TEST, seleccione la opcíon 2. Na tela de Main Menu, seleccione la opción 4. En la primera pantalla, se exhibiran un QRCODE. Vaya a la segunda pantalla para ver la versión del SO.

Ejemplo de un SO PAX:

OS:ProlinV2.4.85.5396R

TermAssist PAX no puede conectarse al terminal y exhibe "Running error". ¿Que puede ser?

A veces es necesario ejecutar el TermAssist como administrador. Si sigue apareciendo un error, cambie su compatibilidad a Windows 7 e intente nuevamente.

Parece que la instalación de la aplicación por TermAssist entró en looping. Sigue instalando la APP en la terminal y no termina. ¿Que puede ser?

Esto ocurre cuando existe un problema con TermAssist. Cierre TermAssist e intente ejecutarlo nuevamente.

¿Cómo veo la versión del plugin?

Acceda a Eclipse, en el menú "Ayuda", opcíon “Install New Software”, en la ventana que se muestra, haga clic en el enlace “already installed”.

¿Cómo puedo agregar información adicional al terminal, como, por ejemplo, el "ID de mis clientes"?

Para agregar información al terminal, acceda al portal PayStore, en el menú "Configuración", seleccione la opción "Campos adicionales".

¿Cómo capturar información de un campo adicional?

Debes usar el componente con la declaración:

use url PSCfg "package://paystore#config/config.wmlsc"

y leer el campo de esta manera:

PSCfg#getProperty("nombre del campo");

Para más informaciones, consulte la documentación.

¿Cómo puedo formatear un valor monetario?

Para formatear un valor, inicialmente debe declarar el módulo en su script, de la siguiente manera:

use url StringFormat "package://libs#ui/str_format.wmlsc";

Y usa la función "getMoneyAsStringCurrency".

Ejemplo:

StringFormat#getMoneyAsStringCurrency("1500", "R$", 2, ",", ".");

Para más informaciones, consulte la documentación.

¿Es posible cambiar o agregar información en el recibo?

Eso depende del adquirente. Algunos adquirentes envían el recibo ya formateado para que se imprima en la terminal. Para otros adquirentes, es posible crear el recibo en el servidor TEF, posicionando y formateando la información como se desea.

El PayStore también soporta a impresión del recibos gráficos. En este caso, la terminal POS utiliza las informaciones enviadas por el adquirente o Servidor TEF, para formatear los recibos mediante un layout gráfico. En el layout gráfico, el desarrolador tiene total libertad para construir el recibo.

En cualquier caso, el cambio en los recibos o el uso del recibo gráfico debe ser enviado para su validación por parte del adquirente, ya que la caracterización errónea del recibo (modelo) puede verse como un posible problema para acciones futuras, como la dificultad para identificar transacciones en los call center, posible bloqueo de las marcas de las tarjetas en respecto a los datos informados en el recibo, etc.

¿Cómo puedo capturar en mi transacción el nombre del cliente de la tarjeta?

A través de la propiedad "card.holder" de la estructura de respuesta de pago.