Pagos con terminal (Tap to Phone)
Migo provee un SDK de Android para aceptar pagos con tarjeta presente sin hardware POS: usa la tecnología NFC del teléfono para leer la tarjeta y cobrar. Embebes el SDK en tu app móvil y un teléfono Android con NFC se convierte en tu terminal de cobro.
El SDK es solo para Android (minSdk 29) y el dispositivo debe tener NFC — ahí corre la lectura de la tarjeta presente. La integración completa vive en Instalación del SDK.
El recorrido de extremo a extremo
1. Migo aprovisiona contigo cuenta (tenant/merchant) · usuario · comercio · sucursal
│ (lo define tu contacto comercial, no por API)
▼
2. Integra el SDK agrega migoSDK a tu app Android e inicialízalo
│ migoSDK.initService(merchantId, signature, authUserId, branchId)
▼
3. La terminal se registra al ser nueva, el SDK la crea y solicita activación vía ticket (Guatemala)
│
▼
4. Migo activa la terminal activeTerminal = true ──► lista para cobrar
│
▼
5. Cobra con tarjeta presente migoSDK.doTransaction(...) ──► voucher ──► doFinishTransaction(...)
│
▼
6. Liquidación vehículo definido con comercial: tarjeta · cuenta bancaria · balance
1. Lo que Migo aprovisiona
Antes de integrar, tu contacto comercial de Migo aprovisiona en tu cuenta la jerarquía sobre la que se registran las terminales:
- Una cuenta Migo (tenant / merchant).
- Un usuario — su id es el
authUserIdque pasarás al SDK. - Un comercio / negocio.
- Una sucursal (branch) — dónde se dan de alta las terminales; su id es el
branchIddel SDK.
No registras estas entidades por API: son parte del alta comercial. Detalle en Instalación del SDK → Prerrequisitos.
2. La terminal se registra sola
La terminal no se aprovisiona de antemano: cuando el SDK se inicializa en un dispositivo y detecta que la terminal es nueva, la crea automáticamente bajo la sucursal y solicita su activación abriendo un ticket de soporte (en Guatemala). Una vez que Migo la activa, la terminal queda lista para cobrar. Detalle en Registro y activación de la terminal.
3. Cobrar con tarjeta presente
Con la terminal activa, ejecutas el cobro desde tu app con migoSDK.doTransaction(...): el SDK lee la tarjeta por NFC, te devuelve los datos para confirmar y, tras autorizar, te entrega el voucher; tú lo finalizas para liquidarlo. Flujo completo en Procesar un pago con terminal.
4. Liquidación
Los cobros aprobados se liquidan al vehículo asociado al comercio — tarjeta, cuenta bancaria o balance en la plataforma de Migo —, que defines con tu contacto comercial al activar la terminal. Detalle en Liquidación.
Relacionado
- Visión general — modelo de hardware, escenarios de tarjeta y alcance PCI.
- Instalación del SDK — repositorio, dependencia, permisos, inicialización y activación.
- Procesar un pago con terminal — el cobro con tarjeta presente y la liquidación.
- Cancelar un cobro en curso — aborta un cobro que aún no se autorizó.
- Reversar un cobro autorizado — deshaz un cobro ya aprobado.
- Webhooks de cobros — recibe en tu servidor un aviso firmado por cada cobro aprobado o rechazado.
- Referencia del SDK — todos los métodos, callbacks, enums y entidades.