De cero a tu primera verificación en cuatro pasos
VerifyMX es self-serve: no necesitas llamada con ventas para empezar a integrar. Crea una cuenta, copia tu API key, configura un workflow y lanza tu primera verificación contra api.verifymx.xyz. Esta guía te lleva de cero a producción en menos de cinco minutos.
Crea tu cuenta
El formulario te pide nombre de empresa, correo de trabajo y contraseña. Aceptas términos + aviso de privacidad. La cuenta queda activa al instante — sin tarjeta, sin esperar aprobación, sin onboarding sales-led.
Copia tu API key
Inmediatamente después de registrarte, te mostramos por única vez tu API key (con prefijo vmx_…) y el ID de tu organización. Cópialos a tu gestor de secretos o variables de entorno. Si pierdes la clave, generas otra en /dashboard/api-keys sin perder acceso a tu cuenta.
Variables que verás
# Lo que la pantalla te muestra después del registro ORG_ID=00000000-0000-0000-0000-000000000000 # 36 caracteres API_KEY=vmx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Crea tu primer workflow
Un workflow es la secuencia ordenada de pasos que cada verificación va a seguir. El más típico es OCR de documento + comparación facial — suficiente para la mayoría de los flujos KYC. Puedes crear workflows distintos para diferentes productos o niveles de riesgo.
Intercambio token + crear workflow
# Intercambia API key por bearer token (OAuth client_credentials)
TOKEN=$(curl -s -X POST https://api.verifymx.xyz/v1/auth/token \
-H "Content-Type: application/json" \
-d "{\"grant_type\":\"client_credentials\",
\"client_id\":\"$ORG_ID\",
\"client_secret\":\"$API_KEY\"}" \
| jq -r '.access_token')
# Crea el workflow
curl -s -X POST https://api.verifymx.xyz/v1/workflows \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "INE + selfie",
"steps": [
{ "type": "DOCUMENT_OCR", "order": 0 },
{ "type": "FACE_MATCH", "order": 1 }
]
}'La respuesta incluye el workflow.id — guárdalo para el paso 4.
Lanza tu primera verificación
Con el workflowId en mano, una llamada a POST /v1/verifications crea la verificación y devuelve una URL única donde tu usuario completa la captura (documento + selfie). Cuando termina, recibes un webhook firmado en la URL que hayas configurado.
Crear la verificación
curl -s -X POST https://api.verifymx.xyz/v1/verifications \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"workflowId": "<workflow.id del paso 3>",
"externalId": "user-12345"
}'
# Respuesta:
# {
# "verification": {
# "id": "ver_...",
# "captureUrl": "https://verify.verifymx.xyz/v/...",
# "status": "PENDING"
# }
# }Eso es todo. Tu primer cliente abre captureUrl, completa el flujo, y tu webhook recibe el resultado. La verificación aparece en /dashboard/verifications en cuanto el usuario captura su documento.
Qué sigue después de la primera verificación
Cuando tu primer flujo funciona end-to-end, estos son los siguientes pasos típicos.
Configura tus webhooks
En
/dashboard/webhooksregistras URLs por evento (verification.completed, aml.match, etc.) — firmados HMAC-SHA256 con reintentos automáticos.Define más workflows
Un workflow ligero para perfiles de bajo riesgo (solo OCR), uno completo para mayor monto o regulación (OCR + biometría + AML + cumplimiento).
Invita a tu equipo
Tu equipo de operaciones, riesgo y compliance puede revisar verificaciones marcadas como dudosas directamente desde el panel — sin escribir código.
FAQ
Preguntas frecuentes sobre el primer integración
¿No encuentras tu pregunta? Escríbenos a soporte@verifymx.xyz y respondemos el mismo día hábil.
¿Cuánto tarda crear la cuenta?
Menos de 60 segundos. El formulario en /register pide nombre de empresa, correo de trabajo y contraseña. Aceptas términos y aviso de privacidad, y la cuenta queda activa de inmediato con plan Starter (100 verificaciones gratis al mes).
¿Tengo que hablar con ventas antes?
No. El plan Starter es 100% self-serve. Para planes Growth o Scale (volúmenes mayores, contratos a la medida, BYOC), te ponemos en contacto con un ingeniero de soluciones — pero solo cuando tú lo solicites.
¿La API es la misma para Starter y planes enterprise?
Sí. Los endpoints, autenticación, webhooks y modelos OCR son idénticos. La diferencia son límites de volumen, residencia de datos y SLA, no funcionalidad.
¿En qué lenguajes puedo integrar?
Cualquiera con cliente HTTP. La API es REST estándar con JSON, OAuth 2.0 client_credentials y webhooks firmados HMAC. Los SDKs nativos en Node.js y Web están en roadmap; mientras tanto curl, axios, fetch, requests, etc. funcionan idénticamente.
¿Qué pasa si pierdo mi API key?
Generas otra en /dashboard/api-keys sin perder el acceso. La clave original queda revocada cuando la elimines. Como buena práctica, rota las claves periódicamente y mantén una por servicio (onboarding, riesgo, soporte).
¿Necesito el endpoint sandbox para probar?
No tenemos sandbox separado por diseño — queremos que pruebes contra el mismo API que verás en producción. El plan Starter (100 verificaciones gratis al mes) sirve como sandbox extendido sin costo. Para probar webhooks sin tráfico real, /v1/webhooks/:id/test dispara un evento sintético.
¿Cómo continúo cuando ya tengo la primera verificación funcionando?
Define más workflows según tus productos, agrega webhooks para recibir resultados en tu backend automáticamente, e invita a tu equipo de operaciones al panel para revisar verificaciones marcadas como dudosas. Toda la API en /productos/api y la documentación completa estará en /docs cuando lo desplegüemos públicamente.
Reduce fraude sin afectar conversión. Empieza con 100 verificaciones gratis.
Sin tarjeta, sin compromiso. Una integración (API, SDK o widget), una factura CFDI, un equipo en español, control total de tu KYC.