Histórico do contrato público em api.checkoutsentry.com/v1. Mudanças do painel da loja ficam no changelog dentro do app, não aqui.
v1.0.24 · Bloqueio por faixa de GMV
Quando a loja está blocked, /v1 responde 402 com error.code plan_upgrade_required. blocked_at vem em ISO-8601 completo, com plan e plans_url.
Durante upgrade_required a resposta de sucesso inclui o header de status do plano com upgrade_required e block_at. No aviso de Black Friday o header é bf_notice, sem data de pausa.
MCP e webhooks outbound pausam junto da /v1 quando a loja está blocked. A flag admin nasce ligada; desligar deixa só o painel e a /v1. Alertas por e-mail, GET /health, pixel e ingestão continuam.
v1.0.22 · Criticidade do subtipo por loja
criticidade em GET /checkouts, no detalhe e em GET /metrics/errors?group_by=subtype passa a ser o override da loja, ou o padrão da taxonomia quando não há override.
O filtro criticidade acompanha esse override. low na config da loja é Baixo explícito.
Sem subtipo, a criticidade de alerta e de has_critical_error continua na classificação macro da loja.
v1.0.21 · Subtipo de erro
GET /checkouts e GET /checkouts/{token} devolvem sub_error_type, criticidade (critico, medio, baixo) e rótulos pt/en.
A lista aceita error_type, sub_error_type e criticidade.
GET /metrics/errors aceita group_by=subtype (contagem de checkouts no snapshot, só tipos crítico/alerta da loja).
MCP: get_error_breakdown group_by=subtype; get_checkouts filtra e devolve subtipo e criticidade.
v1.0.20 · UTM nos checkouts
GET /checkouts e GET /checkouts/{token} devolvem utm_source, utm_medium, utm_campaign, utm_term e utm_content (nullable).
A lista aceita utm_source e utm_campaign (igualdade exata no valor last-seen do snapshot).
MCP: get_checkouts inclui os mesmos campos no detalhe; get_utm_breakdown agrega volume, valor e erros por fonte.
v1.0.19 · Status de serviço unknown
last_status e a série de health aceitam unknown quando a página de status do fornecedor não pôde ser lida.
unknown não é queda: o webhook alert.integration_status_change não dispara ao entrar nesse estado nem ao voltar para up.
v1.0.18 · Introduction: rate limit por plano
Introduction documenta rate limit por chave (RPM) com tabela Solo → Enterprise e média por segundo.
Limite aplicado continua sendo a janela de 60s; headers X-RateLimit-* e 429 RATE_LIMITED.
v1.0.17 · Introduction: paginação + diagrama
Introduction explica como paginar listas (next_cursor em checkouts; has_more/offset em alerts), com diagrama de uso.
v1.0.16 · Webhooks: payloads outbound + diagrama
Tag Webhooks deixa claro que documenta payloads POST enviados ao URL cadastrado em Desenvolvedores (não rotas da API de leitura).
Diagrama de sequência (SVG + Mermaid) no onboarding da seção.
v1.0.15 · Events removido
Removidos GET /events e GET /checkouts/{token}/events (tag Events e escopo events:read).
Use GET /checkouts e GET /checkouts/{token} para inteligência de checkout sem timeline de pixel.