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

seller_id
string
required
UUID unificado da conta.
id
string
required
UUID da transacao.

Resposta

id
string
zoop_id
string
Identificador historico da transacao na infraestrutura de processamento.
status
string
amount
string
Valor decimal em reais.
fees
string
Taxas de adquirencia. Inclui o acrescimo de splits ocultos para nao-superusuarios.
final_amount
string
payment_type
string
payment_method
object
installment_plan
object
point_of_sale
object
payment_authorization
object
error
object
history
array
split_rules
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.
customer
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

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

Exemplos

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