Saltar al contenido principal
Migo Docs

Bienvenido al Portal de Desarrolladores de Migo Payments

Migo Payments es una plataforma de infraestructura de pagos. Nuestras APIs públicas te permiten aceptar pagos con tarjeta, operar un programa de billetera y tarjetas, dar de alta comercios, ejecutar suscripciones recurrentes y recibir webhooks ante cada cambio de estado.

Qué puedes construir​

  • Aceptar pagos con tarjeta — cobros en un solo paso, autorización + captura en dos pasos, 3-D Secure, reembolsos y tokenización.
  • Operar un programa de billetera y tarjetas — emite tarjetas físicas, asigna fondos, mueve dinero de tarjeta a tarjeta, rota PINs y recupera CVVs bajo demanda.
  • Aceptar pagos en terminal (POS) — captura cobros con tarjeta presente y liquídalos a un balance o a una tarjeta prepago.
  • Vender suscripciones — crea planes, suscribe a los titulares de tarjeta y ejecuta cobros programados o bajo demanda (incluyendo cobros masivos por CSV).
  • Dar de alta comercios — captura leads con documentos KYC, promuévelos a negocios y aprovisiona sucursales y terminales.
  • Recibir webhooks — cada evento de pago, liquidación, reembolso y suscripción se envía a tu endpoint con semántica de reintentos.

Las tres APIs​

Migo expone tres APIs REST. Elige la que corresponda a tu rol.

APIAudienciaBase URL (prod)Autenticación
Wallet Gateway (ali-api-gw-rest)Apps móviles y web construidas sobre Migo (billeteras, programas de tarjetas, herramientas para comercios)https://api.ali.app/restJWT Bearer
Middleware (migo-api)Servidores backend que emiten Payment Links hospedados, ejecutan facturación recurrente, suspensiones y verificaciones de BINhttps://mw.migopayments.comJWT Bearer; la variante transactions-hook de Payment Link acepta en su lugar credenciales privateKey + publicKey en el cuerpo
CMS Backoffice (ali-api-cms-rest)Socios autorizados de Migo y operadores internoshttps://api.ali.app/cms/restJWT Bearer + x-user-token
info

La API del CMS está restringida a socios autorizados. Consulta la sección CMS / Backoffice API para conocer los requisitos de acceso.

Siguientes pasos​

  1. Lee Autenticación para entender el flujo de JWT compartido por las tres APIs.
  2. Elige el Entorno correcto (sandbox vs producción).
  3. Sigue el Inicio rápido para realizar tu primera solicitud autenticada en menos de 5 minutos.
  4. Explora la Referencia de API para ver el catálogo completo de endpoints, renderizado con Scalar.

Convenciones​

  • Todas las respuestas siguen el envoltorio CustomResponse<T> — { statusCode, message, data } en caso de éxito, { statusCode, message, error: { code, name, detail } } en caso de fallo. Consulta Manejo de errores.
  • Los códigos de error de negocio están en el rango 7000–8099. Lista completa en el Catálogo de errores.
  • Los montos monetarios usan precisión Decimal(20,4) — trátalos como strings en JavaScript para evitar redondeos.
  • Las marcas de tiempo son ISO 8601 en UTC salvo que se indique lo contrario.
  • La paginación usa los parámetros de consulta page, limit, sortBy, sortOrder, searchText.