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

> KYC e KYB reutilizáveis da Didit: compartilhe sessões verificadas entre parceiros confiáveis com tokens temporários. Evite reverificação e custos.

A API Share Session permite o **KYC e KYB reutilizáveis**: o compartilhamento seguro de dados de sessões verificadas entre organizações parceiras de confiança. Funciona tanto para sessões de Verificação de usuários (KYC) quanto de Verificação de empresas (KYB). O token de compartilhamento codifica o `session_kind`, para que a aplicação que recebe a sessão reconstrua o mesmo tipo ao importá-la.

## Endpoints

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

> [card] [Importar sessão compartilhada](https://docs.didit.me/pt-br/sessions-api/share-session/import.md)
>
> `POST /v3/session/import-shared/`: importa uma sessão compartilhada por um parceiro usando um token de compartilhamento.

## Como funciona

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

Depois que um usuário conclui a verificação na plataforma do parceiro A, o parceiro A chama **Share Session** com o ID da sessão e o ID da aplicação do parceiro de destino. A Didit retorna um `share_token` válido por tempo limitado.

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

O parceiro A envia o `share_token` ao parceiro B pelo seu próprio canal seguro (chamada de API, webhook etc.).

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

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

## Requisitos

| Requisito | Detalhes |
| - | - |
| **Status da sessão** | Somente sessões finalizadas (`"Approved"`, `"Declined"`, `"In Review"`) podem ser compartilhadas |
| **ID da aplicação do parceiro** | O ID da aplicação do parceiro de destino (encontrado nas configurações do Business Console) |
| **TTL do token** | Configurável de 60 segundos a 86.400 segundos (24 horas). Padrão: 3.600 segundos (1 hora) |
| **Autenticação** | Os dois parceiros devem se autenticar com as próprias chaves de API |

## Casos de uso

* **Banco → Fintech**: um usuário verificado por um banco pode acessar uma fintech parceira sem precisar se verificar novamente
* **Marketplace → Provedor de pagamentos**: vendedores verificados em um marketplace podem fazer o onboarding no provedor de pagamentos instantaneamente
* **Seguros → Saúde**: compartilhamento de verificações entre parceiros confiáveis de diferentes setores
* **Empresas do mesmo grupo**: compartilhe dados de verificação entre várias aplicações dentro da mesma organização

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


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