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

sellers_pk
string (uuid)
required
Identificador da conta unificada.

Resposta

Retorna um array de documentos.
id
string (uuid)
name
string
Nome original do arquivo enviado.
status
string
Estado do ciclo de vida. Definido como pending no envio; atualizado pelo processo de sincronização após a entrega e revisão.
extension
string | null
Extensão do arquivo em minúsculas, ex.: png, jpg, heic.
mime_type
string | null
Content-Type original, ex.: image/png.
category
string | null
Igual ao document_type no momento do envio.
document_type
string
Um dos valores SELFIE, CNH_FULL, CNH_FRONT, CNH_BACK, RG_FRONT, RG_BACK.
URL onde o arquivo pode ser recuperado (normalmente uma URL assinada de storage).
created_at
string
updated_at
string
zoop_id
string | null
Identificador histórico na infraestrutura de processamento, preenchido após a sincronização.
zoop_acquirer_status
string
Estado reportado pela infraestrutura de processamento.
zoop_last_updated
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

StatusQuando
401Token ausente ou inválido.
404sellers_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"