propuesta · v1.0 · agosto 2026
verificación de identidad · apps/consultorio

El momento en que Amedi puede responder por ti.

Hoy el consultorio le dice al doctor «tu identidad se está verificando». No es cierto: lo único que se comprueba es que un número de MPPS exista en SACS. Nadie confirma que la persona detrás de la cuenta sea la dueña de esa licencia. Esta propuesta diseña la verificación que falta —documento y biometría— como el primer acto de confianza del onboarding: un rito con foco, una card que muta sola y un permiso que se abre.

el acto
rito a pantalla completa
la espera
no existe, vuelve al hub
la recompensa
publicar tu perfil
el costo
plan free de MetaMap
01 el diagnóstico

Prometemos identidad y entregamos licencia.

El SacsVerificationBanner aparece sobre la lista de setup mientras isVerified sea falso. Su copy habla de identidad; su comprobación habla de un número. La brecha entre las dos frases es exactamente el agujero que cierra esta propuesta.

hoy · en producción
Tu identidad se está verificando Promedio 6 horas. Puedes seguir configurando mientras tanto.

Un banner ámbar, un booleano, una sola historia. Los colores no son de la paleta de Amedi: son #FFFBEB y #78350F, heredados de un default.

lo que realmente pasa

SACS responde «ese MPPS existe y el nombre calza».
Nadie preguntó nunca «¿y tú eres esa persona?»

Un médico podría registrarse hoy con la licencia de un colega y pasar la verificación completa. En una plataforma donde un paciente elige a quién le confía su salud, ese hueco no es un detalle técnico: es la promesa central del producto.

02 dos verificaciones, no una

Un booleano no puede contar dos historias opuestas.

SACS y MetaMap comprueban cosas distintas, tardan tiempos distintos y piden cosas distintas al doctor. Meterlas en el mismo isVerified obliga a la interfaz a mentir en una de las dos.

licencia · SACSidentidad · MetaMap
qué pruebael MPPS existe y es tuyotú eres quien dices ser
qué pidenada, ya lo escribió al registrarsesu cédula y su cara
cuánto tarda~6 horas~2 minutos
quién controlanadie, es una cola externael doctor, por completo
si fallase reintenta solo, luego revisión manualpuede reintentar al momento
en la interfazun estado que informauna card que invita a actuar

La consecuencia de diseño: la licencia se reporta, la identidad se ofrece. Nunca comparten componente.

03 la card de identidad

Un componente, siete verdades.

Vive en el Setup Hub, sobre la lista de tareas. Siempre la misma anatomía —marca, título, subtítulo, datos, acciones— para que el doctor nunca tenga que reaprender dónde mirar. Lo único que cambia es el tono.

01 sin verificar · nunca empezó
Verifica tu identidad
Tu cédula y una selfie. Toma unos dos minutos y lo haces una sola vez.
Empezar
02 en revisión · webhooks llegando
Revisando lo que enviaste
Suele tardar menos de un minuto. Sigue con lo tuyo, te avisamos acá mismo.
03 verificado · el estado que importa
Identidad verificada
Confirmamos que eres tú con tu documento y tu rostro.
según tu cédula Carlos Horacio Carrasquero Quintini · V24.529.757
04 confirma tu nombre · discrepancia cosmética
Identidad verificada
Tu cédula dice tu nombre completo. ¿Lo usamos en tu perfil?
pasaría a ser Carlos Horacio Carrasquero Quintini
Usar el de mi cédula Dejar el mío
05 revisión manual · discrepancia sustantiva
Estamos revisando tu caso
El nombre de tu documento no coincide con el de tu perfil. Alguien del equipo lo revisa en menos de 24 horas.
06 rechazado · con salida, nunca callejón
No pudimos verificar tu identidad
La foto del documento salió borrosa. Puedes intentarlo otra vez ahora mismo.
Intentar de nuevo Escribir a soporte

Falta el estado 07 —en proceso, mientras el modal de MetaMap está abierto— porque literalmente no se ve: la card queda detrás del overlay del proveedor.

