Realiza operaciones directamente con una terminal desde tu aplicación punto de venta móvil en Android.Agrega el SDK a tu proyecto#
Agrega el SDK en el archivo build.gradle de tu proyecto.Agrega los siguientes plugins en tu archivo build.gradle.Agrega los siguientes repositorios en tu archivo settings.gradle.Inicializa el SDK#
Es necesario inicializar el SDK configurando tu token de usuario y el ambiente de trabajo.| Propiedad | Tipo | Requerido | Descripción | Valores permitidos |
|---|
| context | Object | Sí | android.content.Context | |
| sdkMode | Object | Sí | InitBillpocketSDK.SdkMode. | TEST, PRODUCTION |
| userToken | String | Sí | Token de usuario. | |
| deviceToken | String | NO | ID del dispositivo. Se puede ver y renombrar desde el panel de control de Billpocket, en la sección 'Mis dispositivos | |
| listener | Object | Sí | EventListenerInitSDK | |
Envía un objeto eventListener el cuál implementa la interfaz EventListenerInitSDK para escuchar el resultado de la inicialización.Conecta un lector bluetooth#
Vincula la terminal con tu dispositivo móvil vía bluetooth para que pueda ser visible a través del SDK. Obtén la lista de terminales disponibles utilizando el método getListBluetoothReaders.Implementa el método resultListReaders de la interfaz EventListenerConnection para obtener el resultado.Para dispositivos con un nivel de API inferior a 31, deberás verificar los permisos bluetooth.Implementa el método connectReader para obtener el elemento seleccionado de la lista de dispositivos disponibles. Obtén los datos type, macAddress y name del objeto BluetoothDevice previamente seleccionado.Implementa el método resultReaderConnect de la interfaz EventListenerConection para obtener el resultado de la conexión.Modelo de datos de la solicitud#
Estos son todos los parámetros que puedes configurar al momento de realizar una solicitud.| Propiedad | Tipo | Requerido | Descripción |
|---|
| context | Object | Sí | android.content.Context |
| amount | Number | Sí | Monto de la transacción. |
| description | String | Sí | Descripción de la transacción. |
| location | Object | Sí | Instancia del objeto android.location.Location con latitud y longitud desde donde se realiza la operación. |
| tip | Number | No | Monto de la propina. Dos decimales. |
| listener | Object | Sí | Instancia de EventListenerTransaction. |
| rotationSignature | Boolean | No | Configura la pantalla para firmar la transacción en horizontal (false) o vertical (true). |
Operaciones#
Descubre todas las operaciones disponibles a través de integraciones por Terminal SDK.Venta#
Realiza una venta por un monto fijo (incluyendo impuestos) en tu comercio a través de una terminal. La terminal te permite leer la tarjeta de tu cliente y realizar operaciones implicadas en el proceso DUKPT. La responsabilidad de tu sistema punto de venta es obtener los datos leidos de la terminal y armar el mensaje con la información requerida para enviar una solicitud. Envía la información a Kushki para su procesamiento.Utiliza el método doTransaction para iniciar una transacción con la terminal. Debes enviar todos los parámetros requeridos en la solicitud.Envía un objeto eventListener el cuál implementa la interfaz EventListenerTransaction para escuchar eventos de transacción.Descubre cómo implementar pagos diferidos, desconectar una terminal, autenticar una transacción y otros métodos disponibles en la documentación del SDK.Respuesta#
La respuesta será devuelta como uno de los siguientes callbacks, dependiendo el resultado.onTransactionSuccessful#
Este callback es llamado cuando la transacción ha sido exitosa.onTransactionFinished#
Este callback es llamado cuando se ha realizado un cobro con una tarjeta de banda magnética o se ha producido un error durante la transacción.onTransactionAborted#
Este callback es llamado cuando se cancela la operación. Por ejemplo, es llamado cuando se desconecta la terminal o se agotó el tiempo de lectura de la tarjeta.
Datos de prueba
Realiza los ajustes necesarios en tu sistema con los datos de prueba.Transacciones
Obtén la lista de transacciones con información relevante para tus operaciones. Modificado en 2026-10-21 19:52:23
