Endpoint: POST /unified/accounts/sellers/{sellers_pk}/documents/upload/
Autenticação: JWT obrigatório ou Chave de API aceita
Envia uma única imagem de KYC (selfie ou documento de identidade) para um seller. O arquivo é armazenado de forma segura, um registro de documento é criado com status='pending' e a entrega para a infraestrutura de processamento é agendada de forma assíncrona. Consulte o fluxo de Onboarding de sellers para entender como os documentos se encaixam no processo completo. Apenas formatos de imagem são aceitos. O arquivo é validado tanto pelo MIME type quanto pela extensão; ao menos um deles precisa coincidir.
  • MIME types aceitos: image/png, image/jpeg, image/webp, image/bmp, image/heic, image/heif.
  • Extensões aceitas: png, jpg, jpeg, webp, bmp, heic, heif.

​
Parâmetros de path

​
sellers_pk
string (uuid)
required
Identificador da conta unificada à qual o documento pertence.

​
Corpo — multipart/form-data

​
file
file
required
Arquivo de imagem a ser enviado. Transmitido como parte multipart file.
​
document_type
string
required
Um dos valores SELFIE, CNH_FULL, CNH_FRONT, CNH_BACK, RG_FRONT, RG_BACK.

​
Resposta

201 Created. Retorna o documento criado (mesma estrutura de um item retornado por GET …/documents/). 
{
  "id": "6c5a1b2d-2222-4f3e-9c11-c2c0a1b3e711",
  "name": "selfie.jpg",
  "status": "pending",
  "extension": "jpg",
  "mime_type": "image/jpeg",
  "category": "SELFIE",
  "document_type": "SELFIE",
  "download_link": "https://storage.dlpay.cloud/.../selfie.jpg",
  "created_at": "2025-05-14T11:00:00.000000Z",
  "updated_at": "2025-05-14T11:00:00.000000Z",
  "zoop_id": null,
  "zoop_acquirer_status": "UNDEFINED",
  "zoop_last_updated": null
}

​
Erros

StatusQuando
400Parte file ausente; document_type ausente ou fora da lista permitida; formato de arquivo não aceito.
401Token ausente ou inválido.
404sellers_pk não existe.

​
Exemplos

curl -X POST https://api.dlpay.cloud/unified/accounts/sellers/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/documents/upload/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -F "file=@./selfie.jpg" \
  -F "document_type=SELFIE"