Guía de Cadena de Consulta y Token

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: región US https://form.argosidentity.com?pid={project_Id}, región KR https://form-kr.argosidentity.com?pid={project_Id}
URL con Cadena de Consulta: https://form.argosidentity.com?pid={project_Id}&blacklistCountries=false

Las URL de Liveform de esta página corresponden a proyectos de la región US. Los proyectos de la región KR usan el host form-kr.argosidentity.com. Consulte Regiones para más detalles.

Puede utilizar la Herramienta de Cifrado/Descifrado de Cadena de Consulta en el panel para generar URLs cifradas y probar los parámetros de cadena de consulta descritos a continuación.

El complemento Face Auth usa una URL y un conjunto de parámetros distintos.Face Auth usa su propia URL de complemento con el formato https://form.argosidentity.com/face-auth?pid={faceAuth_projectId}, y sus parámetros — sid, authUserId, authCf1–authCf3, token — difieren de los de esta página. El cifrado también usa la clave API del proyecto FaceAuth.Tenga en cuenta además que Face Auth no se ejecuta sin cadena de consulta — pid por sí solo no permite entrar al flujo; se requiere un sid cifrado. lang se comporta igual que en Liveform y se envía en texto plano.

Definiciones de parámetros: Comenzar con FaceAuth
Códigos de error y mensajes al usuario en caso de fallo de validación: Validación y manejo de errores de Face Auth URL

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`
Establecer el idioma de visualización del Liveform	`lang`
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)

Mostrar Tabla de Parámetros de Cadena de Consulta para ID check y Knowledge-Based

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.
`lang`	Sí	Sí	Establece el idioma de visualización de Liveform. Use un código ISO 639-1 en minúsculas (por ejemplo, `en`, `ko`). No está sujeto a cifrado — envíelo en texto plano; sigue permitido en el modo solo cifrado. Si se omite, en móvil se usa el idioma del dispositivo y en PC el del navegador. Para la lista completa de idiomas admitidos, consulte Idiomas Soportados.
`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 y Personalización de Liveform.
`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 y Personalización de Liveform.

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.

Mostrar Tabla de Parámetros de Cadena de Consulta solo para Knowledge-Based

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

Mostrar Omisión de la escritura de Correo Electrónico en los Procesos

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}

Mostrar ID de Usuario Único y Campos Personalizados en ID check

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

Mostrar Valores de Parámetros en ID check

[ID document] Valores de Parámetros allowedIdTypes

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'}

[ID document] Valores de Parámetros allowedDocumentFields

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'}

[ID document] Valores de Parámetros selectedIdType

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'}

[ID document] Ejemplos

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'}

Mostrar Campo de Identidad Auxiliar en ID check

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.

[ID document] Valores de Parámetros 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 CompatiblesPara 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

3 - Knowledge-Based

Mostrar Valores de Parámetros en Knowledge-Based

[Knowledge-Based] Valores de Parámetros knowledgeField

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.

[Knowledge-Based] Valores de Parámetros knowledgePrefill

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.

[Knowledge-Based] Ejemplos

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'}

Mostrar Solo Selfie en Knowledge-Based

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

Mostrar Omisión para Seleccionar País en Knowledge-Based

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.

Mostrar 4-1. Validación de Token ID

La validación falla (ocurre un error) bajo las siguientes condiciones:

Vencimiento por Tiempo: Han transcurrido más de 3 minutos desde el primer uso.
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.

Mostrar 4-2. Métodos para Verificar el ID de Token

Webhook
API de Obtención de Envío (recuperación única utilizando submission_id)
Descargar CSV de Envío desde el panel

Mostrar 4-3. Estructura de URL para ID de Token

URL Base del Formulario: región US https://form.argosidentity.com?pid={project_Id}, región KR https://form-kr.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={encrypted} — encrypted lleva el JSON {"token": "{tokenId}"} cifrado y luego codificado para URL

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.

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.

Primeros Pasos

URL de Liveform

Seguridad

Guía del Desarrollador MCP

Guía de Cadena de Consulta y Token

1. Opciones Personalizables de Cadena de Consulta

2. Estructura Básica de la URL

3. Parámetros Clave de Cadena de Consulta

3-0. ¿Qué parámetro usar en cada situación?

3 - Común

3 - ID check

3 - Knowledge-Based

4. Opciones de ID de Token

5. Solo Cifrado

​1. Opciones Personalizables de Cadena de Consulta

​2. Estructura Básica de la URL

​3. Parámetros Clave de Cadena de Consulta

​3-0. ¿Qué parámetro usar en cada situación?

​3 - Común

​3 - ID check

​3 - Knowledge-Based

​4. Opciones de ID de Token

​5. Solo Cifrado

1. Opciones Personalizables de Cadena de Consulta

2. Estructura Básica de la URL

3. Parámetros Clave de Cadena de Consulta

3-0. ¿Qué parámetro usar en cada situación?

3 - Común

3 - ID check

3 - Knowledge-Based

4. Opciones de ID de Token

5. Solo Cifrado