Endpoint: GET /unified/accounts/sellers/{sellers_pk}/deposits/
Autenticação: token JWT obrigatório. Superusuários ignoram a verificação de acesso. Usuários comuns só visualizam depósitos cuja account esteja em seu conjunto de contas relacionadas.
Um depósito é o repasse bancário do dia que é transferido para a conta bancária do vendedor. Cada depósito agrupa uma ou mais transações cujos valores líquidos foram pagos em conjunto. Use este endpoint para conciliar extratos bancários com as vendas da plataforma. Depósitos com status == 'deleted' são excluídos da listagem. A ordenação é created_at decrescente.

Parâmetros de caminho

sellers_pk
string (uuid)
required
Identificador da conta unificada.

Parâmetros de query

account
string (uuid)
Filtra por uma conta específica (útil quando sellers_pk é um pai e você quer ver os depósitos de uma de suas subcontas).
created_at_gte
string
ISO-8601. Limite inferior para created_at.
created_at_lte
string
ISO-8601. Limite superior inclusivo (1 dia adicionado no servidor).

Resposta

Retorna um array de depósitos.
id
string (uuid)
account
object
Projeção {id, display_name, type} da conta que recebe o depósito.
type
string
Tipo do depósito (ex.: transfer, settlement) reportado pela infraestrutura de processamento.
amount
string
Valor do depósito em BRL (string).
status
string
Um dos valores succeeded, pending, failed, canceled, deleted, reversed.
description
string | null
transfer_number
string | null
Identificador no extrato bancário.
confirmed
boolean | null
Indica se o depósito foi conciliado com uma entrada bancária.
created_at
string | null
ISO-8601 do momento em que o registro foi criado.
updated_at
string | null
transfer_date
string | null
ISO-8601 — data efetiva do movimento financeiro.
zoop_id
string | null
Identificador histórico do recurso na infraestrutura de processamento.
zoop_acquirer_status
string
Estado reportado pela infraestrutura de processamento.
zoop_last_updated
string | null
Data da última sincronização com a infraestrutura de processamento.
[
  {
    "id": "2d1cb8a3-7e90-4d2b-8e91-9a8b71f9d2a1",
    "account": { "id": "9b1f0d2a-...", "display_name": "ACME Comércio LTDA", "type": "SELLER_PJ" },
    "type": "transfer",
    "amount": "1450.30",
    "status": "succeeded",
    "description": "Repasse 09/06/2025",
    "transfer_number": "TR-2025-06-09-001",
    "confirmed": true,
    "created_at": "2025-06-09T03:30:00.000000Z",
    "updated_at": "2025-06-09T03:30:10.000000Z",
    "transfer_date": "2025-06-09T00:00:00.000000Z",
    "zoop_id": "tr_abcd1234",
    "zoop_acquirer_status": "SUCCEEDED",
    "zoop_last_updated": "2025-06-09T03:30:10.000000Z"
  }
]

Erros

StatusQuando
401Token ausente ou inválido.
403O chamador não possui acesso a sellers_pk.
404sellers_pk inexistente.

Exemplos

curl "https://api.dlpay.cloud/unified/accounts/sellers/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/deposits/?created_at_gte=2025-06-01" \
  -H "Authorization: Bearer $ACCESS_TOKEN"