> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# API Share Session: KYC reutilizable entre socios

> Con Didit, comparte sesiones KYC y KYB verificadas con socios de confianza mediante tokens temporales. Evita reverificar y reduce fricción y costos.

La API Share Session permite el **KYC y KYB reutilizables**: compartir de forma segura los datos de sesiones verificadas entre organizaciones asociadas de confianza. Funciona tanto con sesiones de Verificación de usuarios (KYC) como de Verificación de empresas (KYB). El token para compartir codifica el `session_kind`, de modo que la aplicación receptora reconstruye el mismo tipo de sesión al importarla.

## Endpoints

> [card] [Compartir sesión](https://docs.didit.me/es/sessions-api/share-session/share.md)
>
> `POST /v3/session/{sessionId}/share/`: genera un token para compartir con tiempo limitado para una sesión verificada.

> [card] [Importar sesión compartida](https://docs.didit.me/es/sessions-api/share-session/import.md)
>
> `POST /v3/session/import-shared/`: importa una sesión compartida por un socio mediante un token para compartir.

## Cómo funciona

**1. El socio A comparte una sesión**

Cuando un usuario completa la verificación en la plataforma del socio A, el socio A invoca **Compartir sesión** con el ID de la sesión y el ID de aplicación del socio de destino. Didit devuelve un `share_token` de duración limitada.

**2. El token para compartir se envía al socio B**

El socio A envía el `share_token` al socio B a través de su propio canal seguro (llamada a la API, webhook, etc.).

**3. El socio B importa la sesión**

El socio B invoca **Importar sesión compartida** con el `share_token`. Didit crea una copia de la sesión verificada en la cuenta del socio B con todos los datos de verificación.

## Requisitos

| Requisito | Detalles |
| - | - |
| **Estado de la sesión** | Solo se pueden compartir sesiones finalizadas (`"Approved"`, `"Declined"`, `"In Review"`) |
| **ID de aplicación del socio** | El ID de aplicación del socio de destino (se encuentra en la configuración de Business Console) |
| **TTL del token** | Configurable de 60 segundos a 86.400 segundos (24 horas). Valor predeterminado: 3.600 segundos (1 hora) |
| **Autenticación** | Ambos socios deben autenticarse con sus propias claves de API |

## Casos de uso

* **Banca → Fintech**: un usuario verificado por un banco puede acceder a una fintech asociada sin volver a verificarse
* **Marketplace → Proveedor de pagos**: los vendedores verificados en un marketplace pueden completar el onboarding con el proveedor de pagos al instante
* **Seguros → Salud**: compartir verificaciones entre socios de confianza de distintos sectores
* **Empresas de un mismo grupo**: compartir datos de verificación entre varias aplicaciones dentro de la misma organización

> [!NOTE]
>
> Obtén más información sobre la función KYC reutilizable en la [guía Compartir KYC mediante la API](https://docs.didit.me/es/core-technology/reusable-kyc/share-kyc-via-api.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.