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:
| Área | Prefijo | Para qué sirve |
|---|---|---|
| Usuarios | v2/credits/users | Crear usuarios, afiliarlos a un banco, OTP, pre-calificados |
| Transacciones | v2/credits/transactions | Crear, autorizar, capturar, cancelar y reversar |
| Cuentas | v2/credits/accounts | Consultar saldo/cupo de una cuenta y enviar su OTP |
| Webhooks | v2/credits/webhooks | Avisos que el banco y otros sistemas envían a Migo |
Ruta de integración
- Visión general — cómo encaja y el flujo de extremo a extremo con ejemplos
- Autenticación — cómo te identificas y qué forma tienen las respuestas
- Usuarios y pre-calificados — crear/consultar usuarios y registrar pre-calificados
- Afiliación bancaria y OTP — asociar el usuario a una entidad financiera
- Consulta de cuenta — datos de cuenta y OTP de cuenta
- Ciclo de vida transaccional — nueva → autorizar → capturar → cancelar/reversar
- Webhooks y notificaciones — los avisos que recibes del banco y del colector
- Catálogo de errores — qué significa cada código y cuándo reintentar
Para el detalle técnico exhaustivo de esquemas, campos y códigos de estado, navega la referencia interactiva de Créditos Core en vivo.