Listar estornos

Endpoint: GET /sales/seller/{seller_id}/chargebacks/

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

Visao sobre a mesma tabela de transacoes, restrita aos status que representam um movimento de retorno de dinheiro contra o vendedor. O conjunto de status considerados como estorno:

status in (
    'refunded', 'partial_refunded', 'dispute', 'disputed',
    'charged_back', 'dispute.succeeded'
)

Estornos nao sao criados por clientes — eles chegam via webhooks da infraestrutura de processamento (eventos de disputa/reembolso) e os jobs de sincronizacao alteram o status da transacao subjacente. Este endpoint e apenas para leitura. Ordenado por created_at DESC e paginado. Para nao-superusuarios o conjunto e filtrado por Transaction.seller=seller_id (correspondencia direta — note que isso e mais restrito do que Listar transacoes, que usa contas relacionadas).

Pre-requisitos

O vendedor deve existir.
O chamador deve ser superusuario ou ter vinculo de acesso para seller_id.

Parametros de caminho

string

required

UUID unificado da conta.

Parametros de consulta

Mesmos filtros de Listar transacoes, todos opcionais. O filtro status e adicionalmente restringido ao conjunto de estornos.

string

Um de refunded, partial_refunded, dispute, disputed, charged_back, dispute.succeeded.

string

Data ISO.

string

Data ISO.

string

Busca textual sobre statement_descriptor, reference_id, description, payment_type, transaction_number, status.

integer

Resposta

Mesma estrutura de Listar transacoes.

{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "9a1d2b8a-ee44-4f9a-9c1f-0a3a4b9c2d11",
      "zoop_id": "8b6f3e4cd2334e09a5f1a2b3c4d5e6f7",
      "status": "charged_back",
      "amount": "499.00",
      "fees": "12.45",
      "final_amount": "486.55",
      "payment_type": "credit",
      "created_at": "2026-05-14T13:02:11Z"
    }
  ]
}

Erros

Status	Quando
`401`	Credenciais ausentes ou invalidas.
`403`	Sem vinculo de acesso ao vendedor.

Exemplos

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

import requests

response = requests.get(
    f"https://api.dlpay.cloud/sales/seller/{seller_id}/chargebacks/",
    headers={"Authorization": f"Bearer {access_token}"},
    params={"created_at_gte": "2026-01-01"},
)
data = response.json()

const response = await fetch(
  `https://api.dlpay.cloud/sales/seller/${sellerId}/chargebacks/`,
  { headers: { Authorization: `Bearer ${accessToken}` } },
);
const data = 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

Parametros de consulta

Resposta

Erros

Exemplos

​Pre-requisitos

​Parametros de caminho

​Parametros de consulta

​Resposta

​Erros

​Exemplos

Pre-requisitos

Parametros de caminho

Parametros de consulta

Resposta

Erros

Exemplos