pide la prueba
Su solicitud solicita la prueba requerida para una acción, por ejemplo, ser mayor de 18 años o verificado por humanos.
VERIFICAR PARA DESARROLLADORES
Conecte su sitio, copie su ID de Checkify Pass, elija lo que desea verificar y coloque Checkify en inicio de sesión, pago, comentarios, formularios de contacto o su propio flujo personalizado.
MODELO DE INTEGRACIÓN
Su solicitud solicita una prueba. Checkify ejecuta el recorrido del cliente. Recibes un resultado y decides qué sucede a continuación.
Su solicitud solicita la prueba requerida para una acción, por ejemplo, ser mayor de 18 años o verificado por humanos.
Checkify determina si existen pruebas suficientes o si el cliente necesita completar una verificación adicional.
Su servidor confirma el resultado y permite, bloquea o continúa la acción protegida.
API REAL
Después de que el cliente completa una sesión Pass, su backend verifica request_id con una clave API del sitio. Nunca coloque la clave API del sitio en el código del navegador.
Pedido
POST /v1/qr/results/verify
Authorization: Bearer YOUR_SITE_API_KEY
Content-Type: application/json
{
"request_id": "56a57761-ff5b-42f0-9c97-6c13e223e017",
"required_claims": ["age_over_18"],
"consume": true
}
Respuesta
{
"success": true,
"status": "completed",
"approved_claims": {
"age_over_18": true
}
}
El navegador o complemento almacena un request_id (a menudo como checkify_token). Su servidor es la autoridad: confirme los reclamos_aprobados antes de permitir la acción.
LO QUE PUEDES SOLICITAR
Cambie el tipo de solicitud o las reclamaciones requeridas para cada viaje, sin reconstruir la infraestructura de verificación.
Solicite un umbral de edad como más de 13, 16, 18 o 25 años.
age_over_18Establezca que una persona real esté presente para formularios, inicio de sesión y controles de abuso.
human_verifiedSolicite el nivel de seguridad adecuado al riesgo, desde básico hasta alto.
basic → highAssuranceLos niveles de garantía y las opciones de evidencia exacta dependen del recorrido, el dispositivo y la política configurada. Consulte la guía de verificación del servidor para conocer los nombres de los reclamos.
CÓMO SE INTEGRA
Comience con la ruta que coincida con su pila. Todas las rutas de producción utilizan el mismo modelo de prueba.
WordPress, WooCommerce y Joomla/J2Commerce para CMS y puertas de pago comunes.
Guía de WordPress →CDN embed y bindForm para sitios web personalizados. Inicia sesiones de Pass y escribe el token en su formulario.
Insertar documentos →Confirme los resultados con POST /v1/qr/results/verify y una clave API del sitio (csk_).
Verificar servidor →Viajes al lugar y de dispositivo a dispositivo utilizando Pass y transferencia QR.
Guía del personal físico →Shopify y Wix están en lista de espera/próximamente y no figuran como integraciones de producción en vivo aquí.
Cartas credenciales
Checkify utiliza dos credenciales diferentes. El error de integración más común consiste en usar la incorrecta en el lugar equivocado.
Browser embed, WordPress, Joomla — frontend only
Backend verify API — server only, never in JavaScript
ENTREGA DE RESULTADOS
Para flujos de pago y sitios web estándar, verifique request_id en su servidor cuando se envíe la acción protegida. El sondeo de estado opcional está disponible para interfaces personalizadas.
Su página o complemento inicia una solicitud de Checkify Pass vinculada a su sitio.
El cliente verifica o aprueba en la aplicación Checkify.
Llame al punto final de verificación, verifique los reclamos_aprobados y luego permita o bloquee.
Actualmente, las integraciones estándar no requieren webhooks de verificación de uso general. Los webhooks salientes de los socios (por ejemplo, GoHighLevel) se configuran por separado en el panel empresarial.
DOCUMENTACIÓN
Utilice estas guías para conocer la profundidad de la implementación. Esta página se centra en el modelo de integración.
Incruste un pase y vincule un formulario para su primera acción protegida.
Abrir inicio rápido →Puntos finales utilizados por integraciones públicas, incluida la verificación y el estado.
Abrir documentos API →atributos de verificación de datos, opciones de bindForm y tipos de solicitud.
Abrir documentos para insertar →Claves de API del sitio, reclamaciones_requeridas, consumo y resultado_firmado.
Abrir guía del servidor →Primero agregue Checkify a un recorrido (edad, persona o identidad) y luego amplíelo a medida que crezcan las necesidades de su producto.