API v1
Cobranças

Listar produtos

GET/v1/productscharges:readNOVO

Produtos ativos do seu catálogo, mais novos primeiro. O catálogo é mantido no painel; cobre um produto enviando product_id em POST /v1/charges.

Cabeçalhos

Authorizationstringobrigatório

Bearer seguido da sua chave: gw_test_ em teste, gw_live_ em produção.

Parâmetros de consulta

limitinteger · 1–100opcional
cursorstring · 1–512opcional

Cursor opaco devolvido pela página anterior.

Resposta 200

Página, mais novos primeiro

dataobject[]
11 campos
iduuid
namestring
descriptionstring
price_centsinteger · mín. 1

Valor inteiro positivo em centavos.

kind

ONE_TIME é cobrado uma vez; SUBSCRIPTION é plano de assinatura.

ONE_TIMESUBSCRIPTION
frequency

Periodicidade do plano; null em ONE_TIME.

WEEKLYMONTHLYQUARTERLYSEMIANNUALLYANNUALLY
skustring | null

Seu código do produto, único na conta.

activeboolean
archived_atdatetime | null
created_atdatetime
updated_atdatetime
next_cursorstring | null

Códigos de resposta

HTTPQuando acontece
200Página, mais novos primeiro
400Requisição ou cursor inválido
401Chave ausente, inválida ou sem o escopo exigido
429Limite de requisições excedido

Cada código de erro está explicado em Erros.