Tarjeta Presente
SDKs Nativos
15min
el módulo permite la conexión automática de dispositivos mobile pos con smartphones android e ios, para realizar pagos con tarjeta presente a) permisos de acceso es necesario solicitar los siguientes permisos en el smartphone de manera previa dispositivos android por un lado, será necesario agregar los siguientes permisos en androidmanifest xml bluetooth bluetooth admin access coarse location access fine location internet y será necesario solicitar al usuario permisos de access coarse location access fine location dispositivos ios por un lado, será necesario agregar los siguientes permisos y descripciones en info plist nsbluetoothalwaysusagedescription nsbluetoothperipheralusagedescription nslocationalwaysandwheninuseusagedescription nslocationalwaysusagedescription nslocationwheninuseusagedescription nsmicrophoneusagedescription y será necesario solicitar al usuario permisos de location always location when in use b) versión de so es necesario contar la siguiente versión de so dependiendo de la plataforma dispositivos android versión 6 o superior dispositivos ios versión ios 10 o superior c) bluetooth el bluetooth en el caso de smartphones android, si no lo estaba, se encenderá automáticamente con la ejecución del método init() por el contrario, el smartphones ios, deberá encederse manualmente por el usuario d) gps en el caso de smartphones con android versión 10 o superior, es necesario que el gps esté encendido esta acción deberá hacerse manualmente por el usuario métodos y eventos métodos la siguiente tabla indica los distintos métodos que el módulo de lectura de tarjetas con mobile pos posee métodos descripción retorna start() inicializa la búsqueda de dispositivos mobile pos por bluetooth, y si encuentra uno, se conecta automáticamente si encuentra más de uno, se conecta con el primero de ellos (por ahora) emite un evento de tipo connection con un status inicial de searching en el caso de ejecutar este método y el dispositivo se encuentra ya conectado con algún lector, ejecutará un evento de tipo connection con status found void isconnected() método asíncrono, que devuelve si se encuentra un dispositivo conectado o no boolean read() inicializa la lectura de la tarjeta emite un evento de tipo card con un status inicial de reading void disconnect() desconecta automáticamente el dispositivo mobile pos y realiza la liberación de la instancia del controlador existente void getdeviceinfo() info del lector conectado te suscribis a un listener y te devulve estos datos connected(boolean), battery(number), charging(boolean), serialnumber(string)void eventos al interactuar con el dispositivo, las respuestas son devueltas a través de la emisión de eventos, los cuales pueden ser connection el evento connection se utiliza para indicar los cambios en el estado de la conexión con el dispositivo mobile pos, ya sea que se haya comenzado la búsqueda del dispositivo, se realizó la conexión, se desconectó o se produjo un error este evento retorna un objeto event que tiene las siguientes propiedades nombre descripción valores posibles tipo status indica el estado actual de la conexión entre mobile pos y el smartphone searching found disconnected error string success indica el resultado de la búsqueda e intento de conexión en caso de encontrar un dispositivo boolean message mensaje informativo sobre el evento emitido string valores posibles de status en el evento connection valor descripción searching indica que se encuentra en la búsqueda de un dispositivo mobile pos found indica que finalizó la búsqueda y/o conexión con el dispositivo, ya sea que haya finalizado con éxito o no esto último se indica en la propiedad success del objeto event disconnected indica que el dispositivo se desconectó error indica que se produjo un error al procesar alguna solicitud, como por ejemplo, querer obtener la información del dispositivo mientras el mismo está ocupado card el evento card se utiliza para indicar cuando el dispositivo está listo para leer la tarjeta o para cuando ha finalizado de leerla, ya sea que la lectura haya sido exitosa o errónea este evento retorna un objeto eventque tiene las siguientes propiedades nombre descripción valores posibles tipo status indica el estado actual de la lectura de tarjeta reading read string success resultado de la lectura boolean message mensaje informativo sobre el evento emitido string error tipo de error en caso de producirse no card bad swipe mag head fail string type tipo de lectura de tarjeta magstripe emv string data los datos de la tarjeta en caso de una lectura exitosa string valores posibles de status en el evento card valor descripción reading indica que el dispositivo está listo y a la espera para realizar la lectura de la tarjeta read indica que la lectura de la tarjeta ha finalizado, ya sea porque se leyó o porque se agotó el tiempo de espera esto último se indica en la propiedad success del objeto event valores posibles de error en el evento card valor descripción no card el tiempo de lectura se agotó y no se detectó ninguna tarjeta bad swipe hubo un error al deslizar la tarjeta y no se pudo leer correctamente mag head fail se produjo un error al leer la banda magnética de la tarjeta valores posibles de type en el evento card valor descripción magstripe indica que el tipo de lectura fue por banda magnética emv indica que el tipo de lectura fue por chip info el evento info se utiliza para retornar información del dispositivo este evento retorna un objeto event que tiene las siguientes propiedades nombre descripción tipo message mensaje informativo sobre el evento emitido string data objeto que contiene la información obtenida del dispositivo object el objeto data del evento info contiene las siguientes propiedades nombre descripción tipo battery indica el porcentaje de batería actual del dispositivo int serialnumber número de serie del dispositivo string charging indica si el dispositivo se encuentra cargando o no boolean