Buscar transacao

Endpoint: GET /sales/seller/{seller_id}/transactions/{id}/

Autenticação: Bearer JWT ou chave de API do vendedor (TokenAuth)

Retorna uma transacao completa, com payment_method, installment_plan, point_of_sale, payment_authorization, error, history, as regras de split filtradas por contexto, e o customer (comprador) embutidos. Regras de visibilidade dos splits:

Superusuarios veem todas as regras.
Demais chamadores veem apenas regras cujo recipient esteja em uma das contas relacionadas. Valores ocultos sao somados ao campo fees da resposta para que os totais permanecam coerentes.

Pre-requisitos

A transacao deve pertencer a um vendedor visivel ao chamador (ou o chamador deve ser superusuario).
O chamador precisa de vinculo de acesso para seller_id.

Parametros de caminho

string

required

UUID unificado da conta.

string

required

UUID da transacao.

Resposta

string

Identificador historico da transacao na infraestrutura de processamento.

string

Valor decimal em reais.

string

Taxas de adquirencia. Inclui o acrescimo de splits ocultos para nao-superusuarios.

string

object

array

Cada regra: is_gross_amount, receivable_gross_amount, amount, charge_recipient_processing_fee, charge_processing_fee, liable, percentage, recipient, receivable_amount, zoop_id, mais um resumo do seller (id, first_name, last_name, business_name, statement_descriptor) quando o destinatario corresponder a um vendedor da plataforma.

object | null

Dados do comprador: id, name, email, phone_number, country_code.

{
  "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",
  "payment_method": {
    "card_brand": "VISA",
    "first4_digits": "4111",
    "last4_digits": "1111",
    "holder_name": "MARIA SOUZA"
  },
  "installment_plan": {"number_installments": 3, "mode": "with_interest"},
  "split_rules": [
    {
      "recipient": "abc123zoopid",
      "amount": "10.00",
      "percentage": null,
      "liable": true,
      "seller": {"id": "...", "business_name": "Parceiro X"}
    }
  ],
  "customer": {
    "name": "Maria Souza",
    "email": "maria@example.com",
    "phone_number": "11999990000"
  }
}

Acao adicional: void

POST /sales/seller/{seller_id}/transactions/{id}/void/ cancela (anula) uma transacao na infraestrutura de processamento e re-sincroniza a linha. Corpo vazio. Retorna a transacao atualizada. Retorna 400 se a transacao ja estiver confirmed, canceled ou pending.

Erros

Status	Quando
`401`	Credenciais ausentes ou invalidas.
`403`	Sem vinculo de acesso a nenhuma conta relacionada.
`404`	Transacao nao encontrada/nao visivel.

Exemplos

curl "https://api.dlpay.cloud/sales/seller/$SELLER_ID/transactions/$TX_ID/" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

import requests

response = requests.get(
    f"https://api.dlpay.cloud/sales/seller/{seller_id}/transactions/{tx_id}/",
    headers={"Authorization": f"Bearer {access_token}"},
)
tx = response.json()

const response = await fetch(
  `https://api.dlpay.cloud/sales/seller/${sellerId}/transactions/${txId}/`,
  { headers: { Authorization: `Bearer ${accessToken}` } },
);
const tx = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Pre-requisitos

Parametros de caminho

Resposta

Acao adicional: void

Erros

Exemplos

​Pre-requisitos

​Parametros de caminho

​Resposta

​Acao adicional: void

​Erros

​Exemplos

Pre-requisitos

Parametros de caminho

Resposta

Acao adicional: void

Erros

Exemplos