Preguntas frecuentes
Empezar
¿Cómo obtengo credenciales de API?
Contacta a tu account manager de Migo. Las credenciales se emiten por ambiente (QA + producción).
¿Qué lenguajes / SDKs soportan?
El único SDK documentado en este portal es el SDK de Android de Tap to Phone (paquete com.migo.sdkmigo, minSdk 29); su instalación está en Instalación del SDK. No hay versión para iOS.
Para el resto de las integraciones, el camino documentado es generar un cliente tipado a partir de las especificaciones OpenAPI publicadas en la Referencia de API — por ejemplo con openapi-typescript (TypeScript), oapi-codegen (Go) u openapi-python-client (Python).
Si necesitas una librería nativa distinta de esas, consulta con tu account manager de Migo qué hay disponible para tu integración.
¿Hay sandbox?
Sí. Revisa Entornos y URLs base. Todas las funcionalidades operan en sandbox con tarjetas de prueba — consulta Prueba tu integración.
Autenticación
¿Cuánto duran los access tokens?
Para el gateway de comercio/cliente, los access tokens duran 30 minutos y los refresh tokens duran 7 días. Los tiempos de vida de los tokens de usuario de Wallet son configurables por reglas de partner/sesión (definidos por el servicio de configuración), no son valores fijos.
¿Refresh tokens?
De un solo uso. Cada refresh rota tanto el access token como el refresh token. Descarta el refresh token anterior de inmediato.
¿Qué pasa si pierdo el refresh token?
Vuelve a iniciar sesión para obtener un nuevo par de tokens. Si olvidaste tu contraseña, usa el flujo de restablecimiento: solicita un código de un solo uso vía POST /users/auth/otp y luego llama a POST /users/auth/password/reset.
Pagos
¿Cuál es la diferencia entre pagos one-step y two-step?
- One-step — autoriza + captura en una sola solicitud. Úsalo en retail.
- Two-step — autoriza ahora, captura después (hasta 7 días). Úsalo en marketplaces, hospitalidad y pre-órdenes.
Para aceptación con tarjeta, los cobros corren a través del checkout hospedado de un link de pago.
¿Cuándo recibo los fondos?
Captura → liquidado: día hábil siguiente después del corte de las 23:30 UTC. Liquidado → en el banco del comercio: T+1 a T+3 dependiendo del banco emisor.
¿Soportan Apple Pay / Google Pay?
En el POS vía contactless (NFC), sí. La provisión de tarjetas emitidas por Migo en wallets Apple/Google Pay: planificado, aún no liberado.
¿Y las cuotas / installments?
El soporte de cuotas depende del emisor — contacta a soporte para confirmar la disponibilidad según la configuración de tu terminal. El body documentado de CreateTerminalPaymentInput no expone un campo installments de nivel superior.
Webhooks
¿Qué eventos puedo recibir?
Los webhooks de cobros notifican los cobros con terminal de tu comercio: terminal.payment.approved y terminal.payment.denied. Las cancelaciones y las reversiones no emiten eventos. Los endpoints /webhooks/volcan y /webhooks/settlements son otra cosa: reciben llamadas entrantes de procesadores.
¿Recibiré eventos duplicados?
Sí — la entrega es at-least-once y un mismo evento puede llegar más de una vez. Siempre deduplica por el id del evento (igual al header X-Migo-Event-Id).
¿Cómo verifico la firma?
Calcula el HMAC-SHA256 de t + "." + body crudo con el secreto del webhook, compáralo en tiempo constante con el v1 del header X-Migo-Signature y rechaza el evento si t se aleja más de 300 segundos de la hora actual. Guía completa, con ejemplos en Node.js y Python, en Verificar la firma.
¿Cuánto tiempo reintenta Migo las entregas fallidas?
Unas 33 horas: 7 intentos en total, con esperas de 5 minutos, 15 minutos, 30 minutos, 2 horas, 6 horas y 24 horas entre ellos. Una entrega es exitosa cuando tu endpoint responde 2xx en menos de 10 segundos. Ver Reintentos.
¿Puedo pausar la entrega de eventos?
Sí: envía PATCH con { "enabled": false } al webhook y vuelve a true para reactivarlo; el secreto no cambia. Mientras está pausado no recibe eventos nuevos. Ver Editar, pausar o reactivar.
Suscripciones
¿El primer cobro es automático?
Una suscripción se crea a través del flujo de verificación de tarjeta (POST /api/v1/subscriptions/verify-card con shouldCreateSubscription=true), que internamente crea la suscripción. No existe un endpoint público POST /api/v1/subscriptions ni un parámetro startAt.
¿Y si un cobro programado falla?
Las renovaciones fallidas se manejan con un modelo de período de gracia (seguimiento del estado de renovación), no con una escalera de reintentos fija. El estado terminal de una suscripción es inactive o expired — no existe un estado unpaid. La cadencia exacta del período de gracia es configurable; contacta a soporte para confirmar los valores de tu cuenta.
¿Puedo cobrar fuera del calendario?
Sí — Cobros de monto variable.
Tarjetas y wallet
¿Las tarjetas emitidas por Migo funcionan con Apple / Google Pay?
La provisión está planificada, aún no liberada. Una vez en vivo, se soportará el push provisioning de tarjetas vía el Wallet SDK.
¿Cómo recupero un CVV?
Dos pasos: solicita un view token y úsalo en el GET de CVV desde el cliente móvil. Nunca desde tu backend.
¿Una tarjeta puede pertenecer a varios usuarios?
Sí — los permisos por usuario controlan quién puede hacer qué. Revisa Gestión de tarjetahabientes.
Cumplimiento
¿Cuál es el alcance PCI-DSS de Migo?
Service Provider Nivel 1. Revisa Seguridad y alcance PCI.
¿Dónde se almacenan los datos?
Región primaria: AWS us-east-1, con una región secundaria en AWS us-east-2. Para detalles de residencia de datos, GDPR y cumplimiento regional, contacta a legal.
¿Pueden entregarme un reporte SOC 2?
Sí — bajo NDA. Contacta a tu account manager de Migo.
Errores
Recibí un 7604 INVALID_SIGNATURE — ¿qué está mal?
La firma de tu solicitud no se validó. La causa más común es que el body JSON fue re-serializado antes de firmar, cambiando el contenido en bytes. Firma los bytes del raw body y verifica que tus llaves de firma estén vigentes.
Recibí un 7616 KEYS_EXPIRED — ¿qué significa?
Tus llaves de firma han expirado. Rótalas y autentícate de nuevo.
¿Qué significa 7303 INSUFFICIENT_FUNDS?
La cuenta de origen no tiene saldo suficiente para completar la transacción. Consulta el Catálogo de errores completo para cada código y su status HTTP.
Relacionado
- Catálogo de errores con todos los códigos
- Contacto para soporte directo