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

# Abr 08, 2026 - Upload de documentos para Sellers

> Novos endpoints para upload e gerenciamento de documentos de identidade (KYC) para sellers

export const jean = {
  name: "Jean Castro",
  title: "Software Engineer",
  url: "https://github.com/jeanvcastro",
  image: "https://github.com/jeanvcastro.png"
};

<AuthorProfile author={jean} />

Agora é possível enviar documentos de identidade (KYC) para sellers diretamente pela API da Malga. O fluxo permite que o merchant faça upload dos arquivos antes ou depois de criar o seller, sem depender de painéis externos do provedor.

## Como funciona

O merchant faz upload dos documentos via API, recebe os IDs, e pode enviá-los de duas formas:

1. **Na criação do seller** - incluindo o campo `documentIds` no body do `POST /v1/sellers`
2. **Após a criação** - associando documentos a um seller existente via `POST /v1/sellers/{sellerId}/documents`

Os documentos ficam armazenados temporariamente por 7 dias. Após esse prazo, expiram automaticamente.

## Novos endpoints

* `POST /v1/sellers/documents` - Upload de documento (multipart)
* `GET /v1/sellers/documents` - Listar documentos
* `GET /v1/sellers/documents/{documentId}` - Consultar documento
* `DELETE /v1/sellers/documents/{documentId}` - Deletar documento
* `POST /v1/sellers/{sellerId}/documents` - Associar documentos a seller existente

## Tipos de documento aceitos

* `SELFIE` - Selfie do titular
* `CNH_FULL` - CNH completa (frente e verso)
* `CNH_FRONT` / `CNH_BACK` - CNH frente / verso separados
* `RG_FRONT` / `RG_BACK` - RG frente / verso

Para mais detalhes, consulte a [referência da API](/api-reference/sellers/upload-de-documento).

<Tip>
  Features:

  1. Upload de documentos de identidade para sellers via API
  2. Associação de documentos na criação do seller ou posteriormente
  3. Gerenciamento completo: upload, consulta, listagem e exclusão
  4. Suporte ao provedor Zoop
</Tip>