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

​
sellers_pk
string (uuid)
required
Identificador da conta unificada.

​
Parâmetros de query

​
search
string
Busca por substring (case-insensitive) em statement_descriptor, reference_id, description, payment_type, transaction_number, status.
​
status
string
Correspondência exata. Valores comuns: succeeded, pending, canceled, charged_back, failed, reversed.
​
payment_type
string
Correspondência exata. Exemplos: credit, debit, pix, boleto.
​
gateway_authorizer
string
Busca por substring (case-insensitive).
​
statement_descriptor
string
Busca por substring (case-insensitive).
​
seller
string (uuid)
Filtra por acquirer_account (alias).
​
created_at_gte
string
Limite inferior ISO 8601 em created_at.
​
created_at_lte
string
Limite superior inclusivo ISO 8601 (1 dia somado no servidor).

​
Resposta

Retorna um array de transações com todos os campos do registro:
​
id
string (uuid)
​
acquirer_account
object | null
Projeção {id, display_name, type}.
​
receiver_account
object | null
Projeção {id, display_name, type}.
​
amount
string
Valor bruto em BRL (centavos como string).
​
description
string | null
​
statement_descriptor
string | null
​
payment_type
string | null
​
gateway_authorizer
string | null
​
status
string | null
​
reference_id
string | null
​
acquirer_fee
string | null
Taxa do processador (string).
​
mdr
string | null
MDR total (string).
​
auto_split_status
string
Um dos valores WAITING, PROCESSING, ALREADY_EXISTENT, ALREADY_PROCESSED, NOT_SUPPORTED, NO_SPLIT_PLAN, ERROR, CREATED.
​
auto_split_error
string | null
Logs de processamento do auto-split.
​
auto_split_retries
integer
​
full_statement_descriptor
string | null
​
entry_mode
string | null
Modo de captura do cartão: chip, contactless_chip, magstripe, magstripe_fallback, manually_keyed, barcode.
​
pos_identification
string | null
​
card_brand
string | null
​
masked_number
string | null
​
holder_name
string | null
​
installments
integer | null
​
confirmed
string | null
Armazenado como string. "1" indica uma transação confirmada como succeeded.
​
created_at
string
​
updated_at
string
​
zoop_id
string | null
Identificador histórico na infraestrutura de processamento.
​
zoop_acquirer_status
string
Estado reportado pela infraestrutura de processamento.
​
zoop_internal_status
string
Estado interno reportado pela infraestrutura de processamento.
​
zoop_last_updated
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

StatusQuando
401Token ausente ou inválido.
403Solicitante não tem acesso a sellers_pk.
404sellers_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"