Referencia de API
Migo Payments expone cuatro APIs REST. Cada una tiene su propia referencia interactiva, renderizada con Scalar en una página aparte a la que se llega desde la tabla siguiente.
Qué API necesito
| API | Para qué la usas | Audiencia | Base URL | Autenticación | Referencia |
|---|---|---|---|---|---|
| Wallet Gateway | Construir una billetera o programa de tarjetas — emitir tarjetas, tokenizar, cobrar, transferir, dar de alta comercios | Apps de usuario final, backends de socios | https://api.ali.app/rest | JWT (Ed25519) — Authorization: Bearer <token>. La identidad de la aplicación viaja dentro del JWT; el header applicationId solo se usa en los endpoints de configuración/integridad | Abrir Scalar |
| Middleware (legacy) | Emitir links de pago hospedados, ejecutar facturación de suscripciones, aceptar pagos alternativos, gestionar suspensiones por fraude | Servidor a servidor (backends de comercio, procesadores) | https://mw.migopayments.com | JWT — Authorization: Bearer <middleware-jwt> | Abrir Scalar |
| Migo Payments Gateway (migración, acceso anticipado) | Búsqueda de transacciones y sondas de salud durante la transición Migo→ALI | Integradores habilitados explícitamente por Migo | https://api.migopayments.com | JWT — Authorization: Bearer <token> | Abrir Scalar |
| Credits API v2 | Construir tu propia solución de crédito — afiliación bancaria, cuentas y ciclo de vida transaccional (Créditos Core) | Comercios, fintechs y plataformas que ofrecen crédito a sus usuarios | https://api.migopayments.com/v2/credits | Authorization: <token> emitido por Migo, validado por un TOKEN Authorizer — ver Autenticación | Abrir Scalar |
El Wallet Gateway y el Middleware están abiertos a cualquier cliente de Migo. Los dominios que cubre cada uno (ilustrativos, no exhaustivos):
- Wallet Gateway — Auth, Users, Cards, Card Transfers, Settlements, Terminal Payments, Leads, Businesses, Reports, Webhooks.
- Middleware — Verifications, Suspensions, Subscriptions, Plans, Transactions, Payments, Cards, Auth, Config, Alternative Payments, Webhooks.
Prueba en el navegador
Cada referencia se renderiza como una consola en vivo — elige un endpoint, completa los parámetros requeridos y envía una solicitud. Inicia sesión una vez en el bloque "Authentication" para obtener un token y, a partir de ahí, todos los demás endpoints autocompletan el header Authorization.
Todas las referencias apuntan a producción por defecto (el primer servidor de cada especificación). Cambia a QA/Sandbox en el selector de servidor antes de enviar solicitudes de prueba.
Especificaciones OpenAPI
El JSON crudo de OpenAPI 3.0 es público y descargable:
/openapi/ali-api-gw-rest.json/openapi/migo-api.json/openapi/migo-api-gw-rest.json/openapi/migo-credits.json
Úsalos para generar clientes tipados con openapi-typescript, oapi-codegen o cualquier otro generador de código OpenAPI. Importar cualquiera de estas especificaciones en Postman genera una colección.
Siguientes pasos
- ¿Nuevo en Migo? Empieza por el Quickstart de Sandbox.
- ¿Buscas conceptos? Consulta el Glosario de pagos.