Skip to main content
GET
Listar vendas rápidas
GET /checkout/charges Faz parte do recurso Vendas rápidas — a relação com Link e Session está lá. Devolve só as Sessions sem linkId, da mais recente para a mais antiga, em páginas de 20 por padrão (máximo 100). Os filtros são opcionais e se somam: quem envia mais de um recebe só as cobranças que atendem a todos.
É a mesma coleção de GET /checkout/sessions, com o filtro já embutido. Lá aparecem as compras de Link e as avulsas juntas; aqui, só as avulsas. Se você precisa das duas, use a listagem de Sessions.
status aceita mais de um valor, separados por vírgula: ?status=paid,failed. Um valor fora da lista responde 400 com os aceitos.
As datas do período filtram a criação, não o pagamento, e vão em ISO 8601 com fuso (2026-08-01T00:00:00-03:00). Para saber quando a cobrança foi paga, o caminho é a transação ligada pelo transactionId.

Exemplo

Resposta 200

Authorizations

x-api-key
string
header
required

API key unificada (z2_{live|test}{sk|pk}...) — secret (sk) para integração backend, publishable (pk) para uso no frontend público

Query Parameters

page
integer
default:1

Página da listagem. Padrão: 1.

Required range: x >= 1
limit
integer
default:20

Itens por página. Padrão: 20. Máximo: 100.

Required range: 1 <= x <= 100
status
enum<string>[]

Situação da venda rápida. Aceita vários valores, separados por vírgula ou repetindo o parâmetro. Um valor inválido responde 400 com a lista dos aceitos.

Available options:
created,
opened,
filling,
paying,
partially_paid,
paid,
failed,
abandoned,
expired,
canceled
transactionId
string | null

Transação vinculada. Correspondência parcial: 4151 encontra txn_ebgsvfsb4151nmbgvj4sek6ol.

description
string | null

Descrição da venda rápida. Correspondência parcial, sem diferenciar maiúsculas.

startDate
string<date-time> | null

Vendas criadas a partir desta data, em ISO 8601 com fuso. Filtra a criação, não o pagamento.

endDate
string<date-time> | null

Vendas criadas até esta data, em ISO 8601 com fuso. Filtra a criação, não o pagamento.

Response

Lista paginada de vendas rápidas

data
object[]

Lista de registros retornados nesta página.

pagination
object

Metadados de paginação do resultado (página, limite e totais).