Buscar transação

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

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

Retorna a projeção completa de uma transação unificada. A estrutura é idêntica a um item retornado por GET …/transactions/. Este recurso também expõe algumas ações de escrita para transações; elas não fazem parte da API de leitura, mas vale conhecê-las:

POST /unified/accounts/sellers/{sellers_pk}/transactions/{id}/void/ — estorna a transação e retorna o registro unificado atualizado.
POST /unified/accounts/sellers/{sellers_pk}/transactions/{id}/split/ — adiciona uma regra de split. Corpo: recipient (ID de conta unificada), amount (string), amount_type (fixed ou percentage).
DELETE /unified/accounts/sellers/{sellers_pk}/transactions/{id}/split/{split_pk}/ — remove uma regra de split.

Parâmetros de path

string (uuid)

required

Identificador da conta unificada — usado para escopo do filtro de acesso.

string (uuid)

required

Identificador da transação unificada.

Resposta

Veja listar transações para a lista completa de campos — a estrutura é idêntica.

{
  "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",
  "payment_type": "credit",
  "status": "succeeded",
  "card_brand": "VISA",
  "masked_number": "************4242",
  "installments": 1,
  "mdr": "250",
  "acquirer_fee": "120",
  "auto_split_status": "CREATED",
  "auto_split_error": null,
  "auto_split_retries": 0,
  "full_statement_descriptor": "ACME 001",
  "entry_mode": "chip",
  "pos_identification": "POS-001",
  "holder_name": "JOAO SILVA",
  "reference_id": "order-1234",
  "confirmed": "1",
  "created_at": "2025-05-10T13:19:50.000000Z",
  "updated_at": "2025-05-10T13:20:30.000000Z",
  "zoop_id": "tx_a1b2c3",
  "zoop_acquirer_status": "SUCCEEDED",
  "zoop_internal_status": "SUCCEEDED",
  "zoop_last_updated": "2025-05-10T13:20:30.000000Z"
}

Erros

Status	Quando
`401`	Token ausente ou inválido.
`403`	Solicitante não tem acesso a `sellers_pk` ou à conta da transação.
`404`	Transação não encontrada (ou oculta pelo filtro de acesso).

Exemplos

curl https://api.dlpay.cloud/unified/accounts/sellers/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/transactions/ab93c1c8-3c4a-4e0e-9d2a-7e6c11d2b3c4/ \
  -H "Authorization: Bearer $ACCESS_TOKEN"

import requests

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

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

Resposta

Erros

Exemplos

​Parâmetros de path

​Resposta

​Erros

​Exemplos

Parâmetros de path

Resposta

Erros

Exemplos