> ## 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 Return URL

> Guía para regresar al servicio del cliente con la Return URL configurada y los parámetros de Campos Dinámicos al completar el KYC o al acceder a una página de error.

## 1. Configurar la Opción de Return URL en el Panel

El panel le permite establecer los valores de las claves de parámetro. Después de que el proceso KYC esté completo y el remitente seleccione el botón "Aceptar" o espere 5 segundos, la página redirigirá a los parámetros de Campos Dinámicos con la Return URL. A partir de la actualización de 2026-04, **incluso cuando el usuario accede a una página de error**, puede regresar a la Return URL configurada; en ese caso, el parámetro `errorCode` se transmite junto con la URL para que el cliente pueda identificar el motivo del bloqueo.

<img src="https://mintcdn.com/argosidentity/XDoaaMLWTIfazlLD/images/return_url_en.png?fit=max&auto=format&n=XDoaaMLWTIfazlLD&q=85&s=47560328db347bfa11f54624146150b8" alt="Return Url En Pn" width="710" height="389" data-path="images/return_url_en.png" />

## 2. Soporte para parámetros en Campos Dinámicos

### 2-1. Parámetros Clave de Query String

<ResponseField name="userid" type="string">
  El valor de user ID, que está conectado al envío
</ResponseField>

<ResponseField name="cf1" type="string">
  Campo personalizado 1 opcionalmente agregado durante el envío
</ResponseField>

<ResponseField name="cf2" type="string">
  Campo personalizado 2 opcionalmente agregado durante el envío
</ResponseField>

<ResponseField name="cf3" type="string">
  Campo personalizado 3 opcionalmente agregado durante el envío
</ResponseField>

<ResponseField name="email" type="string">
  El valor de email, que está conectado al envío
</ResponseField>

<ResponseField name="submissionId" type="string">
  El Submission ID del envío
</ResponseField>

<ResponseField name="kycStatus" type="string">
  Resultado KYC. Siguiendo este nombre de parámetro es camelCase (sensible a mayúsculas y minúsculas). Basado en el resultado, devuelve `approved`, `pending`, o `rejected`.
</ResponseField>

<ResponseField name="errorCode" type="string">
  **(Nuevo en 2026-04)** Código de error transmitido cuando el usuario accede a una página de error. Ejemplos: `DE-20000` (fallo en Device Verification), `DE-30000` (detección de Fingerprint), `DE-40000` (exceso de duplicados de dispositivo), `TK-10001` (token expirado). No se transmite en caso de finalización normal. Consulte [Códigos de error y páginas de error](/es/idcheck/reference_tables/Error-codes-and-pages) para la lista completa de códigos.
</ResponseField>

### 2-2. Volver a Return URL desde página de error

Cuando un usuario es bloqueado en la pre-verificación (Device Info, VPN/Proxy, etc.) o en la validación de token y accede a una página de error, si en el Dashboard se ha marcado **Error Code (`errorCode`)** en los Campos Dinámicos, el usuario puede regresar al servicio del cliente mediante el botón de Return URL. El siguiente es un ejemplo de la URL que se transmite en ese caso:

```
https://yourapp.com/verification-complete?kycStatus=rejected&errorCode=DE-20000
```

<Info>
  **Procesamiento condicional basado en errorCode**

  En el sistema del cliente, puede utilizar el valor `errorCode` para proporcionar al usuario las instrucciones adecuadas de seguimiento (ej.: recomendar el uso de un dispositivo móvil, indicar cómo volver a emitir el token, etc.).
</Info>

### 2-3. Cifrado aplicado

El cifrado se habilita cuando el parámetro "encrypted" se incluye en la Return URL final. AES-256-ECB es necesario para descifrar el valor. Por favor consulte [esta sección de la guía](https://developers.argosidentity.com/getting-started/es/encrypt-and-decrypt-data/overview#3-3-api-data-decryption-aes-256-ecb) para obtener más información.

Al utilizar esta guía, puede devolver efectivamente la URL con Query String en ID check para optimizar su proceso KYC y mejorar la experiencia del usuario.