Listar depósitos

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

string (uuid)

required

Identificador da conta unificada.

Parâmetros de query

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).

string

ISO-8601. Limite inferior para created_at.

string

ISO-8601. Limite superior inclusivo (1 dia adicionado no servidor).

Resposta

Retorna um array de depósitos.

string (uuid)

object

Projeção {id, display_name, type} da conta que recebe o depósito.

string

Tipo do depósito (ex.: transfer, settlement) reportado pela infraestrutura de processamento.

string

Valor do depósito em BRL (string).

string

Um dos valores succeeded, pending, failed, canceled, deleted, reversed.

string | null

Identificador no extrato bancário.

boolean | null

Indica se o depósito foi conciliado com uma entrada bancária.

string | null

ISO-8601 do momento em que o registro foi criado.

string | null

ISO-8601 — data efetiva do movimento financeiro.

string | null

Identificador histórico do recurso na infraestrutura de processamento.

string

Estado reportado pela infraestrutura de processamento.

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

Status	Quando
`401`	Token ausente ou inválido.
`403`	O chamador não possui acesso a `sellers_pk`.
`404`	`sellers_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"

import requests

response = requests.get(
    f"https://api.dlpay.cloud/unified/accounts/sellers/{seller_id}/deposits/",
    headers={"Authorization": f"Bearer {access_token}"},
    params={"created_at_gte": "2025-06-01"},
)
deposits = response.json()

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

Parâmetros de query

Resposta

Erros

Exemplos

​Parâmetros de caminho

​Parâmetros de query

​Resposta

​Erros

​Exemplos

Parâmetros de caminho

Parâmetros de query

Resposta

Erros

Exemplos