> ## Documentation Index > Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt > Use this file to discover all available pages before exploring further. # Guía de Cadena de Consulta y Token > Una guía completa sobre las opciones de Cadena de Consulta y Token ID para Liveform. Estas opciones permiten características como la transmisión de información adicional, la prevención de envíos duplicados y la identificación de usuarios. Explore herramientas esenciales para optimizar su proceso de ID Check. ## 1. Opciones Personalizables de Cadena de Consulta Las opciones de Cadena de Consulta disponibles en Liveform y API le permiten enviar información adicional y personalizar el proceso KYC. ## 2. Estructura Básica de la URL * **URL Base del Formulario**: `https://form.argosidentity.com?pid={project_Id}` * **URL con Cadena de Consulta**: `https://form.argosidentity.com?pid={project_Id}&blacklistCountries=false` Puede utilizar la [Herramienta de Cifrado/Descifrado de Cadena de Consulta](/dashboard/es/project-management/project-settings/project-info#query-string-encryptiondecryption-tool) en el panel para generar URLs cifradas y probar los parámetros de cadena de consulta descritos a continuación. ## 3. Parámetros Clave de Cadena de Consulta ### 3-0. ¿Qué parámetro usar en cada situación? Tabla rápida por objetivo. Para el comportamiento exacto, restricciones y requisitos de cifrado, consulte la tabla detallada y los Accordions a continuación. | Lo que quiere hacer | Parámetro(s) a usar | | ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------- | | Identificar al usuario / envío y pasar metadatos adicionales | `email`, `userid`, `sid`, `cf1`, `cf2`, `cf3` | | Restringir qué tipos de documentos de identidad se aceptan | `allowedIdTypes`, `allowedCountries` | | Restringir qué campos extraídos por OCR se muestran / confirman | `allowedDocumentFields` | | Omitir un paso — selección de país | `selectedIssuingCountry`, `allowedCountries` (con un único país) | | Omitir un paso — selección de tipo de identificación | `selectedIdType` | | Omitir un paso — entrada de información del usuario en Knowledge-Based | `knowledgeField: 'skip'` | | Elegir qué datos solicita el paso Knowledge-Based | `knowledgeField` | | Prellenar valores en los campos de Knowledge-Based | `knowledgePrefill` | | Añadir verificación de identidad además del documento + selfie (p. ej. SMS) | `auxidField` | | Excepción de política de duplicados / edad / lista negra para un envío puntual | `rejectDuplicateUser`, `approvePeriod`, `rejectPeriod`, `ageLimit`, `blacklistCountries` | | Excluir campos específicos de la respuesta (aplicar una projection) | `projectionId`, `projectionName` | | Personalizar los colores de la interfaz del Liveform | `mainColor`, `innerColor` | | Forzar una caducidad de acceso al enlace (p. ej. flujo de tutor con límite) | `startValidUntil` | | Enlace de un solo uso — evitar compartir / reutilizar URL | `tokenId` (vea [Sección 4. Opciones de ID de Token](#4-opciones-de-id-de-token)) | | Parámetro | ID Document | Knowledge-Based | Descripción | | ------------------------- | ----------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `blacklistCountries` | Sí | Sí | Desactiva las restricciones de países en la lista negra para el envío específico (`false` solo). | | `approvePeriod` | Sí | No | Desactiva el período de prevención de envíos duplicados aprobados (`false` solo). | | `rejectPeriod` | Sí | No | Desactiva el período de prevención de envíos duplicados rechazados (`false` solo). | | `ageLimit` | Sí | Sí | Desactiva la restricción de edad para el envío específico (`false` solo). | | `rejectDuplicateUser` | Sí | Sí | Habilita/deshabilita la prevención de envíos duplicados (`verdadero` o `false` aceptado). - En el Envío basado en Conocimientos, funciona para contener la información de Nombre, Género, Fecha de Nacimiento y Nacionalidad. | | `email` | Sí | Sí | Dirección de correo electrónico del usuario. | | `userid` | Sí | Sí | Identificador único personalizado para el usuario. | | `pid` | Sí | Sí | Identificador único para cada proyecto. | | `sid` | Sí | Sí | Identificador único para cada envío. | | `cf1` | Sí | Sí | Campo de opción personalizada #1. | | `cf2` | Sí | Sí | Campo de opción personalizada #2. | | `cf3` | Sí | Sí | Campo de opción personalizada #3. | | `auxidField` | Sí | No | Debe cifrarse. Se utiliza cuando se requiere verificación auxiliar de información de identidad además de documentos de identidad y fotos de selfie. Actualmente se implementa phoneNumber, vea los detalles a continuación. No puede utilizarse simultáneamente con selectedIssuingCountry y selectedIdType. Esto cambiará mediante actualizaciones futuras. | | `allowedCountries` | Sí | Sí | Debe cifrarse. `allowedCountries` solo puede establecerse utilizando la opción de cifrado y no puede especificarse directamente. Por ejemplo, si se proporciona el valor cifrado `{'allowedCountries': 'USA,KOR'}`, solo se permitirán Estados Unidos (USA) y Corea del Sur (KOR). | | `allowedIdTypes` | Sí | No | Debe cifrarse. Puede establecerse para mostrar el tipo de tarjeta de identidad. Consulte el valor debajo de cada parámetro. | | `allowedDocumentFields` | Sí | No | Debe cifrarse. Puede establecerse para mostrar los campos disponibles. Consulte el valor debajo de cada parámetro. | | `projectionId` | Sí | Sí | Debe cifrarse. Puede aplicar una proyección para excluir campos. ProjectionName no puede utilizarse junto con esto. | | `projectionName` | Sí | Sí | Debe cifrarse. Puede aplicar una proyección para excluir campos. ProjectionId no puede utilizarse junto con esto. | | `selectedIssuingCountry ` | Sí | Sí | Debe cifrarse. Al seleccionarlo, el usuario puede omitir la página de selección de país. `allowedCountries` y `selectedIdType` pueden utilizarse juntos. Además, cuando `allowedCountries` se selecciona, los países que no están en `allowedCountries` no pueden utilizarse. Los mismos países en `blacklistCountries` no pueden utilizarse juntos. | | `selectedIdType` | Sí | No | Debe cifrarse. Al seleccionarlo, el usuario puede omitir la página de selección de tipo de identificación. Debe utilizarse con `selectedIssuingCountry`. Si `selectedIdType` se utiliza solo, causará un error. Además, utilizar el **modo Universal** y `selectedIdType` juntos causará un error; caso excepcional: tenga en cuenta que si el `issuingCountry` es KOR y el **modo Universal** está activado, se mostrará la página de selección de tipo de identificación a los usuarios. | | `mainColor` | Sí | Sí | Debe cifrarse. Establece el color principal de los botones de CTA y los elementos de la interfaz de usuario de acción positiva. El valor debe ser un código de color hexadecimal de 6 dígitos con el prefijo `#` (por ejemplo, `#AEFF00`). Consulte [Tema Personalizado](/es/idcheck/notices/2026-03-update#custom-theme) y [Personalización de Liveform](/dashboard/es/project-management/user-experience/liveform-customization#custom-theme-query-string). | | `startValidUntil` | Sí | Sí | Debe cifrarse obligatoriamente. **Antes de que el usuario inicie la autenticación**, especifica la hora de caducidad en formato ISO 8601 UTC+0 (ej: `2026-04-30T15:00:00Z`). Si el usuario accede cuando la hora ya ha pasado, se bloquea el inicio de autenticación y redirige a la página de error PV-40018. Se usa cuando necesita forzar el acceso dentro de cierto tiempo después de enviar el enlace, como autenticación de guardián para menores. | | `innerColor` | Sí | Sí | Debe cifrarse. Establece el color del texto/icono interno dentro de los botones de CTA y los elementos de acción. El valor debe ser un código de color hexadecimal de 6 dígitos con el prefijo `#` (por ejemplo, `#FFFFFF`). Consulte [Tema Personalizado](/es/idcheck/notices/2026-03-update#custom-theme) y [Personalización de Liveform](/dashboard/es/project-management/user-experience/liveform-customization#custom-theme-query-string). | **Funcionamiento de `startValidUntil` (2026-04)** * **Prioridad de validación**: Se evalúa **antes que** todas las demás validaciones como validación de token ID. Si se confirma la caducidad de inicio, no se ejecutan validaciones posteriores. * **Cifrado obligatorio**: No puede usarse en texto plano, debe incluirse en el parámetro `encrypted` junto con otras opciones de cifrado. * **Zona horaria**: Siempre se interpreta según UTC+0. Ej: `{"startValidUntil":"2026-04-30T15:00:00Z"}`. * **Pipelines soportados**: ID Document, Knowledge-based. * **Comportamiento al caducar**: Redirige a la página de error `/error-page/expired-start-valid-until` (código de error `PV-40018`) con el mensaje "The verification link has expired. Please try again with a new link." para el usuario. | Parámetro | ID Document | Knowledge-Based | Descripción | | ------------------ | ----------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `knowledgeField` | No | Sí | Debe cifrarse. Establecer campos visibles de los campos admitidos. Consulte el valor debajo de cada parámetro. | | `knowledgePrefill` | No | Sí | Debe cifrarse. Rellenar el valor con antelación. Consulte el valor debajo de cada parámetro. | | `skip` | No | Sí | Debe cifrarse. Cuando se selecciona, los usuarios pueden omitir el proceso de recopilación de información de usuario en Knowledge-Based y proceder al siguiente paso donde toman una foto de selfie según lo configurado en el panel. No puede utilizarse con otras opciones de knowledgeField. | ### 3 - Común * A continuación se muestra un ejemplo de ID Check con y sin un parámetro de consulta de correo electrónico.
* **Ejemplo:** * `https://form.argosidentity.com?pid={project_Id}&email={type_your_email_address}` dashboard * Genere un ID de usuario único para la identificación del remitente de KYC durante las llamadas a la API. * Agregue hasta tres campos personalizados (`cf1`, `cf2`, `cf3`) para transmitir información adicional.
* **Ejemplo:** * `https://form.argosidentity.com?pid={project_Id}&userid={type_userid}&cf1={type_cf1}&cf2={type_cf2}&cf3={type_cf3}` Tenga en cuenta que esto es aplicable tanto en ID Document como en Knowledge-Based ### 3 - ID check Restringe los tipos de documentos de identidad que se aceptan. Seleccione los valores que necesita y combínelos con comas. * `passport` — Pasaporte * `drivers_license` — Licencia de conducir * `government_id` — Documento de identidad emitido por el gobierno * `residence_permit` — Permiso de residencia * `vehicle_registration_certificate` — Certificado de registro de vehículo * `visa` — Visa * `pancard` — Tarjeta PAN de la India * `aadhaar` — Tarjeta Aadhaar de la India * `foreign_registrator` — Tarjeta de registro de residente extranjero * `identification_card` — Tarjeta de identificación general * e.g. `{'allowedIdTypes': 'passport,government_id,drivers_license'}` Restringe qué campos extraídos por OCR se muestran y son confirmados por el usuario. * `gender` — Género * `nationality` — Nacionalidad * `expiry_date` — Fecha de caducidad * `number` — Número de documento (mismo campo que el número de pasaporte en el caso del pasaporte) * `issue_date` — Fecha de emisión * `id_number` — Número único del documento de identidad * `serial_number` — Número de serie * `name` — Nombre * `date_of_birth` — Fecha de nacimiento * `curp_number` — Número CURP (solo disponible para la tarjeta de identidad mexicana) * `version` — Versión de la tarjeta (solo disponible para la licencia de conducir de Nueva Zelanda) * `type_of_permit` — Tipo de permiso (solo disponible para la Tarjeta de Registro de Extranjeros en Corea del Sur) * e.g. `{'allowedDocumentFields': 'gender,name,date_of_birth,issue_date'}` Preseleccione un único tipo de documento para que el usuario omita el paso de selección de tipo de identificación. * `passport` — Pasaporte * `drivers_license` — Licencia de conducir * `government_id` — Documento de identidad emitido por el gobierno * `residence_permit` — Permiso de residencia * `vehicle_registration_certificate` — Certificado de registro de vehículo * `visa` — Visa * `pancard` — Tarjeta PAN de la India * `aadhaar` — Tarjeta Aadhaar de la India * `identification_card` — Tarjeta de identificación general * e.g. `{'selectedIdType': 'passport'}` * **allowedIdTypes:** * `https://form.argosidentity.com?pid={project_Id}&encrypted={'allowedIdTypes': 'passport,government_id,drivers_license'}` * **allowedDocumentFields:** * `https://form.argosidentity.com?pid={project_Id}&encrypted={'allowedDocumentFields': 'gender,name,date_of_birth,issue_date'}` * **selectedIdType:** * `https://form.argosidentity.com?pid={project_Id}&encrypted={'selectedIdType': 'passport'}` * nota que dentro de cifrado debería estar cifrado; la consulta anterior es solo como ejemplo * Cada **nombre de campo distingue mayúsculas y minúsculas**. * Cada valor de parámetro **no debe contener un espacio**. * ❌ Ejemplo No Cumpliente:
`{'allowedDocumentFields': 'gender, name,date_of_birth, issue_date'}` * La opción correcta no debe tener espacios después de las comas, como `{'allowedDocumentFields': 'gender,name,date_of_birth,issue_date'}` Para información de identidad que requiere verificación además de documentos de identidad e información de selfie (por ejemplo, números de teléfono), puede recopilar y verificar utilizando la opción auxidField.
Especifique información de identidad auxiliar a recopilar y verificar además del documento de identidad y la selfie. * `phoneNumber` — Verificación de número de teléfono basada en SMS e.g. `{'auxidField': 'phoneNumber'}` **Ejemplo:** * `https://form.argosidentity.com?pid={project_Id}&encrypted={'auxidField': 'phoneNumber'}` * nota que dentro de cifrado debería estar cifrado; la consulta anterior es solo como ejemplo **Precaución**: * Debe cifrarse para su uso. * Los valores de parámetro anteriores distinguen mayúsculas y minúsculas. Por ejemplo, si escribe phonenumber, no funcionará. Debe escribir phoneNumber como se muestra arriba. * No puede utilizarse simultáneamente con selectedIssuingCountry y selectedIdType. Esto cambiará mediante actualizaciones futuras. * **Actualmente 91 países no admiten la verificación por SMS.** **Verificar Países No Compatibles** Para ver la lista completa de los 91 países donde la función de verificación por SMS del campo auxidField phoneNumber no es compatible, consulte el enlace siguiente. 📋 [**Lista de Países No Compatibles con la Verificación por SMS**](/es/idcheck/getting-started/liveform-url/auxidfield-unsupported-countries) ### 3 - Knowledge-Based Elija qué datos debe introducir el usuario durante el paso Knowledge-Based. * `name` — Nombre completo * `gender` — Género * `birthDate` — Fecha de nacimiento * `nationality` — Nacionalidad * `SSN` — Número de Seguro Social (solo EE. UU. admitido) * `address` — Dirección * `phoneNumber` — Número de teléfono * `skip` — Omitir todo el paso de recopilación de información del usuario (debe usarse solo; no puede combinarse con otros valores de knowledgeField) e.g. `{'knowledgeField': 'gender,nationality,name'}`
e.g. `{'knowledgeField': 'skip'}`
Los valores de parámetro anteriores distinguen mayúsculas y minúsculas. Por ejemplo, birthdate no funcionará. Debe escribir birthDate como se muestra arriba. Prellena los campos de entrada de Knowledge-Based con valores predefinidos. * `name` — Nombre del usuario a prellenar * `birthDate` — Fecha de nacimiento (formato `YYYY-MM-DD` requerido) * `gender` — Género (`male` o `female`) * `nationality` — Nacionalidad (código de país ISO Alpha-3) * `SSN` — Número de Seguro Social (con guiones `-`) * `address` — Dirección (palabra clave que pueda buscarse en Google Maps) * `phoneNumber` — Número de teléfono (código de país incluido, sin guiones) e.g. `{'knowledgePrefill': 'gender=male,birthdate=1990-01-01,SSN=123-12-0001,address=Washington D.C.,phoneNumber=+15555551234'}` Para `address`, utilice palabras clave que puedan buscarse en Google Maps. El valor prellenado aparecerá en el campo de búsqueda de dirección. * `https://form.argosidentity.comknowledge?pid={project_Id}&encrypted={'knowledgeField': 'gender,nationality,name'}` * `https://form.argosidentity.comknowledge?pid={project_Id}&encrypted={'knowledgePrefill': 'gender=male,birthdate=1990-01-01,SSN=123-12-0001,address=Washington D.C.,phoneNumber=+15555551234'}` * nota que dentro de cifrado debería estar cifrado; la consulta anterior es solo como ejemplo * Cada nombre de campo distingue mayúsculas y minúsculas. * Cada valor de parámetro no debe contener un espacio. * ❌ Ejemplo No Cumpliente:
`{'knowledgeField': 'gender, nationality, name'}` * La opción correcta no debe tener espacios después de las comas, como:
`{'knowledgeField': 'gender,nationality,name'}`
En `Knowledge-Based`, cuando ingresa `skip`, los usuarios pueden omitir el proceso de recopilación de información de usuario y proceder al siguiente paso.
**Cuando está configurado, las pantallas de selección de país y entrada de información de usuario se omitirán.**
e.g. `{'knowledgeField': 'skip'}` CASO DE USO: cuando desea realizar autenticación basada en selfie sin recopilar información adicional, puede implementarlo habilitando la opción de proceso de selfie en el panel y estableciendo ‘skip’ en ‘knowledgeField’. **Precaución:** * No puede utilizarse con otras opciones de knowledgeField además de skip. * Sin embargo, puede utilizarse junto con el correo electrónico proporcionado por el administrador, userid, cf1, cf2, y cf3. * Debe cifrarse para su uso. **Ejemplo:** * `https://form.argosidentity.comknowledge?pid={project_Id}&encrypted={'knowledgeField': 'skip'}` * `https://form.argosidentity.comknowledge?pid={project_Id}&encrypted={'email': 'example@example.com','userid': 'userid', 'cf1': 'cf1','knowledgeField': 'skip'}` * nota que dentro de cifrado debería estar cifrado; la consulta anterior es solo como ejemplo En Knowledge-Based, si `allowedCountries` establece una nacionalidad.\ e.g. `{'allowedCountries': 'USA'}` El formulario omite la página de selección de país.
**Ejemplo:** * `https://form.argosidentity.comknowledge?pid={project_Id}&encrypted={'allowedCountries': 'USA'}` * nota que dentro de cifrado debería estar cifrado; la consulta anterior es solo como ejemplo Todos los valores de Cadena de Consulta deben estar codificados en URL. ## 4. Opciones de ID de Token El `tokenId` es una cadena utilizada para los envíos de Liveform en modo privado. **Propósito**: Evitar el uso compartido o duplicado de la misma URL. La validación falla (ocurre un error) bajo las siguientes condiciones: 1. **Vencimiento por Tiempo**: Han transcurrido más de 3 minutos desde el primer uso. 2. **Envío Válido Existente**: Existe un envío con un estado de KYC determinado (aprobado, rechazado, pendiente). **Precaución**: * Si las condiciones anteriores no se cumplen, varios usuarios pueden proceder con el mismo ID de token simultáneamente. * [Webhook](/es/idcheck/webhooks/overview) * **API de Obtención de Envío** (recuperación única utilizando `submission_id`) * Descargar CSV de Envío desde el panel * **URL Base del Formulario**: `https://form.argosidentity.com?pid={project_Id}` * **URL con ID de Token**: `https://form.argosidentity.com?pid={project_Id}&token={tokenId}` * **con Cifrado habilitado**: `https://form.argosidentity.com?pid={project_Id}&encrypted={token={tokenId}}` ## 5. Solo Cifrado Puede habilitar la opción solo cifrado en el panel. Después de la activación, los parámetros de consulta de URL solo permiten `pid`(id del proyecto), `encrypted` y `lang`(idioma), otros parámetros no están permitidos. Solo Cifrado En Pn * `https://form.argosidentity.com?pid={project_Id}&encrypted={encrypted_option}&lang=en`(O) * `https://form.argosidentity.com?pid={project_Id}&encrypted={encrypted_option}&email=your_email_address@argosidentity.com`(X) email no es un parámetro permitido, por lo que se deniega el acceso. Al utilizar esta guía, puede aprovechar eficazmente las opciones de Cadena de Consulta y ID de Token en ID check para optimizar su proceso KYC y mejorar la experiencia del usuario.