Endpoint: GET /sales/seller/{seller_id}/transactions/
Autenticação: Bearer JWT ou chave de API do vendedor (TokenAuth)
Retorna as transacoes visiveis ao chamador. Para nao-superusuarios, o conjunto e restrito ao vendedor e todos os vendedores relacionados. Superusuarios veem toda a tabela de transacoes. Ordenado por created_at DESC e paginado (tamanho padrao 10, maximo 100). A listagem usa uma representacao enxuta (linha completa da transacao sem objetos aninhados); a visualizacao por linha utiliza a representacao detalhada — veja Buscar transacao.

​
Pre-requisitos

  • O vendedor deve existir.
  • O chamador deve ser superusuario ou ter vinculo de acesso a seller_id (ou a qualquer conta relacionada).

​
Parametros de caminho

​
seller_id
string
required
UUID unificado da conta.

​
Parametros de consulta — filtros

​
sell
string
Filtra por UUID do pagamento do checkout (FK sell em Transaction). Util para listar transacoes de um unico pagamento de checkout.
​
seller
string
Filtra por UUID do vendedor (Transaction.seller).
​
status
string
Filtra por status: succeeded, failed, pending, pre_authorized, canceled, reversed, refunded, partial_refunded, dispute, charged_back.
​
payment_type
string
credit, debit, pix, boleto.
​
gateway_authorizer
string
Busca textual (case-insensitive) sobre gateway_authorizer.
​
statement_descriptor
string
Busca textual (case-insensitive) sobre statement_descriptor.
​
created_at_gte
string
Limite inferior inclusivo, data ISO (YYYY-MM-DD). Comparacao por created_at__date.
​
created_at_lte
string
Limite superior inclusivo, data ISO (YYYY-MM-DD). Comparacao por created_at__date.

​
Parametros de consulta — busca e paginacao

​
search
string
Busca textual sobre statement_descriptor, reference_id, description, payment_type, transaction_number, status.
​
page
integer
​
page_size
integer
Limitado a 100.

​
Resposta

Envelope padrao paginado. Os itens em results[] sao linhas de transacao (veja Buscar transacao por ID legado para o corpo enriquecido equivalente). 
{
  "count": 124,
  "next": "https://api.dlpay.cloud/sales/seller/.../transactions/?page=2",
  "previous": null,
  "results": [
    {
      "id": "9a1d2b8a-ee44-4f9a-9c1f-0a3a4b9c2d11",
      "zoop_id": "8b6f3e4cd2334e09a5f1a2b3c4d5e6f7",
      "status": "succeeded",
      "amount": "499.00",
      "fees": "12.45",
      "final_amount": "486.55",
      "payment_type": "credit",
      "reference_id": "curso-maio-2026",
      "created_at": "2026-05-14T13:02:11Z"
    }
  ]
}

​
Acoes adicionais de detalhe

Duas rotas extras estao disponiveis neste endpoint:
  • GET /sales/seller/{seller_id}/transactions/report/ — exporta a mesma listagem filtrada em csv, xlsx ou txt (formato escolhido via cabecalho Accept ou ?format=). Cabecalhos das colunas em portugues: Data/Hora, EC, Metodo, SN, Tipo, Bandeira, Cartao, Portador, Parcelas, Valor bruto, MDR, Valor liquido, Status, Ref..
  • POST /sales/seller/{seller_id}/transactions/refresh_tx/ — corpo { "zoop_id": "..." }. Aciona uma sincronizacao imediata de uma transacao com a infraestrutura de processamento e retorna a linha atualizada. Retorna 400 se zoop_id estiver ausente e 404 se a sincronizacao falhar.

​
Erros

StatusQuando
401Credenciais ausentes ou invalidas.
403Sem vinculo de acesso a nenhuma conta relacionada.

​
Exemplos

curl "https://api.dlpay.cloud/sales/seller/$SELLER_ID/transactions/?status=succeeded&created_at_gte=2026-05-01" \
  -H "Authorization: Bearer $ACCESS_TOKEN"