La licencia, en cambio, no es una card

  • SACS es una línea de estado discreta bajo la card de identidad: «Licencia MPPS · verificando · ~6 h». Informa, no interpela.
  • Nunca lleva botón: el doctor no puede hacer nada al respecto, y un botón que no resuelve nada es ruido.
  • Cuando SACS pasa a verde, la línea desaparece en lugar de celebrar. Solo lo accionable merece permanencia.
04 el rito

Antes de pedir la cámara, explicar por qué.

El SDK de MetaMap abre su propio modal, con su cámara y su marca — eso no lo controlamos. Lo que sí es nuestro es la antesala, y es donde se gana o se pierde la confianza. Sale del hub a pantalla completa, sobre noche, sin navegación ni distracciones: una sola pregunta a la vez.

Vamos a confirmar que eres tú

Esto es lo que nos deja poner tu nombre frente a un paciente y responder por él. Lo haces una sola vez.

  • Tu cédula — la fotografías con la cámara, por delante y por detrás.
  • Tu rostro — una selfie corta para comprobar que coincide con el documento.
  • Nada se queda en Amedi — las imágenes las procesa nuestro proveedor de verificación; nosotros solo guardamos el resultado.
Tengo mi cédula a mano Ahora no

Dos minutos · funciona igual desde el teléfono

«Tengo mi cédula a mano» en vez de «Continuar»: el botón dice qué se necesita para que el siguiente paso no falle. Ahora no siempre existe — el rito bloquea publicar el perfil, no usar el consultorio.

05 la vuelta

Nadie se queda mirando una barra de carga.

Cuando el modal de MetaMap cierra, el doctor vuelve al hub y sigue configurando su perfil. La verificación se resuelve por detrás: siete chequeos independientes que llegan como eventos en unos quince segundos. No le pedimos su atención para algo que no requiere su atención.

consultorio.amedisalud.com/doctor/setup
Termina tu perfil 8 de 13 · 12 min restantes
Revisando lo que enviaste
Sigue con lo tuyo, te avisamos acá mismo.
Datos personales
Tus especialidades
Foto profesional1 min
Configura tus horarios3 min
Tarifa de consulta1 min
Publicar mi perfil
así te verán los pacientes
Dr. Carlos Carrasquero
Medicina interna · Caracas

Tu perfil todavía no es visible. Se publica cuando termines de verificarte.

06 la revelación

La recompensa no es confeti: es un permiso.

Llega el veredicto mientras el doctor está en otra cosa. Nada lo interrumpe. La card muta donde está —de gris que respira a menta que asienta, con su nombre real leído del documento— y abajo, el botón que llevaba todo el onboarding apagado se enciende.

Revisando lo que enviaste
Sigue con lo tuyo, te avisamos acá mismo.
Identidad verificada
Confirmamos que eres tú.
según tu cédula Carlos Horacio Carrasquero Quintini · V24.529.757
Publicar mi perfil
Publicar mi perfil

El candado desaparece y el botón toma el petroleo de las acciones reales. Es la única transición del onboarding donde algo se desbloquea en lugar de solo completarse — por eso es el momento, y por eso no necesita adornos.

Y la vista previa, que llevaba todo el setup diciendo «todavía no»

Dr. Carlos Carrasquero
Medicina interna · Caracas
Identidad verificada

El sello aparece también del lado del paciente. Verificar no es una tarea administrativa que el doctor hace para Amedi: es lo que lo distingue frente a quien lo está eligiendo.

07 cuando los nombres no calzan

El documento manda, pero pide permiso.

El proveedor nos devuelve el nombre y el número leídos de la cédula. Casi siempre difieren de lo que el doctor escribió al registrarse —acentos, un segundo nombre, el orden de los apellidos—. Tratar todas las diferencias igual sería absurdo: una es ortografía, otra es otra persona.

cosmético se resuelve solo, con su visto bueno
escribióCarlos Carrasquero
su cédulaCarlos Horacio Carrasquero Quintini
Identidad verificada
Tu cédula trae tu nombre completo. ¿Lo usamos en tu perfil?
Usar el de mi cédula Dejar el mío

Se verifica igual: la identidad ya está probada. Lo único abierto es cómo quiere aparecer.

