Enviar documento

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

string (uuid)

required

Identificador da conta unificada à qual o documento pertence.

Corpo — multipart/form-data

file

required

Arquivo de imagem a ser enviado. Transmitido como parte multipart file.

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

Status	Quando
`400`	Parte `file` ausente; `document_type` ausente ou fora da lista permitida; formato de arquivo não aceito.
`401`	Token ausente ou inválido.
`404`	`sellers_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"

import requests

with open("selfie.jpg", "rb") as f:
    response = requests.post(
        f"https://api.dlpay.cloud/unified/accounts/sellers/{seller_id}/documents/upload/",
        headers={"Authorization": f"Bearer {access_token}"},
        files={"file": ("selfie.jpg", f, "image/jpeg")},
        data={"document_type": "SELFIE"},
    )
document = response.json()

const form = new FormData();
form.append("file", fileInput.files[0]);
form.append("document_type", "SELFIE");

const response = await fetch(
  `https://api.dlpay.cloud/unified/accounts/sellers/${sellerId}/documents/upload/`,
  {
    method: "POST",
    headers: { Authorization: `Bearer ${accessToken}` },
    body: form,
  },
);
const document = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Parâmetros de path

Corpo — multipart/form-data

Resposta

Erros

Exemplos

​Parâmetros de path

​Corpo — multipart/form-data

​Resposta

​Erros

​Exemplos

Parâmetros de path

Corpo — multipart/form-data

Resposta

Erros

Exemplos