Chargeback API

Disputas

v2026-02-01OAS 3.1

Introdução

Fornecemos uma API para consulta e gestão de chargebacks, permitindo listar, filtrar e acompanhar eventos, além de executar ações dentro do fluxo de contestação.

Ao integrar a API, os eventos de chargeback passam a ficar disponíveis de forma estruturada, viabilizando automação da operação e integração com sistemas internos.

Hosts

Production: https://api.stone.com.br

Autenticação

A autenticação é feita via chave estática. O processo de obtenção da chave é idêntico ao de outros endpoints/APIs já expostas pelo Pagar.me.

  • Escopo necessário: Transacional.
  • Permissão: Somente leitura.

Nota: Não é necessária uma chave exclusiva para esta API. Chaves existentes com este escopo e permissão podem ser reutilizadas.

O envio da credencial segue o padrão definido na Documentação do Pagar.me.

Alguma dúvida na integração ou feedback?

Mande um email para chargeback.tech@stone.com.br.

API Base URL
  • Server 1:https://api.stone.com.br

    production

  • Server 2:https://sandbox.api.stone.com.br

    sandbox

Disputas

Operações relacionadas à busca de disputas de chargeback. Aqui é possível ver o estado atual da disputa, histórico de eventos daquela disputa, dentre outras informações relevantes.

Lista disputas de chargeback

Retorna uma lista paginada de disputas com base nos filtros fornecidos.

get

Query Parameters

createdAt__lteAny Of

Filtra valores menores ou iguais à data fornecida. A API aceita datetimes em RFC3339 com timezone (ex.: 2026-02-26T20:02:18Z) ou datas no formato YYYY-MM-DD.

Variant 1string(date-time)

Example:2026-02-26T20:02:18Z

createdAt__gteAny Of

Filtra valores maiores ou iguais à data fornecida. A API aceita datetimes em RFC3339 com timezone (ex.: 2026-02-26T20:02:18Z) ou datas no formato YYYY-MM-DD.

Variant 1string(date-time)

Example:2026-02-26T20:02:18Z

statusstring

Filtra pelo status da disputa.

reason.codeinteger

Filtra pelo código do motivo do chargeback.

networkstring

Filtra pela bandeira do cartão.

cyclearray[string]

Filtra pelo ciclo de chargeback em que a disputa está. Aceita múltiplos valores.

Allowed values:FIRSTSECOND

Example:FIRST

cycleStatusarray[string]

Filtra pelo status da disputa dentro do ciclo atual. Aceita múltiplos valores.

Allowed values:RECEIVEDGUARANTEE_ANALYZEDEVIDENCE_RECEIVEDREPRESENTEDREVERSEDWONLOSTEXPIRED

Example:RECEIVED

forwardCursorstring

Identificador para avançar na paginação.

limitinteger

Número máximo de registros a serem retornados.

Default:5

<= 100

Response

application/json

Lista de disputas retornada com sucesso.

dataarray[object]
Show Child Parameters
pageobject
Show Child Parameters
get/v1/disputes
 
application/json