Saltar al contenido principal
Migo Docs

¿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​

AspectoPagos con tarjetaPagos alternativos
Autenticación3DS / CVV / token en tu checkoutApp bancaria del cliente, billetera o escáner QR
AutorizaciónSíncrona — recibes APPROVED en la respuestaAsíncrona — confirmada después por un webhook del procesador
LiquidaciónCapturada en la autorizaciónLiquidada cuando el cliente autoriza fuera de tu app
Datos requeridosUn token de tarjetaPayload específico del método (teléfono, id de banco, documento, voucher)
Modos de fallaRed, challenge 3DS, declineEl 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:

EndpointQué hace
POST /api/v1/integrations/transactionsCrea 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}/paymentsEnví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}/dismissCancela una transacción no pagada o expirada para que el comercio pueda recuperar su UI.

Todas las llamadas requieren Authorization: Bearer <token>.

Relacionado​