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

seller_id
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.
status
string
Um de refunded, partial_refunded, dispute, disputed, charged_back, dispute.succeeded.
created_at_gte
string
Data ISO.
created_at_lte
string
Data ISO.
Busca textual sobre statement_descriptor, reference_id, description, payment_type, transaction_number, status.
page
integer
page_size
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

StatusQuando
401Credenciais ausentes ou invalidas.
403Sem vinculo de acesso ao vendedor.

Exemplos

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