Un panel que había crecido pantalla por pantalla
El panel de comercios de Izipay cumplía su función, pero cada sección se había construido por su lado: sus propios filtros, su propio espaciado, su propia forma de mostrar un estado. Los comercios lo sentían como fricción, y el equipo lo sentía en cada entrega, porque el Figma ya no describía el producto que salía a producción.
Así que empecé por el look and feel, sobre una pantalla real. Ventas es donde los comercios pasan el día, y muestra todo el cambio de una vez.
Arrastra la línea roja, o enfócala y usa las flechas del teclado.
Las reglas detrás son pocas, y cada pantalla las sigue:
- Un solo sistema tipográfico. Aptos para todo lo que un comercio lee o escribe, y Poppins solo en títulos de 20 px o más.
- Un solo color principal. El turquesa de Izipay marca la acción principal y el lugar actual; nada más compite con él.
- Un solo patrón de filtros. Cada lista filtra apenas tocas un control, sin botón Aplicar.
- Las palabras del comercio. “N.° de pedido” en vez de un ID interno de venta; totales por estado en vez de pestañas sueltas.
Figma, después código, y de vuelta a Figma
Un nuevo look and feel solo dura si el equipo puede seguir construyéndolo. Empecé donde diseña el equipo: en el archivo DS | Panel 2026 diseñé en Figma los nuevos componentes padre, cada uno con todos los estados y tamaños que necesita. Solo Input Text cubre siete estados, de default a error y completado, en cuatro tamaños.
Después llevé los componentes a código, donde las interacciones reales muestran lo que un frame estático no puede. Los filtros deberían reaccionar apenas los tocas. Un tooltip necesita espacio para poder leerse. Ahí adapté y mejoré cada componente, y cuando un flujo funcionaba en el navegador, lo llevaba de vuelta a Figma, para que el archivo muestre el producto tal como se comporta.
Lo que sostuvo ese ida y vuelta fue una regla de nombres. El nombre de un token en código es su nombre de Figma en minúsculas, con barras y espacios convertidos en guiones, así diseño y desarrollo usan la misma palabra para el mismo valor.
Figma
Código
color/neutral/darkest 900
--color-neutral-darkest-900
text/body/base/bold
--text-body-base-bold
Button · Primary · Small
.button.button--primary.button--small
Los componentes siguen la misma idea: cada propiedad de Figma se vuelve un modificador, así Button · Primary · Small es .button.button--primary.button--small en código.
Documentado donde ambos lados miran
Un sistema que nadie encuentra es un sistema que nadie sigue. Lo documenté como un catálogo vivo, renderizado con la misma hoja de estilos del panel, así si algo cambia ahí, cambia también en el panel. Cubre 58 secciones: fundamentos, componentes con todos sus estados, las piezas que necesitó cada flujo, la navegación y el onboarding.
Cada componente también registra dónde se diferencia a propósito del Figma, y por qué. Algunos ejemplos:
- Los tooltips crecen hasta 240 px de ancho en vez de 80 fijos, para que su texto se pueda leer.
- Las barras de filtros se quedan en 40 px en vez de 36, para mantener un área táctil cómoda.
- La “x” para cerrar es turquesa y no roja, porque el rojo se lee como error.
El primer flujo sobre el nuevo sistema
Con el sistema listo, el primer flujo en usarlo fue el que Izipay más necesitaba. Conectar una tienda online dependía de atención personalizada, y eso no escala a miles de comercios pequeños. En el panel anterior, todo lo que necesitaba un desarrollador vivía en una sola pantalla de Desarrolladores con dos pestañas.
Mapeé el recorrido de integración de principio a fin y estudié cómo otras plataformas de pago hacen el onboarding de desarrolladores. La guía de configuración de Stripe fue la referencia más clara, sin su modo enfoque.
El inicio ahora sugiere el siguiente paso en vez de exigirlo: integrar tu web, crear un link de pago si todavía no tienes web, o ir directo a producción si ya sabes cómo.
Integra tu web divide el trabajo en cinco pasos y dos grupos. Primero, prueba tu integración: elige tu plataforma, obtén tus claves de prueba, configura una URL de notificación y haz un pago de prueba. Después activa producción, que queda bloqueada hasta que las pruebas pasen. Cualquier paso se puede saltar y retomar.
Los desarrolladores ahora tienen cuatro pantallas enfocadas en vez de una: Integra tu web, API Keys, Webhooks y Apple Pay. En API Keys, prueba y producción viven en pestañas separadas, y cada clave se agrupa según para qué sirve.
Sobre lo que el equipo construye ahora
- pantallas reconstruidas con el nuevo look and feel, revisadas a 1440 y 375 px
-
23 - tokens de diseño, cada uno con el nombre de su estilo de Figma
-
277 - componentes padre, con todos sus estados
-
17 - secciones documentadas en el catálogo vivo
-
58
Entregué el prototipo, el design system y su documentación al equipo UX/UI y a desarrollo como base del nuevo panel. Todavía es un prototipo, así que aún no hay métricas en vivo.
Lo que aprendí
Un design system no está terminado cuando se dibuja. Está terminado cuando resiste el uso real. Llevar los componentes de Figma a código y de vuelta me enseñó a tratar la entrega como un ciclo y no como algo de una sola vía: cada decisión tomada en el navegador tiene que volver al archivo de diseño, con el mismo nombre, o los dos vuelven a separarse.
También aprendí que un nuevo look and feel es tan fuerte como su documentación. Dejar escrito por qué un componente se diferencia del Figma es lo que evita que la siguiente persona lo “arregle” de vuelta.