Saltar al contenido principal
Migo Docs

Créditos Core

Créditos Core (Credits API v2) es el producto base de crédito de Migo. Un tercero lo consume para construir su propia solución de crédito o financiamiento sin integrar a cada entidad financiera por separado: Migo coordina la afiliación bancaria, la consulta de cuenta y el ciclo de vida completo de la transacción de crédito a través de un contrato estable.

La idea es simple: tú llamas a una sola API y Migo se encarga de hablar con cada entidad financiera (BAM, GE u otra). Si mañana se suma un banco nuevo, tu integración no cambia — el banco viaja como un dato más en la URL (bankSlug) y todas las respuestas tienen siempre la misma forma { success, data }.

Está pensado para terceros —comercios, fintechs o plataformas— que quieren ofrecer crédito a sus usuarios sin construir e integrar con cada banco por separado. No necesitas conocer la infraestructura interna de Migo: te basta con los endpoints de esta sección.

En 6 pasos​

El camino feliz, de principio a fin, son seis llamadas: creas el usuario, lo afilias a un banco, validas el OTP que el banco le envía, creas la transacción, la autorizas (el banco reserva el monto) y la capturas (se ejecuta el cobro). Cada paso está explicado, con su ejemplo real, en Visión general.

Qué puedes construir​

  • Un flujo de onboarding de crédito: crear el usuario, afiliarlo a una entidad financiera y validar el OTP.
  • Un flujo de compra a crédito: crear la transacción, preautorizar el monto y capturar el cobro.
  • Un flujo de pre-calificados: registrar usuarios pre-aprobados antes de completar el onboarding bancario.
  • Un panel de consulta de cuenta: saldo, monto aprobado, monto usado y próximos pagos.
  • Manejo de reversos y cancelaciones, incluyendo la cancelación automática por expiración.

Áreas de la API​

Cada área agrupa un conjunto de endpoints bajo un prefijo de URL:

ÁreaPrefijoPara qué sirve
Usuariosv2/credits/usersCrear usuarios, afiliarlos a un banco, OTP, pre-calificados
Transaccionesv2/credits/transactionsCrear, autorizar, capturar, cancelar y reversar
Cuentasv2/credits/accountsConsultar saldo/cupo de una cuenta y enviar su OTP
Webhooksv2/credits/webhooksAvisos que el banco y otros sistemas envían a Migo

Ruta de integración​

Para el detalle técnico exhaustivo de esquemas, campos y códigos de estado, navega la referencia interactiva de Créditos Core en vivo.