Listar transações

Endpoint: GET /unified/accounts/sellers/{sellers_pk}/transactions/

Autenticação: JWT obrigatório ou Chave de API aceita

A Transação unificada é o espelho independente de processador de uma venda. Ela é populada pelos processos de sincronização e atua como modelo de leitura para painéis e relatórios. Para criar ou pagar uma venda, utilize os endpoints de vendas e pagar venda. Para modificar uma transação unificada (estornar, adicionar/remover split), veja as ações abaixo. A ordenação é por created_at decrescente.

Parâmetros de path

string (uuid)

required

Identificador da conta unificada.

Parâmetros de query

string

Busca por substring (case-insensitive) em statement_descriptor, reference_id, description, payment_type, transaction_number, status.

string

Correspondência exata. Valores comuns: succeeded, pending, canceled, charged_back, failed, reversed.

string

Correspondência exata. Exemplos: credit, debit, pix, boleto.

string

Busca por substring (case-insensitive).

string

Busca por substring (case-insensitive).

string (uuid)

Filtra por acquirer_account (alias).

string

Limite inferior ISO 8601 em created_at.

string

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

Resposta

Retorna um array de transações com todos os campos do registro:

string (uuid)

object | null

Projeção {id, display_name, type}.

object | null

Projeção {id, display_name, type}.

string

Valor bruto em BRL (centavos como string).

string | null

Taxa do processador (string).

string | null

MDR total (string).

string

Um dos valores WAITING, PROCESSING, ALREADY_EXISTENT, ALREADY_PROCESSED, NOT_SUPPORTED, NO_SPLIT_PLAN, ERROR, CREATED.

string | null

Logs de processamento do auto-split.

integer

string | null

Modo de captura do cartão: chip, contactless_chip, magstripe, magstripe_fallback, manually_keyed, barcode.

string | null

integer | null

string | null

Armazenado como string. "1" indica uma transação confirmada como succeeded.

string

string | null

Identificador histórico na infraestrutura de processamento.

string

Estado reportado pela infraestrutura de processamento.

string

Estado interno reportado pela infraestrutura de processamento.

string | null

Última atualização do registro na infraestrutura de processamento.

[
  {
    "id": "ab93c1c8-3c4a-4e0e-9d2a-7e6c11d2b3c4",
    "acquirer_account": { "id": "9b1f0d2a-...", "display_name": "ACME Comércio LTDA", "type": "SELLER_PJ" },
    "receiver_account": { "id": "9b1f0d2a-...", "display_name": "ACME Comércio LTDA", "type": "SELLER_PJ" },
    "amount": "10000",
    "description": "Venda POS #1234",
    "statement_descriptor": "ACME",
    "payment_type": "credit",
    "status": "succeeded",
    "card_brand": "VISA",
    "masked_number": "************4242",
    "installments": 1,
    "mdr": "250",
    "acquirer_fee": "120",
    "auto_split_status": "CREATED",
    "created_at": "2025-05-10T13:19:50.000000Z",
    "zoop_id": "tx_a1b2c3"
  }
]

Erros

Status	Quando
`401`	Token ausente ou inválido.
`403`	Solicitante não tem acesso a `sellers_pk`.
`404`	`sellers_pk` não existe.

Exemplos

curl "https://api.dlpay.cloud/unified/accounts/sellers/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/transactions/?status=succeeded&payment_type=credit" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

import requests

response = requests.get(
    f"https://api.dlpay.cloud/unified/accounts/sellers/{seller_id}/transactions/",
    headers={"Authorization": f"Bearer {access_token}"},
    params={"status": "succeeded", "payment_type": "credit"},
)
transactions = response.json()

const url = new URL(
  `https://api.dlpay.cloud/unified/accounts/sellers/${sellerId}/transactions/`,
);
url.searchParams.set("status", "succeeded");
url.searchParams.set("payment_type", "credit");
const response = await fetch(url, {
  headers: { Authorization: `Bearer ${accessToken}` },
});
const transactions = 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 path

Parâmetros de query

Resposta

Erros

Exemplos

​Parâmetros de path

​Parâmetros de query

​Resposta

​Erros

​Exemplos

Parâmetros de path

Parâmetros de query

Resposta

Erros

Exemplos