Buscar depósito

Endpoint: GET /unified/accounts/sellers/{sellers_pk}/deposits/{id}/

Autenticação: token JWT obrigatório. Superusuários ignoram a verificação de acesso. Usuários comuns precisam de um registro de acesso à account do depósito.

Retorna um único depósito. Comparado à listagem, o detalhe adiciona o objeto destination — a conta bancária para a qual o depósito foi enviado. Para enumerar as transações de origem, use Listar transações de um depósito. Para totais agregados por conta recebedora, use Resumo de um depósito.

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

string (uuid)

object

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

object | null

Conta bancária de destino. Campos: id, taxpayer_id, number, agency, code (código do banco), type (ex.: checking), created_at, updated_at. Apenas o primeiro destino é retornado.

string

Valor do depósito em BRL (string).

string

succeeded, pending, failed, canceled, deleted, reversed.

string | null

boolean | null

string | null

Data em que o dinheiro foi efetivamente movimentado.

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" },
  "destination": {
    "id": "f1aa11b2-2c10-4b11-8eea-22c8f7d911aa",
    "taxpayer_id": "12345678000199",
    "number": "00012345-6",
    "agency": "0001",
    "code": "001",
    "type": "checking",
    "created_at": "2025-06-09T03:30:00.000000Z",
    "updated_at": "2025-06-09T03:30:00.000000Z"
  },
  "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 à conta do depósito.
`404`	Depósito não encontrado (ou oculto pelo filtro de acesso).

Exemplos

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

import requests

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

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

Resposta

Erros

Exemplos

​Parâmetros de caminho

​Resposta

​Erros

​Exemplos

Parâmetros de caminho

Resposta

Erros

Exemplos