¿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.
No necesitas integrar cada rail por separado. Migo expone un solo conjunto de endpoints que enruta a las billeteras, bancos y redes de efectivo soportados; el comercio elige cuáles habilitar por país.
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. El ciclo de vida de extremo a extremo está en Cómo funciona.
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>.
Relacionado
- Métodos de pago disponibles — todos los métodos con país, tipo y forma de respuesta.
- Crear transacción — una integración real de punta a punta.
- Procesar pago — el body de petición unificado.
- Prueba tu integración — tarjetas de prueba en Sandbox.
- Referencia de API — el spec en vivo bajo
Alternative Payments.