Saltar al contenido principal
Migo Docs

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.

info

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 authUserId que pasarás al SDK.
  • Un comercio / negocio.
  • Una sucursal (branch) — dónde se dan de alta las terminales; su id es el branchId del 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​