¿Qué son los pagos alternativos?
Los métodos de pago alternativos (APMs) son todas las formas en que un cliente puede pagarte que no son una tarjeta de crédito o débito. En Guatemala incluyen billeteras digitales como Zigi o Akisi, códigos QR interbancarios como Banco Industrial o QuickPay QR, botones de banco hosteados como BAM PaymentButton y referencias de efectivo pagables en tiendas de conveniencia como Pronet.
En resumen: en cualquier lugar donde normalmente aceptarías un "transfiéreme" o un "lo pago desde mi app del banco", Migo lo convierte en un flujo programático.
Por qué importan
LATAM tiene una alta proporción de clientes no bancarizados o sub-bancarizados, e incluso los bancarizados a menudo prefieren su app de billetera/QR antes que escribir una tarjeta. Ofrecer APMs junto con tarjetas típicamente eleva la conversión de forma notable — especialmente para compradores primerizos y compras de menor ticket.
No necesitas integrar cada rail por separado. Migo expone un solo conjunto de endpoints que enruta a docenas de billeteras, bancos y redes de efectivo; el comercio solo elige cuáles habilitar por país.
Cómo funciona
Los pagos alternativos son un checkout asíncrono: creas una transacción, el cliente paga en un rail externo y Migo confirma el resultado antes de que trates el pedido como pagado. Ve Cómo funciona para el ciclo de vida de extremo a extremo y el diagrama.
Cómo difieren los APMs de los pagos con tarjeta
| Aspecto | Pagos con tarjeta | Pagos alternativos |
|---|---|---|
| Autenticación | 3DS / CVV / token en tu checkout | App bancaria del cliente, billetera o escáner QR |
| Autorización | Síncrona — recibes APPROVED en la respuesta | Asíncrona — confirmada después por un webhook del procesador |
| Liquidación | Capturada en la autorización | Liquidada cuando el cliente autoriza fuera de tu app |
| Datos requeridos | Un token de tarjeta | Payload específico del método (teléfono, id de banco, documento, voucher) |
| Modos de falla | Red, challenge 3DS, decline | El cliente abandona, el QR expira, el banco rechaza el push |
Los cuatro endpoints
Toda integración de APM usa solo cuatro endpoints — la misma forma sin importar el método que el cliente elija:
| Endpoint | Qué hace |
|---|---|
POST /api/v1/integrations/transactions | Crea la transacción y retorna los métodos disponibles para ese comercio. |
POST /api/v1/integrations/transactions/{id}/payment-intents | (Opcional) Obtiene metadatos dinámicos para los métodos que los necesitan. La mayoría de los rails de Guatemala no lo requieren; en sandbox, fri retorna un fixture de usuario que puedes usar para simular una autorización. |
POST /api/v1/integrations/transactions/{id}/payments | Envía el método elegido y cualquier dato recolectado del usuario. Retorna el payload específico del rail para renderizar. |
POST /api/v1/integrations/transactions/{id}/dismiss | Cancela una transacción no pagada o expirada para que el comercio pueda recuperar su UI. |
Todas las llamadas requieren Authorization: Bearer <token> — ve Autenticación.
A dónde ir después
- Ve todos los métodos disponibles con país, tipo y forma de respuesta en Métodos de pago disponibles.
- Recorre una integración real en Crear transacción.
- Entiende el body de petición unificado en Procesar pago.
- Navega el spec en vivo de la API bajo
Alternative Payments.