Menú: Documentación

APK

Cómo empezar

Qué es la integración APK: tu comandera conectada con honei dentro del mismo dispositivo. Conecta el terminal, instala tu app con ADB y empieza a desarrollar.

Qué es la integración APK

La integración APK conecta tu comandera, o la app con la que trabaja el camarero, con honei dentro del mismo dispositivo. Tu app se instala en el terminal junto a honei Terminal y, cuando llega el momento de cobrar, le pasa el importe directamente. honei se encarga del cobro y le devuelve el resultado a tu app.

Dentro del terminalTu comanderaTu APKLanza el cobrohonei TerminalCobra con tarjetaDevuelve elresultadoTu comanderaSigue trabajando

Es para ti si: tu comandera o tu TPV es una APK que se instala en el propio terminal. Todas las APK se integran mediante Intents de Android, sin llamadas HTTP.

En qué se diferencia de las otras integraciones

Integración Dónde está tu software Cómo se conecta con honei
APK En el propio terminal, junto a honei Terminal Con un Intent, dentro del mismo dispositivo
Pay at counter En otro dispositivo, como un ordenador o una tablet Envía el cobro al terminal con la Cloud API o la Local API
Pay at table En tu TPV, y el camarero cobra desde honei Terminal honei llama a tu API para obtener la cuenta y enviarte el pago

Tus pasos

  1. Conecta el terminal a tu ordenador e instala tu APK, en esta misma página.
  2. Lanza un cobro con un Intent.
  3. Pruébalo con la guía de Testing.
  4. Revisa los requisitos de seguridad.
  5. Pasa la certificación y recibe tus credenciales de producción.

Antes de empezar

El acceso está limitado a partners y desarrolladores aprobados. Antes de integrar con honei Terminal necesitas la aprobación expresa del equipo de partnerships.

Cuando tengas la aprobación, te entregaremos un terminal de pruebas. Todo el desarrollo y las pruebas deben hacerse con él antes de pasar a producción.

Conecta el terminal a tu ordenador

El terminal que te entregamos viene en modo debug, así que puedes enchufarlo directamente a tu ordenador y controlarlo con ADB (Android Debug Bridge): instalar tu APK, actualizarla y ver sus logs.

1Enchufa el terminalPor USB2Confía en el ordenadorEn la pantalla delterminal3Comprueba la conexiónadb devices4Instala tu APKadb install
  1. Instala ADB en tu ordenador. Viene incluido en las Android SDK Platform-Tools.
  2. Enchufa el terminal al ordenador por USB.
  3. En la pantalla del terminal, acepta el aviso para confiar en este ordenador.
  4. Comprueba que el ordenador lo detecta:
Terminal
adb devices

El terminal debe aparecer en la lista con el estado device.

Instala tu APK

Con el terminal conectado, ADB te permite controlar la instalación de tu app:

Terminal
# Instalar o actualizar tu APK
adb install -r tu-app.apk

# Ver los logs del terminal
adb logcat

# Desinstalar tu app
adb uninstall com.tuempresa.tuapp

Si algo no funciona

Qué ocurre Qué hacer
El terminal no aparece en adb devices Prueba otra ranura USB de tu ordenador.
Aparece como unauthorized Acepta en la pantalla del terminal el aviso para confiar en este ordenador.

Repositorio de ejemplo

Tenemos una app de ejemplo que muestra cómo integrarse con los Intents de honei Terminal: honei-terminal-intent-example-app.