Vendas por data

Endpoint: GET /unified/accounts/sellers/{sellers_pk}/metrics/salesbydate/

Autenticação: JWT Bearer ou API Key. O usuário precisa ter acesso ao seller informado em sellers_pk.

Retorna uma lista de objetos { date, total } que agregam o clear_amount (em centavos de BRL) de todas as transações que atingiram o status succeeded em cada dia, considerando a conta do seller e todas as contas relacionadas (sub-sellers e contas redirecionadas). O resultado é agrupado por date, em ordem decrescente, e limitado aos 90 dias mais recentes. A tabela interna que alimenta esse endpoint é mantida em tempo real: cada transição de status que entra ou sai de succeeded ajusta a linha diária correspondente de forma atômica. Chargebacks que tiram a transação do status succeeded subtraem do dia correspondente.

Requisição

Parâmetros de caminho

string

required

UUID da conta unificada do seller (32 caracteres hexadecimais, sem traços).

Parâmetros de consulta

string (YYYY-MM-DD)

Limite inferior do intervalo de datas (inclusivo).

string (YYYY-MM-DD)

Limite superior do intervalo de datas (inclusivo).

A paginação está desativada — a resposta é um array JSON puro. Independente dos filtros, o servidor limita a resposta às 90 linhas mais recentes.

Resposta

Um array JSON de objetos, ordenado por date decrescente:

string (YYYY-MM-DD)

Dia do calendário correspondente ao agregado, interpretado no fuso America/Sao_Paulo.

integer

Soma de clear_amount para todas as transações succeeded no dia, considerando as contas relacionadas do seller. Centavos de BRL.

[
  { "date": "2025-05-14", "total": 1284500 },
  { "date": "2025-05-13", "total": 980012 },
  { "date": "2025-05-12", "total": 0 }
]

Erros

Status	Quando
`401`	Cabeçalho `Authorization` ausente ou inválido.
`403`	Autenticado, porém sem acesso ao seller informado em `sellers_pk`.
`404`	O UUID do seller não existe.

Exemplos

curl https://api.dlpay.cloud/unified/accounts/sellers/{sellers_pk}/metrics/salesbydate/?date_after=2025-04-01&date_before=2025-05-14 \
  -H "Authorization: Bearer $TOKEN"

import requests

response = requests.get(
    f"https://api.dlpay.cloud/unified/accounts/sellers/{sellers_pk}/metrics/salesbydate/",
    params={"date_after": "2025-04-01", "date_before": "2025-05-14"},
    headers={"Authorization": f"Bearer {token}"},
)
rows = response.json()

const response = await fetch(
  `https://api.dlpay.cloud/unified/accounts/sellers/${sellersPk}/metrics/salesbydate/?date_after=2025-04-01&date_before=2025-05-14`,
  { headers: { Authorization: `Bearer ${token}` } },
);
const rows = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Requisição

Parâmetros de caminho

Parâmetros de consulta

Resposta

Erros

Exemplos

​Requisição

​Parâmetros de caminho

​Parâmetros de consulta

​Resposta

​Erros

​Exemplos

Requisição

Parâmetros de caminho

Parâmetros de consulta

Resposta

Erros

Exemplos