--- title: Onboarding por API slug: onboarding-por-api docTags: createdAt: 2026-01-24T19:08:33.348Z --- ## Definiciones El **ABM vía API** es la modalidad mediante la cual las operaciones de Alta, Baja y Modificación de entidades se realizan a través de **interfaces de programación expuestas por la Plataforma SUGA**, permitiendo la integración directa con sistemas externos del adquirente. Esta modalidad habilita al adquirente a **construir su propia interfaz de usuario (UI)**, flujos de onboarding y herramientas internas, utilizando las APIs de SUGA como capa de persistencia y validación. En particular, el adquirente puede implementar su propia experiencia de alta de comercios y consumir la **API de Alta de Comercios** de SUGA para registrar las entidades dentro de la plataforma. ::File{src="https://www.sugaway.dev/abm-de-sub-comercios" label="https://www.sugaway.dev/abm-de-sub-comercios"} ## Rol del ABM vía API dentro de la arquitectura El ABM vía API mantiene exactamente el mismo rol que el ABM operado por consola: - Es fuente de datos maestros. - Aplica las mismas validaciones. - Respeta los mismos contratos de datos. La diferencia radica únicamente en el **canal de interacción**. De esta forma, SUGA desacopla: :::BlockQuote Experiencia de usuario → Motor de validación → Persistencia de datos ::: ## Qué habilita al adquirente - Diseñar una experiencia de onboarding propia. - Integrar ABM dentro de portales existentes. - Automatizar altas desde otros sistemas. - Controlar el orden y la lógica de carga de información. Sin perder gobierno sobre: - Estructura de datos. - Campos obligatorios. - Reglas de negocio. ## Responsabilidad del integrador Cuando se utiliza ABM vía API, el adquirente es responsable de: - Respetar los layouts y contratos de datos. - Validar formatos antes de invocar la API. - Enviar información completa y consistente. SUGA valida nuevamente la información, pero una correcta implementación del lado del integrador reduce rechazos y reprocesos. ## Beneficios - Flexibilidad total de experiencia. - Automatización. - Escalabilidad. - Integración nativa con ecosistemas existentes.