sustantivo escala a una persona
escribióMaría Fernanda Rojas
su cédulaPedro Antonio Molina Sáez
Estamos revisando tu caso
Alguien del equipo lo revisa en menos de 24 horas. Te escribimos por correo.

Cae en la cola de revisión que ya existe en el admin. La interfaz del doctor no acusa ni insinúa fraude: describe lo que pasa y quién lo resuelve.

08 lenguaje de interacción

Los botones de este flujo dicen qué pasa.

Un flujo de verificación pide cosas incómodas —la cédula, la cara— y cualquier ambigüedad se lee como riesgo. Las etiquetas nombran la consecuencia, nunca la mecánica: «Empezar» y no «Subir documento», «Tengo mi cédula a mano» y no «Continuar».

sobre noche · dentro del rito

Tengo mi cédula a mano Ahora no

La menta es el único color que llega a AA sobre noche con texto oscuro encima. La salida siempre está presente y siempre es discreta.

sobre claro · dentro del hub

Empezar Ver mis datos Publicar

El petroleo es la única acción primaria. El bloqueado conserva su candado y su etiqueta: se ve qué se gana, no solo que está apagado.

Reglas que se aplican a todo el flujo

  • Nada en mayúsculas. Ni badges, ni etiquetas, ni encabezados. El tono de Amedi es editorial y calmo — un flujo de verificación gritado se siente policial.
  • Área táctil de 44px como piso en todo control, porque la mitad de estos doctores verifican desde el teléfono.
  • Cifras siempre tabulares — la cédula, los tiempos, el progreso. Los números que bailan al actualizarse se leen como error.
  • La transición de estado dura --duration-base con --ease-out: se nota que algo cambió sin robar la atención de lo que el doctor estaba haciendo.
  • El pulso de «en revisión» se detiene con prefers-reduced-motion, y en su lugar el estado se comunica solo con color y copy.
  • Foco visible siempre, anillo en --menta-deep: este flujo se puede completar entero con teclado.
09 qué se construye

Todo esto ya se probó con una verificación real.

comprobado en vivo · 3 de agosto de 2026

Se corrió una verificación completa contra la cuenta real de Amedi y llegaron 10 eventos firmados. De ahí salieron tres certezas que normalmente costarían semanas de descubrir: el plan gratuito alcanza; el veredicto viene dentro del webhook, sin necesidad de llamar de vuelta a la API; y los datos del documento llegan inline — que es lo único que hace posible el cruce de nombres de la sección 07.

Backend

  • Guard de firma x-signature = HMAC-SHA256(rawBody) en hex, sin prefijo. El proveedor no lo documenta: se descubrió probando, y se confirmó en los 10 eventos.
  • provider y externalId en DoctorVerification, para que licencia e identidad convivan en el ciclo de vida que ya existe — reintentos, revisión manual, rechazo.
  • Doctor.isVerified pasa a ser un gate derivado: verde solo cuando ambos proveedores están en verde. Hoy es un booleano suelto que nadie sabe qué significa.
  • Comparador de nombres que distingue lo cosmético de lo sustantivo — normaliza acentos, orden y nombres intermedios antes de decidir si escala.

Consultorio

  • El rito en su propia ruta, con el botón del SDK cargado ahí y metadata con el doctorId. Sin ese metadata no hay forma de saber de quién es la verificación — se comprobó en el spike.
  • La card de identidad con sus siete estados, y la línea de estado de SACS debajo.
  • La card se actualiza sola al llegar el veredicto, sin que el doctor recargue.
  • El botón de publicar toma su estado del gate derivado, no de un booleano suelto.

Deudas que esta pieza señala pero no resuelve

  • El endpoint del spike se borra, no se evoluciona: no valida firma, no persiste y vuelca datos personales al log.
  • La copy actual del banner de SACS promete identidad. Se corrige incluso si esta propuesta no se construye completa.
  • Falta decidir qué pasa con los doctores ya registrados y publicados antes de que exista la verificación de identidad.
  • El proveedor guarda las imágenes del documento; queda pendiente revisar ese tratamiento de datos y reflejarlo en la política de privacidad.