> ## 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 reutilizável entre parceiros

> Partilhe sessões verificadas com parceiros de confiança via tokens de tempo limitado. Com a Didit, evite nova verificação, reduza atrito e custos.

A API Share Session permite partilhar com segurança dados de sessões verificadas entre organizações parceiras de confiança, para **KYC e KYB reutilizáveis**. Funciona tanto para sessões de Verificação de utilizadores (KYC) como de Verificação de empresas (KYB). O token de partilha codifica o `session_kind`, para que a aplicação recetora reconstrua o mesmo tipo ao importar.

## Endpoints

> [card] [Partilhar sessão](https://docs.didit.me/pt/sessions-api/share-session/share.md)
>
> `POST /v3/session/{sessionId}/share/` — Gera um token de partilha com validade limitada para uma sessão verificada.

> [card] [Importar sessão partilhada](https://docs.didit.me/pt/sessions-api/share-session/import.md)
>
> `POST /v3/session/import-shared/` — Importa uma sessão partilhada por um parceiro com um token de partilha.

## Como funciona

**1. O parceiro A partilha uma sessão**

Depois de um utilizador concluir a verificação na plataforma do parceiro A, o parceiro A chama **Partilhar sessão** com o ID da sessão e o ID da aplicação do parceiro de destino. A Didit devolve um `share_token` com validade limitada.

**2. O token de partilha é enviado ao parceiro B**

O parceiro A envia o `share_token` ao parceiro B através do seu próprio canal seguro (chamada à API, webhook, etc.).

**3. O parceiro B importa a sessão**

O parceiro B chama **Importar sessão partilhada** com o `share_token`. A Didit cria uma cópia da sessão verificada na conta do parceiro B, com todos os dados de verificação.

## Requisitos

| Requisito | Detalhes |
| - | - |
| **Estado da sessão** | Só podem ser partilhadas sessões concluídas (`"Approved"`, `"Declined"`, `"In Review"`) |
| **ID da aplicação do parceiro** | O ID da aplicação do parceiro de destino (encontrado nas definições da Business Console) |
| **TTL do token** | Configurável entre 60 segundos e 86 400 segundos (24 horas). Predefinido: 3 600 segundos (1 hora) |
| **Autenticação** | Ambos os parceiros têm de se autenticar com as suas próprias chaves de API |

## Casos de utilização

* **Banca → Fintech**: um utilizador verificado por um banco pode aceder a um parceiro fintech sem voltar a verificar a identidade
* **Marketplace → Prestador de pagamentos**: os vendedores verificados num marketplace podem fazer onboarding no prestador de pagamentos de forma imediata
* **Seguros → Saúde**: partilha de verificações entre setores, entre parceiros de confiança
* **Empresas do mesmo grupo**: partilha de dados de verificação entre várias aplicações da mesma organização

> [!NOTE]
>
> Saiba mais sobre a funcionalidade KYC reutilizável no guia [Partilhar KYC via API](https://docs.didit.me/pt/core-technology/reusable-kyc/share-kyc-via-api.md).


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