Listar documentos

Endpoint: GET /unified/accounts/sellers/{sellers_pk}/documents/

Autenticação: JWT obrigatório ou Chave de API aceita

Lista os documentos de KYC (selfie, RG, CNH, etc.) que foram enviados para o seller. Os arquivos ficam armazenados em storage seguro e são sincronizados de forma assíncrona com a infraestrutura de processamento. A ordenação é por created_at decrescente. Para enviar um novo documento, utilize POST …/documents/upload/. Para o contexto completo do onboarding, consulte Onboarding de sellers.

Parâmetros de path

string (uuid)

required

Identificador da conta unificada.

Resposta

Retorna um array de documentos.

string (uuid)

string

Nome original do arquivo enviado.

string

Estado do ciclo de vida. Definido como pending no envio; atualizado pelo processo de sincronização após a entrega e revisão.

string | null

Extensão do arquivo em minúsculas, ex.: png, jpg, heic.

string | null

Content-Type original, ex.: image/png.

string | null

Igual ao document_type no momento do envio.

string

Um dos valores SELFIE, CNH_FULL, CNH_FRONT, CNH_BACK, RG_FRONT, RG_BACK.

string

URL onde o arquivo pode ser recuperado (normalmente uma URL assinada de storage).

string

string | null

Identificador histórico na infraestrutura de processamento, preenchido após a sincronização.

string

Estado reportado pela infraestrutura de processamento.

string | null

Última atualização do registro na infraestrutura de processamento.

[
  {
    "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
`401`	Token ausente ou inválido.
`404`	`sellers_pk` não existe (ou o solicitante não tem acesso).

Exemplos

curl https://api.dlpay.cloud/unified/accounts/sellers/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/documents/ \
  -H "Authorization: Bearer $ACCESS_TOKEN"

import requests

response = requests.get(
    f"https://api.dlpay.cloud/unified/accounts/sellers/{seller_id}/documents/",
    headers={"Authorization": f"Bearer {access_token}"},
)
documents = response.json()

const response = await fetch(
  `https://api.dlpay.cloud/unified/accounts/sellers/${sellerId}/documents/`,
  { headers: { Authorization: `Bearer ${accessToken}` } },
);
const documents = 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

Resposta

Erros

Exemplos

​Parâmetros de path

​Resposta

​Erros

​Exemplos

Parâmetros de path

Resposta

Erros

Exemplos