Resumo de um depósito

Endpoint: GET /unified/accounts/sellers/{sellers_pk}/deposits/{deposits_pk}/summary/

Autenticação: token JWT obrigatório. Superusuários ignoram a verificação de acesso. Usuários comuns só visualizam linhas cuja account esteja em seu conjunto de contas relacionadas.

Retorna uma linha agregada por conta recebedora que participou do depósito, com o valor total e a quantidade de transações atribuídas àquela conta. É assim que o depósito é decomposto quando várias subcontas ou destinatários de split compartilham o mesmo repasse diário. Mesmo que o nome sugira algo singular, a resposta é um array — um elemento por conta recebedora envolvida. A ordenação é total_amount decrescente.

Parâmetros de caminho

string (uuid)

required

Identificador da conta unificada — usado para delimitar o filtro de acesso.

string (uuid)

required

Identificador do depósito.

Resposta

Retorna um array de resumos por conta recebedora.

string (uuid)

object

Projeção {id, display_name, type} da conta recebedora.

string

Valor total, em BRL, atribuído a esta conta dentro do depósito (em formato string com . como separador decimal).

integer

Quantidade de linhas de transação que contribuíram para total_amount desta conta.

string

[
  {
    "id": "9b1f0d2a-1111-2222-3333-444444444444",
    "account": { "id": "9b1f0d2a-...", "display_name": "ACME Comércio LTDA", "type": "SELLER_PJ" },
    "total_amount": "1450.30",
    "transaction_count": 17,
    "created_at": "2025-06-09T03:30:00.000000Z",
    "updated_at": "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`	Depósito ou vendedor não encontrado.

Exemplos

curl https://api.dlpay.cloud/unified/accounts/sellers/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/deposits/2d1cb8a3-7e90-4d2b-8e91-9a8b71f9d2a1/summary/ \
  -H "Authorization: Bearer $ACCESS_TOKEN"

import requests

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

const response = await fetch(
  `https://api.dlpay.cloud/unified/accounts/sellers/${sellerId}/deposits/${depositId}/summary/`,
  { headers: { Authorization: `Bearer ${accessToken}` } },
);
const summary = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Resumo de um depósito

Parâmetros de caminho

Resposta

Erros

Exemplos

​Parâmetros de caminho

​Resposta

​Erros

​Exemplos

Parâmetros de caminho

Resposta

Erros

Exemplos